commanderclaw 1.1.3

package/dist/plugin/skills/commanderclaw/SKILL.md

@@ -0,0 +1,177 @@
+---
+name: commanderclaw
+description: Connect to CommanderClaw coordination server for multi-agent task coordination
+metadata:
+  {
+    "openclaw":
+      {
+        "requires": { "config": ["plugins.entries.commanderclaw.config.serverUrl"] },
+      },
+  }
+---
+
+# CommanderClaw Integration
+
+This skill enables coordination with a CommanderClaw cluster for multi-agent task distribution and management.
+
+## Overview
+
+CommanderClaw is a multi-device Agent coordination framework. This skill allows OpenClaw to:
+
+- Register as a node in the CommanderClaw cluster
+- Receive and execute tasks assigned by the Commander
+- Create and manage tasks
+- Monitor cluster status
+
+## Available Tools
+
+### `commanderclaw_nodes`
+
+List all nodes in the cluster with their status, roles, and capabilities.
+
+**Example usage:**
+```
+What nodes are available in the cluster?
+```
+
+### `commanderclaw_task`
+
+Create, query, and manage tasks.
+
+**Actions:**
+
+| Action | Description |
+|--------|-------------|
+| `create` | Create a new task |
+| `list` | List all tasks |
+| `get` | Get details of a specific task |
+| `abort` | Abort a running task |
+| `pause` | Pause a running task |
+| `resume` | Resume a paused task |
+
+**Example usage:**
+```
+Create a new task called "Analyze data" with high priority
+List all tasks in the cluster
+Abort task abc123 with reason "no longer needed"
+```
+
+### `commanderclaw_status`
+
+Check connection status and cluster health.
+
+**Example usage:**
+```
+What's the status of the CommanderClaw connection?
+```
+
+### `commanderclaw_command`
+
+Send King commands to the cluster.
+
+**Commands:**
+
+| Command | Description |
+|---------|-------------|
+| `appoint` | Appoint a specific node as Commander |
+| `abort` | Abort a task |
+| `pause` | Pause a task |
+| `resume` | Resume a task |
+
+**Example usage:**
+```
+Appoint node xyz789 as the new Commander
+Pause task abc123
+```
+
+## Configuration
+
+Configure the plugin in `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "commanderclaw": {
+        "enabled": true,
+        "config": {
+          "serverUrl": "ws://your-server:8080/ws",
+          "token": "your-auth-token",
+          "deviceName": "OpenClaw Agent",
+          "autoConnect": true,
+          "reconnect": {
+            "enabled": true,
+            "maxAttempts": 10,
+            "delayMs": 5000
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Configuration Options
+
+| Option | Type | Required | Default | Description |
+|--------|------|----------|---------|-------------|
+| `serverUrl` | string | Yes | - | WebSocket URL of the CommanderClaw server |
+| `token` | string | No | - | Authentication token |
+| `deviceName` | string | No | "OpenClaw Agent" | Name to register with the cluster |
+| `autoConnect` | boolean | No | true | Auto-connect on gateway start |
+| `reconnect.enabled` | boolean | No | true | Enable automatic reconnection |
+| `reconnect.maxAttempts` | number | No | 10 | Max reconnection attempts |
+| `reconnect.delayMs` | number | No | 5000 | Delay between attempts (ms) |
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                         OpenClaw                             │
+│  ┌─────────────────────────────────────────────────────────┐│
+│  │              CommanderClaw Plugin                        ││
+│  │                                                          ││
+│  │  Tools:                                                  ││
+│  │  • commanderclaw_nodes                                   ││
+│  │  • commanderclaw_task                                    ││
+│  │  • commanderclaw_status                                  ││
+│  │  • commanderclaw_command                                 ││
+│  │                                                          ││
+│  │  Internal:                                               ││
+│  │  • WebSocket client                                      ││
+│  │  • Auto-reconnect                                        ││
+│  │  • Heartbeat management                                  ││
+│  └──────────────────────────────┬──────────────────────────┘│
+└──────────────────────────────────┼──────────────────────────┘
+                                   │
+                                   │ WebSocket
+                                   ▼
+┌─────────────────────────────────────────────────────────────┐
+│                  CommanderClaw Server                        │
+│                                                              │
+│  • Node registration                                         │
+│  • Commander election                                        │
+│  • Task distribution                                         │
+│  • King command handling                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Troubleshooting
+
+### Connection fails
+
+1. Check if the CommanderClaw server is running
+2. Verify the server URL is correct
+3. Check if the token is valid (if auth is enabled)
+
+### Tasks not being assigned
+
+1. Check if the node is connected: `commanderclaw_status`
+2. Verify capabilities match task requirements
+3. Check if there's an active Commander in the cluster
+
+### Reconnection issues
+
+1. Check server logs for errors
+2. Verify network connectivity
+3. Check `reconnect.maxAttempts` setting

package/dist/plugin/tools/command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * commanderclaw_command tool
+ */
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+export declare function createCommandTool(getClient: () => CommanderClawClient | null): ToolDefinition;
+//# sourceMappingURL=command.d.ts.map

package/dist/plugin/tools/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,mBAAmB,GAAG,IAAI,GAAG,cAAc,CA+H7F"}

package/dist/plugin/tools/command.ts

@@ -0,0 +1,136 @@
+/**
+ * commanderclaw_command tool
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+
+export function createCommandTool(getClient: () => CommanderClawClient | null): ToolDefinition {
+  return {
+    name: "commanderclaw_command",
+    description: `Send King commands to the CommanderClaw cluster.
+
+Commands:
+- appoint: Appoint a specific node as the Commander
+- abort: Abort a task (alias for commanderclaw_task with action=abort)
+- pause: Pause a running task
+- resume: Resume a paused task
+
+Note: Some commands may require King-level permissions.`,
+    parameters: Type.Object({
+      command: Type.Union([
+        Type.Literal("appoint"),
+        Type.Literal("abort"),
+        Type.Literal("pause"),
+        Type.Literal("resume"),
+      ]),
+      nodeId: Type.Optional(Type.String()),
+      taskId: Type.Optional(Type.String()),
+      reason: Type.Optional(Type.String()),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const client = getClient();
+      if (!client?.isConnected()) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Not connected to CommanderClaw server. Check plugin configuration.",
+            },
+          ],
+        };
+      }
+
+      try {
+        switch (params.command) {
+          case "appoint": {
+            if (!params.nodeId || typeof params.nodeId !== "string") {
+              return {
+                content: [
+                  {
+                    type: "text" as const,
+                    text: "Error: 'nodeId' is required for appoint command. Use commanderclaw_nodes to list available nodes.",
+                  },
+                ],
+              };
+            }
+            const result = await client.appointCommander(params.nodeId);
+            return {
+              content: [
+                {
+                  type: "text" as const,
+                  text: `Commander appointed successfully.\n- **New Commander:** ${result.commanderId}`,
+                },
+              ],
+            };
+          }
+
+          case "abort": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for abort command" },
+                ],
+              };
+            }
+            await client.abortTask(params.taskId, params.reason as string | undefined);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been aborted.` },
+              ],
+            };
+          }
+
+          case "pause": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for pause command" },
+                ],
+              };
+            }
+            await client.pauseTask(params.taskId);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been paused.` },
+              ],
+            };
+          }
+
+          case "resume": {
+            if (!params.taskId || typeof params.taskId !== "string") {
+              return {
+                content: [
+                  { type: "text" as const, text: "Error: 'taskId' is required for resume command" },
+                ],
+              };
+            }
+            await client.resumeTask(params.taskId);
+            return {
+              content: [
+                { type: "text" as const, text: `Task ${params.taskId} has been resumed.` },
+              ],
+            };
+          }
+
+          default:
+            return {
+              content: [
+                { type: "text" as const, text: `Unknown command: ${params.command}` },
+              ],
+            };
+        }
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to execute command: ${error instanceof Error ? error.message : String(error)}`,
+            },
+          ],
+        };
+      }
+    },
+  };
+}

