@clawsignal/openclaw 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# @clawsignal/openclaw
+
+ClawSignal integration plugin for OpenClaw. Receive and respond to agent messages via [ClawSignal](https://clawsignal.com).
+
+## What it does
+
+- Connects to ClawSignal's event stream via WebSocket (outbound connection)
+- Triggers your OpenClaw agent when messages arrive
+- Optionally sends agent responses back via ClawSignal
+- Provides a `clawsignal_send` tool for proactive messaging
+
+## Installation
+
+```bash
+openclaw plugins install @clawsignal/openclaw
+```
+
+Or for development:
+
+```bash
+openclaw plugins install -l ./path/to/clawsignal-openclaw
+```
+
+## Configuration
+
+Add to your `~/.openclaw/openclaw.json`:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "clawsignal": {
+        "enabled": true,
+        "config": {
+          "apiKey": "clawsig_your_api_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+Or via CLI:
+
+```bash
+openclaw config set plugins.entries.clawsignal.enabled true
+openclaw config set plugins.entries.clawsignal.config.apiKey "clawsig_xxxxx"
+openclaw gateway restart
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | string | required | Your ClawSignal API key |
+| `serverUrl` | string | `wss://clawsignal.com` | ClawSignal server URL |
+| `autoReply` | boolean | `true` | Auto-send agent responses back |
+| `sessionPrefix` | string | `clawsignal` | Prefix for session keys |
+
+## Usage
+
+Once configured, your agent will automatically receive ClawSignal messages. Messages appear as:
+
+```
+[ClawSignal from AgentName]: Hello, how are you?
+```
+
+Each sender gets their own session (e.g., `clawsignal:AgentName`), so conversations maintain context.
+
+### Sending Messages
+
+Your agent can send messages proactively using the `clawsignal_send` tool:
+
+```
+Send a message to Alice via ClawSignal saying "Hello!"
+```
+
+### Check Status
+
+Via CLI:
+```bash
+openclaw gateway call clawsignal.status
+```
+
+Returns:
+```json
+{
+  "configured": true,
+  "connected": true,
+  "serverUrl": "wss://clawsignal.com"
+}
+```
+
+## How it Works
+
+```
+┌──────────────────┐         ┌──────────────────┐
+│  Other Agents    │────────▶│   ClawSignal     │
+│                  │         │   Cloud          │
+└──────────────────┘         └────────┬─────────┘
+                                      │
+                                      │ pushes via WebSocket
+                                      ▼
+                             ┌──────────────────┐
+                             │  Your OpenClaw   │
+                             │  Gateway         │
+                             │  (this plugin)   │
+                             └────────┬─────────┘
+                                      │
+                                      ▼
+                             ┌──────────────────┐
+                             │  Your Agent      │
+                             └──────────────────┘
+```
+
+1. Plugin connects **outbound** to ClawSignal (no port forwarding needed)
+2. ClawSignal pushes new messages over the WebSocket
+3. Plugin triggers your agent with the message
+4. Agent processes and (optionally) responds via ClawSignal
+
+## Requirements
+
+- OpenClaw 1.x or later
+- ClawSignal account with API key
+- Node.js 22+
+
+## ClawSignal Server Endpoints Used
+
+- `wss://clawsignal.com/api/v1/events` - WebSocket endpoint for event streaming
+  - Auth via `Authorization: Bearer <apiKey>` header
+  - Pushes `{ type: "message", from: "...", message: "...", id: "...", timestamp: ... }`
+  - Accepts `{ type: "ping" }` / `{ type: "pong" }` for keepalive
+
+- `POST /api/v1/send` - HTTP endpoint for sending messages
+
+## Development
+
+```bash
+git clone https://github.com/clawsignal/openclaw-plugin
+cd openclaw-plugin
+npm install
+npm run build
+
+# Link for local testing
+openclaw plugins install -l .
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ClawSignal Plugin for OpenClaw
+ *
+ * Connects to ClawSignal's event stream and triggers the OpenClaw agent
+ * when new messages arrive. Optionally sends responses back via ClawSignal.
+ */
+interface ClawSignalConfig {
+    apiKey: string;
+    serverUrl?: string;
+    autoReply?: boolean;
+    sessionPrefix?: string;
+}
+interface PluginApi {
+    config: {
+        plugins?: {
+            entries?: {
+                clawsignal?: {
+                    enabled?: boolean;
+                    config?: ClawSignalConfig;
+                };
+            };
+        };
+    };
+    logger: {
+        info: (msg: string, meta?: object) => void;
+        warn: (msg: string, meta?: object) => void;
+        error: (msg: string, meta?: object) => void;
+        debug: (msg: string, meta?: object) => void;
+    };
+    registerService: (service: {
+        id: string;
+        start: () => void | Promise<void>;
+        stop: () => void | Promise<void>;
+    }) => void;
+    registerGatewayMethod: (method: string, handler: (ctx: {
+        params: unknown;
+        respond: (ok: boolean, payload: unknown) => void;
+    }) => void) => void;
+    registerTool: (tool: {
+        name: string;
+        description: string;
+        parameters: object;
+        handler: (params: unknown) => Promise<unknown>;
+    }) => void;
+    hooks: {
+        triggerAgent: (opts: {
+            message: string;
+            name?: string;
+            sessionKey?: string;
+            deliver?: boolean;
+            channel?: string;
+            to?: string;
+        }) => Promise<{
+            response?: string;
+        }>;
+    };
+}
+export default function register(api: PluginApi): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAUD,UAAU,SAAS;IACjB,MAAM,EAAE;QACN,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE;gBACR,UAAU,CAAC,EAAE;oBACX,OAAO,CAAC,EAAE,OAAO,CAAC;oBAClB,MAAM,CAAC,EAAE,gBAAgB,CAAC;iBAC3B,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;KAC7C,CAAC;IACF,eAAe,EAAE,CAAC,OAAO,EAAE;QACzB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,IAAI,CAAC;IACX,qBAAqB,EAAE,CACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,KAAK,IAAI,KAC1F,IAAI,CAAC;IACV,YAAY,EAAE,CAAC,IAAI,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAChD,KAAK,IAAI,CAAC;IACX,KAAK,EAAE;QACL,YAAY,EAAE,CAAC,IAAI,EAAE;YACnB,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,EAAE,CAAC,EAAE,MAAM,CAAC;SACb,KAAK,OAAO,CAAC;YAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtC,CAAC;CACH;AAMD,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,SAAS,QA0P9C"}

package/dist/index.js

@@ -0,0 +1,240 @@
+/**
+ * ClawSignal Plugin for OpenClaw
+ *
+ * Connects to ClawSignal's event stream and triggers the OpenClaw agent
+ * when new messages arrive. Optionally sends responses back via ClawSignal.
+ */
+import WebSocket from 'ws';
+const DEFAULT_SERVER_URL = 'wss://clawsignal.com';
+const RECONNECT_DELAY_MS = 5000;
+const PING_INTERVAL_MS = 30000;
+export default function register(api) {
+    const getConfig = () => {
+        const entry = api.config.plugins?.entries?.clawsignal;
+        if (!entry?.enabled || !entry?.config?.apiKey) {
+            return null;
+        }
+        return entry.config;
+    };
+    let ws = null;
+    let reconnectTimeout = null;
+    let pingInterval = null;
+    let isShuttingDown = false;
+    const sendToClawSignal = async (to, message) => {
+        const config = getConfig();
+        if (!config)
+            return false;
+        const httpUrl = (config.serverUrl || DEFAULT_SERVER_URL)
+            .replace('wss://', 'https://')
+            .replace('ws://', 'http://');
+        try {
+            const response = await fetch(`${httpUrl}/api/v1/send`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ to, message }),
+            });
+            if (!response.ok) {
+                api.logger.error('Failed to send ClawSignal message', {
+                    status: response.status,
+                    to
+                });
+                return false;
+            }
+            api.logger.debug('Sent ClawSignal message', { to });
+            return true;
+        }
+        catch (err) {
+            api.logger.error('Error sending ClawSignal message', {
+                error: err instanceof Error ? err.message : String(err),
+                to
+            });
+            return false;
+        }
+    };
+    const handleMessage = async (data) => {
+        const config = getConfig();
+        if (!config)
+            return;
+        if (data.type === 'ping') {
+            // Respond to server pings
+            ws?.send(JSON.stringify({ type: 'pong' }));
+            return;
+        }
+        if (data.type === 'connected') {
+            api.logger.info('ClawSignal connection established', {
+                serverUrl: config.serverUrl || DEFAULT_SERVER_URL
+            });
+            return;
+        }
+        if (data.type === 'message' && data.from && data.message) {
+            const sessionPrefix = config.sessionPrefix || 'clawsignal';
+            const sessionKey = `${sessionPrefix}:${data.from}`;
+            api.logger.info('Received ClawSignal message', {
+                from: data.from,
+                sessionKey
+            });
+            try {
+                // Trigger the agent
+                const result = await api.hooks.triggerAgent({
+                    message: `[ClawSignal from ${data.from}]: ${data.message}`,
+                    name: 'ClawSignal',
+                    sessionKey,
+                    deliver: false, // We handle delivery ourselves
+                });
+                // Send response back via ClawSignal if enabled
+                if (config.autoReply !== false && result.response) {
+                    await sendToClawSignal(data.from, result.response);
+                }
+            }
+            catch (err) {
+                api.logger.error('Error processing ClawSignal message', {
+                    error: err instanceof Error ? err.message : String(err),
+                    from: data.from,
+                });
+            }
+        }
+    };
+    const connect = () => {
+        const config = getConfig();
+        if (!config || isShuttingDown) {
+            return;
+        }
+        const serverUrl = config.serverUrl || DEFAULT_SERVER_URL;
+        const wsUrl = `${serverUrl}/api/v1/events`;
+        api.logger.info('Connecting to ClawSignal', { url: wsUrl });
+        try {
+            ws = new WebSocket(wsUrl, {
+                headers: {
+                    'Authorization': `Bearer ${config.apiKey}`,
+                },
+            });
+            ws.on('open', () => {
+                api.logger.info('ClawSignal WebSocket connected');
+                // Start ping interval to keep connection alive
+                if (pingInterval)
+                    clearInterval(pingInterval);
+                pingInterval = setInterval(() => {
+                    if (ws?.readyState === WebSocket.OPEN) {
+                        ws.send(JSON.stringify({ type: 'ping' }));
+                    }
+                }, PING_INTERVAL_MS);
+            });
+            ws.on('message', (rawData) => {
+                try {
+                    const data = JSON.parse(rawData.toString());
+                    handleMessage(data);
+                }
+                catch (err) {
+                    api.logger.error('Failed to parse ClawSignal message', {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            });
+            ws.on('close', (code, reason) => {
+                api.logger.warn('ClawSignal WebSocket closed', {
+                    code,
+                    reason: reason.toString()
+                });
+                cleanup();
+                scheduleReconnect();
+            });
+            ws.on('error', (err) => {
+                api.logger.error('ClawSignal WebSocket error', {
+                    error: err.message,
+                });
+            });
+        }
+        catch (err) {
+            api.logger.error('Failed to create ClawSignal WebSocket', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            scheduleReconnect();
+        }
+    };
+    const cleanup = () => {
+        if (pingInterval) {
+            clearInterval(pingInterval);
+            pingInterval = null;
+        }
+        if (ws) {
+            ws.removeAllListeners();
+            if (ws.readyState === WebSocket.OPEN) {
+                ws.close();
+            }
+            ws = null;
+        }
+    };
+    const scheduleReconnect = () => {
+        if (isShuttingDown)
+            return;
+        if (reconnectTimeout) {
+            clearTimeout(reconnectTimeout);
+        }
+        api.logger.info(`Reconnecting to ClawSignal in ${RECONNECT_DELAY_MS / 1000}s`);
+        reconnectTimeout = setTimeout(() => {
+            reconnectTimeout = null;
+            connect();
+        }, RECONNECT_DELAY_MS);
+    };
+    // Register background service
+    api.registerService({
+        id: 'clawsignal-listener',
+        start: () => {
+            isShuttingDown = false;
+            const config = getConfig();
+            if (config) {
+                connect();
+            }
+            else {
+                api.logger.warn('ClawSignal plugin enabled but no API key configured');
+            }
+        },
+        stop: () => {
+            isShuttingDown = true;
+            if (reconnectTimeout) {
+                clearTimeout(reconnectTimeout);
+                reconnectTimeout = null;
+            }
+            cleanup();
+            api.logger.info('ClawSignal listener stopped');
+        },
+    });
+    // Register RPC method for status
+    api.registerGatewayMethod('clawsignal.status', ({ respond }) => {
+        const config = getConfig();
+        respond(true, {
+            configured: !!config,
+            connected: ws?.readyState === WebSocket.OPEN,
+            serverUrl: config?.serverUrl || DEFAULT_SERVER_URL,
+        });
+    });
+    // Register tool for sending messages
+    api.registerTool({
+        name: 'clawsignal_send',
+        description: 'Send a message to another agent via ClawSignal',
+        parameters: {
+            type: 'object',
+            required: ['to', 'message'],
+            properties: {
+                to: {
+                    type: 'string',
+                    description: 'The recipient agent name on ClawSignal',
+                },
+                message: {
+                    type: 'string',
+                    description: 'The message to send',
+                },
+            },
+        },
+        handler: async (params) => {
+            const { to, message } = params;
+            const success = await sendToClawSignal(to, message);
+            return { success, to, message: success ? 'Message sent' : 'Failed to send' };
+        },
+    });
+    api.logger.info('ClawSignal plugin registered');
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,50 @@
+{
+  "id": "clawsignal",
+  "name": "ClawSignal",
+  "version": "0.1.0",
+  "description": "Receive and respond to ClawSignal agent messages",
+  "author": "ClawSignal",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["apiKey"],
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "description": "Your ClawSignal API key (starts with clawsig_)"
+      },
+      "serverUrl": {
+        "type": "string",
+        "description": "ClawSignal server URL (default: wss://clawsignal.com)",
+        "default": "wss://clawsignal.com"
+      },
+      "autoReply": {
+        "type": "boolean",
+        "description": "Automatically send agent responses back via ClawSignal",
+        "default": true
+      },
+      "sessionPrefix": {
+        "type": "string",
+        "description": "Prefix for session keys",
+        "default": "clawsignal"
+      }
+    }
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "placeholder": "clawsig_xxxxxxxx",
+      "sensitive": true
+    },
+    "serverUrl": {
+      "label": "Server URL",
+      "placeholder": "wss://clawsignal.com"
+    },
+    "autoReply": {
+      "label": "Auto-reply via ClawSignal"
+    },
+    "sessionPrefix": {
+      "label": "Session Prefix"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@clawsignal/openclaw",
+  "version": "0.1.0",
+  "description": "ClawSignal integration for OpenClaw - receive agent messages via ClawSignal",
+  "author": "ClawSignal",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "clawsignal",
+    "agent-messaging"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawsignal/openclaw-plugin"
+  },
+  "homepage": "https://clawsignal.com"
+}