package/dist/plugin/tools/nodes.d.ts

@@ -0,0 +1,7 @@
+/**
+ * commanderclaw_nodes tool
+ */
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+export declare function createNodesTool(getClient: () => CommanderClawClient | null): ToolDefinition;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/plugin/tools/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/nodes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,mBAAmB,GAAG,IAAI,GAAG,cAAc,CA8D3F"}

package/dist/plugin/tools/nodes.ts

@@ -0,0 +1,71 @@
+/**
+ * commanderclaw_nodes tool
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+
+export function createNodesTool(getClient: () => CommanderClawClient | null): ToolDefinition {
+  return {
+    name: "commanderclaw_nodes",
+    description:
+      "List all nodes connected to the CommanderClaw cluster. Use this to see available nodes, their status, roles, and capabilities.",
+    parameters: Type.Object({}),
+    async execute() {
+      const client = getClient();
+      if (!client?.isConnected()) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "Not connected to CommanderClaw server. Check plugin configuration.",
+            },
+          ],
+        };
+      }
+
+      try {
+        const nodes = await client.listNodes();
+        const currentNode = client.getNodeId();
+        const commanderId = client.getCommanderId();
+
+        let text = `## CommanderClaw Cluster Nodes\n\n`;
+        text += `**Total nodes:** ${nodes.length}\n`;
+        text += `**Commander:** ${commanderId || "None elected"}\n`;
+        text += `**Current node:** ${currentNode || "Unknown"}\n\n`;
+
+        if (nodes.length === 0) {
+          text += "No nodes connected to the cluster.\n";
+        } else {
+          for (const node of nodes) {
+            const isCommander = node.id === commanderId;
+            const isCurrent = node.id === currentNode;
+            const marker = isCurrent ? " (you)" : "";
+            const roleMarker = isCommander ? " 👑 Commander" : "";
+
+            text += `### ${node.name || node.id}${marker}${roleMarker}\n`;
+            text += `- **Status:** ${node.status}\n`;
+            text += `- **Role:** ${node.role}\n`;
+            text += `- **Load:** ${node.load}\n`;
+            if (node.capabilities?.length) {
+              text += `- **Capabilities:** ${node.capabilities.join(", ")}\n`;
+            }
+            text += "\n";
+          }
+        }
+
+        return { content: [{ type: "text" as const, text }] };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: `Failed to list nodes: ${error instanceof Error ? error.message : String(error)}`,
+            },
+          ],
+        };
+      }
+    },
+  };
+}

package/dist/plugin/tools/status.d.ts

@@ -0,0 +1,7 @@
+/**
+ * commanderclaw_status tool
+ */
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+export declare function createStatusTool(getClient: () => CommanderClawClient | null): ToolDefinition;
+//# sourceMappingURL=status.d.ts.map

package/dist/plugin/tools/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,mBAAmB,GAAG,IAAI,GAAG,cAAc,CAkD5F"}

package/dist/plugin/tools/status.ts

@@ -0,0 +1,59 @@
+/**
+ * commanderclaw_status tool
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+
+export function createStatusTool(getClient: () => CommanderClawClient | null): ToolDefinition {
+  return {
+    name: "commanderclaw_status",
+    description:
+      "Get the current status of the CommanderClaw cluster connection and cluster health. Use this to verify connectivity and check overall cluster status.",
+    parameters: Type.Object({}),
+    async execute() {
+      const client = getClient();
+
+      if (!client) {
+        return {
+          content: [
+            {
+              type: "text" as const,
+              text: "CommanderClaw plugin not initialized. Check plugin configuration.",
+            },
+          ],
+        };
+      }
+
+      const connected = client.isConnected();
+      const nodeId = client.getNodeId();
+      const commanderId = client.getCommanderId();
+      const peers = client.getPeers();
+
+      let text = `## CommanderClaw Status\n\n`;
+      text += `**Connection:** ${connected ? "✅ Connected" : "❌ Disconnected"}\n`;
+      text += `**Node ID:** ${nodeId || "Not registered"}\n`;
+      text += `**Commander:** ${commanderId || "None elected"}\n`;
+      text += `**Peers:** ${peers.length}\n\n`;
+
+      if (connected) {
+        try {
+          const health = await client.getStatus();
+          text += `### Cluster Health\n`;
+          text += `- **Status:** ${health.status}\n`;
+          text += `- **Total nodes:** ${health.nodes}\n`;
+        } catch (error) {
+          text += `**Health check failed:** ${error instanceof Error ? error.message : String(error)}\n`;
+        }
+      } else {
+        text += `### Troubleshooting\n`;
+        text += `- Check if the CommanderClaw server is running\n`;
+        text += `- Verify the server URL in plugin configuration\n`;
+        text += `- Check if the authentication token is correct\n`;
+      }
+
+      return { content: [{ type: "text" as const, text }] };
+    },
+  };
+}

package/dist/plugin/tools/task.d.ts

@@ -0,0 +1,7 @@
+/**
+ * commanderclaw_task tool
+ */
+import type { CommanderClawClient } from "../client";
+import type { ToolDefinition } from "../types";
+export declare function createTaskTool(getClient: () => CommanderClawClient | null): ToolDefinition;
+//# sourceMappingURL=task.d.ts.map

package/dist/plugin/tools/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,UAAU,CAAC;AAErD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,mBAAmB,GAAG,IAAI,GAAG,cAAc,CAuL1F"}