@wishee-ai/openclaw-connector 1.0.0

package/dist/binding.js

@@ -0,0 +1,89 @@
+/**
+ * Manages the binding state (clawId + secret) for this OpenClaw instance.
+ * Stores binding info in ~/.openclaw/openclaw-connector/binding.json.
+ */
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+const BINDING_DIR = path.join(process.env.HOME || "/tmp", ".openclaw", "openclaw-connector");
+const BINDING_FILE = path.join(BINDING_DIR, "binding.json");
+const DEFAULT_BRIDGE_URL = "wss://ai-bridge.wishee.com.cn/ws";
+const BIND_PAGE_BASE = "https://openclaw.coraai.com.cn/bind";
+/**
+ * Load or create the binding state.
+ * Generates a new clawId + secret on first run.
+ */
+export function loadOrCreateBinding(bridgeUrl) {
+    try {
+        if (fs.existsSync(BINDING_FILE)) {
+            const data = JSON.parse(fs.readFileSync(BINDING_FILE, "utf8"));
+            if (data?.clawId && data?.secret) {
+                // Allow overriding bridgeUrl from config
+                if (bridgeUrl)
+                    data.bridgeUrl = bridgeUrl;
+                return data;
+            }
+        }
+    }
+    catch {
+        // regenerate
+    }
+    const state = {
+        clawId: crypto.randomUUID(),
+        secret: crypto.randomBytes(32).toString("hex"),
+        bridgeUrl: bridgeUrl || DEFAULT_BRIDGE_URL,
+        bound: false,
+    };
+    fs.mkdirSync(BINDING_DIR, { recursive: true });
+    fs.writeFileSync(BINDING_FILE, JSON.stringify(state, null, 2));
+    try {
+        fs.chmodSync(BINDING_FILE, 0o600);
+    }
+    catch {
+        // best-effort
+    }
+    return state;
+}
+/**
+ * Mark binding as completed in the local state file.
+ */
+export function markBound(state) {
+    state.bound = true;
+    fs.mkdirSync(BINDING_DIR, { recursive: true });
+    fs.writeFileSync(BINDING_FILE, JSON.stringify(state, null, 2));
+}
+/**
+ * Build the binding URL for QR code display.
+ */
+export function getBindUrl(state) {
+    const url = new URL(BIND_PAGE_BASE);
+    url.searchParams.set("clawId", state.clawId);
+    url.searchParams.set("secret", state.secret);
+    return url.toString();
+}
+/**
+ * Display QR code in terminal for binding.
+ */
+export async function showBindingQR(state, logger) {
+    const url = getBindUrl(state);
+    logger.info("=== OpenClaw Connector Binding ===");
+    logger.info("Scan the QR code below to bind this OpenClaw instance:");
+    logger.info("");
+    try {
+        // qrcode-terminal is a CJS module
+        const qrcode = await import("qrcode-terminal");
+        const generate = qrcode.default?.generate || qrcode.generate;
+        generate(url, { small: true }, (qr) => {
+            for (const line of qr.split("\n")) {
+                logger.info(line);
+            }
+        });
+    }
+    catch {
+        logger.info("[QR code display failed — install qrcode-terminal]");
+    }
+    logger.info("");
+    logger.info(`Or open this URL: ${url}`);
+    logger.info("=================================");
+}
+//# sourceMappingURL=binding.js.map

package/dist/binding.js.map

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

package/dist/connector.js

@@ -0,0 +1,252 @@
+/**
+ * Outbound WebSocket client that connects this OpenClaw instance to the Cora bridge.
+ *
+ * Lifecycle:
+ *   1. Load/create binding state (clawId + secret)
+ *   2. If not bound, show QR code for user to scan
+ *   3. Connect to bridge via WebSocket
+ *   4. Send hello handshake → wait for welcome
+ *   5. Subscribe to agent events + transcript updates → forward to bridge
+ *   6. Handle RPC requests from bridge → dispatch to subagent API
+ */
+import WebSocket from "ws";
+import { loadOrCreateBinding, markBound, showBindingQR } from "./binding.js";
+import { fetchTaskResult } from "./task-result.js";
+// ── State ──────────────────────────────────────────────────────
+let ws = null;
+let closed = false;
+let backoffMs = 1000;
+let tickTimer = null;
+let unsubAgentEvents = null;
+let unsubTranscript = null;
+let bindingState = null;
+let pluginApi = null;
+// ── Public API ─────────────────────────────────────────────────
+export async function startConnector(api, ctx) {
+    pluginApi = api;
+    closed = false;
+    const bridgeUrl = api.pluginConfig?.bridgeUrl || undefined;
+    bindingState = loadOrCreateBinding(bridgeUrl);
+    ctx.logger.info(`[connector] clawId=${bindingState.clawId}, bound=${bindingState.bound}`);
+    if (!bindingState.bound) {
+        await showBindingQR(bindingState, ctx.logger);
+    }
+    // Subscribe to agent events
+    unsubAgentEvents = api.runtime.events.onAgentEvent((evt) => {
+        sendEvent({
+            type: "event",
+            event: "agent",
+            payload: {
+                runId: evt.runId,
+                stream: evt.stream,
+                data: evt.data,
+                ts: evt.ts,
+                seq: evt.seq,
+                sessionKey: evt.sessionKey,
+            },
+        });
+        // On lifecycle end, fetch task result after a short delay
+        if (evt.stream === "lifecycle" && evt.data?.phase === "end") {
+            const sessionKey = evt.sessionKey;
+            if (sessionKey) {
+                setTimeout(() => {
+                    void fetchAndSendTaskResult(evt.runId, sessionKey, ctx.logger);
+                }, 500);
+            }
+        }
+    });
+    // Subscribe to transcript updates
+    unsubTranscript = api.runtime.events.onSessionTranscriptUpdate((evt) => {
+        sendEvent({
+            type: "event",
+            event: "transcript",
+            payload: {
+                sessionKey: evt.sessionKey,
+                message: evt.message,
+                messageId: evt.messageId,
+            },
+        });
+    });
+    // Start connection
+    connect(ctx.logger);
+}
+export function stopConnector() {
+    closed = true;
+    unsubAgentEvents?.();
+    unsubTranscript?.();
+    unsubAgentEvents = null;
+    unsubTranscript = null;
+    if (tickTimer) {
+        clearInterval(tickTimer);
+        tickTimer = null;
+    }
+    ws?.close();
+    ws = null;
+    pluginApi = null;
+}
+// ── Connection ─────────────────────────────────────────────────
+function connect(logger) {
+    if (closed || !bindingState)
+        return;
+    const url = bindingState.bridgeUrl;
+    logger.info(`[connector] Connecting to bridge: ${url}`);
+    const socket = new WebSocket(url);
+    ws = socket;
+    socket.on("open", () => {
+        logger.info("[connector] WebSocket connected, sending hello...");
+        backoffMs = 1000;
+        const hello = {
+            type: "hello",
+            clawId: bindingState.clawId,
+            secret: bindingState.secret,
+        };
+        socket.send(JSON.stringify(hello));
+    });
+    socket.on("message", (data) => {
+        const text = typeof data === "string" ? data : data.toString("utf-8");
+        handleMessage(text, logger);
+    });
+    socket.on("close", (code, reason) => {
+        const reasonText = typeof reason === "string" ? reason : reason.toString("utf-8");
+        logger.warn(`[connector] Connection closed: code=${code}, reason=${reasonText}`);
+        ws = null;
+        if (code === 4001) {
+            logger.info("[connector] Not bound yet. Waiting for user to scan QR code...");
+        }
+        else if (code === 4003) {
+            logger.error("[connector] Authentication failed. Secret mismatch.");
+        }
+        scheduleReconnect(logger);
+    });
+    socket.on("error", (err) => {
+        logger.error(`[connector] WebSocket error: ${err.message}`);
+    });
+}
+function scheduleReconnect(logger) {
+    if (closed)
+        return;
+    const delay = backoffMs;
+    backoffMs = Math.min(backoffMs * 2, 30_000);
+    logger.info(`[connector] Reconnecting in ${delay}ms...`);
+    setTimeout(() => connect(logger), delay);
+}
+// ── Message handling ───────────────────────────────────────────
+function handleMessage(raw, logger) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    // Welcome frame (handshake accepted)
+    if (parsed.type === "welcome") {
+        const welcome = parsed;
+        logger.info(`[connector] Handshake accepted, userId=${welcome.userId}`);
+        if (bindingState && !bindingState.bound) {
+            markBound(bindingState);
+            logger.info("[connector] Binding confirmed and saved locally.");
+        }
+        // Start heartbeat
+        startHeartbeat();
+        return;
+    }
+    // RPC request from bridge
+    if (parsed.type === "req" && typeof parsed.id === "string" && typeof parsed.method === "string") {
+        const req = parsed;
+        void handleRpcRequest(req, logger);
+        return;
+    }
+}
+// ── RPC dispatch ───────────────────────────────────────────────
+async function handleRpcRequest(req, logger) {
+    const { id, method, params } = req;
+    logger.info(`[connector] RPC request: method=${method}, id=${id}`);
+    try {
+        const subagent = pluginApi?.runtime.subagent;
+        if (!subagent) {
+            sendResponse(id, false, undefined, { message: "subagent not available" });
+            return;
+        }
+        let result;
+        switch (method) {
+            case "chat.send": {
+                const p = params;
+                result = await subagent.run({
+                    sessionKey: p.sessionKey,
+                    message: p.message,
+                    deliver: p.deliver,
+                    idempotencyKey: p.idempotencyKey,
+                });
+                break;
+            }
+            case "chat.history": {
+                const p = params;
+                result = await subagent.getSessionMessages({
+                    sessionKey: p.sessionKey,
+                    limit: p.limit,
+                });
+                break;
+            }
+            case "sessions.reset": {
+                const p = params;
+                await subagent.deleteSession({ sessionKey: p.sessionKey });
+                result = { ok: true };
+                break;
+            }
+            case "agent.wait": {
+                const p = params;
+                result = await subagent.waitForRun({
+                    runId: p.runId,
+                    timeoutMs: p.timeoutMs,
+                });
+                break;
+            }
+            default:
+                sendResponse(id, false, undefined, { message: `unknown method: ${method}` });
+                return;
+        }
+        sendResponse(id, true, result);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`[connector] RPC error: method=${method}, error=${message}`);
+        sendResponse(id, false, undefined, { message });
+    }
+}
+// ── Sending ────────────────────────────────────────────────────
+function sendResponse(id, ok, payload, error) {
+    const frame = { type: "res", id, ok };
+    if (payload !== undefined)
+        frame.payload = payload;
+    if (error)
+        frame.error = error;
+    sendRaw(frame);
+}
+function sendEvent(frame) {
+    sendRaw(frame);
+}
+function sendRaw(frame) {
+    if (ws?.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify(frame));
+    }
+}
+function startHeartbeat() {
+    if (tickTimer)
+        clearInterval(tickTimer);
+    tickTimer = setInterval(() => {
+        sendEvent({ type: "event", event: "tick" });
+    }, 25_000);
+}
+// ── Task result helper ─────────────────────────────────────────
+async function fetchAndSendTaskResult(runId, sessionKey, logger) {
+    const subagent = pluginApi?.runtime.subagent;
+    if (!subagent)
+        return;
+    const frame = await fetchTaskResult(subagent, runId, sessionKey, logger);
+    if (frame) {
+        sendEvent(frame);
+        logger.info(`[connector] Sent task-result for runId=${runId}`);
+    }
+}
+//# sourceMappingURL=connector.js.map

package/dist/connector.js.map

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

package/dist/index.js

@@ -0,0 +1,15 @@
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { startConnector, stopConnector } from "./connector.js";
+export default definePluginEntry({
+    id: "openclaw-connector",
+    name: "Cora OpenClaw Connector",
+    description: "Connects this OpenClaw instance to Cora bridge via reverse WebSocket",
+    register(api) {
+        api.registerService({
+            id: "openclaw-connector",
+            start: (ctx) => startConnector(api, ctx),
+            stop: () => stopConnector(),
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,eAAe,iBAAiB,CAAC;IAC/B,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EAAE,sEAAsE;IACnF,QAAQ,CAAC,GAAG;QACV,GAAG,CAAC,eAAe,CAAC;YAClB,EAAE,EAAE,oBAAoB;YACxB,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,GAAU,EAAE,GAAG,CAAC;YAC/C,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;SAC5B,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,5 @@
+/**
+ * Wire protocol frames between the connector plugin and the bridge.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/task-result.js

@@ -0,0 +1,43 @@
+/**
+ * After an agent lifecycle ends, fetch the session messages
+ * to extract the assistant's final reply text.
+ */
+/**
+ * Fetch the latest assistant reply from a session after task completion.
+ * Returns a task-result event frame ready to send to bridge.
+ */
+export async function fetchTaskResult(subagent, runId, sessionKey, logger) {
+    try {
+        const { messages } = await subagent.getSessionMessages({ sessionKey, limit: 5 });
+        // Find the last assistant message
+        let text = "";
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const msg = messages[i];
+            if (msg?.role === "assistant") {
+                if (typeof msg.content === "string") {
+                    text = msg.content;
+                }
+                else if (Array.isArray(msg.content)) {
+                    text = msg.content
+                        .map((c) => c.text ?? "")
+                        .join("");
+                }
+                break;
+            }
+        }
+        if (!text) {
+            logger.info(`[task-result] No assistant reply found for runId=${runId}`);
+            return null;
+        }
+        return {
+            type: "event",
+            event: "task-result",
+            payload: { runId, sessionKey, text },
+        };
+    }
+    catch (err) {
+        logger.error(`[task-result] Failed to fetch session messages for runId=${runId}: ${err}`);
+        return null;
+    }
+}
+//# sourceMappingURL=task-result.js.map

package/dist/task-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-result.js","sourceRoot":"","sources":["../src/task-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAqB,EACrB,KAAa,EACb,UAAkB,EAClB,MAAqE;IAErE,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAEjF,kCAAkC;QAClC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAyC,CAAC;YAChE,IAAI,GAAG,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC9B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACpC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;gBACrB,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBACtC,IAAI,GAAI,GAAG,CAAC,OAAoC;yBAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;yBACxB,IAAI,CAAC,EAAE,CAAC,CAAC;gBACd,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,oDAAoD,KAAK,EAAE,CAAC,CAAC;YACzE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;SACrC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,4DAA4D,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/openclaw.plugin.json

@@ -0,0 +1,15 @@
+{
+  "id": "openclaw-connector",
+  "name": "Cora OpenClaw Connector",
+  "description": "Connects this OpenClaw instance to Cora bridge via reverse WebSocket",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "bridgeUrl": {
+        "type": "string",
+        "description": "Bridge WebSocket URL"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@wishee-ai/openclaw-connector",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Connect OpenClaw to Cora bridge via reverse WebSocket",
+  "main": "dist/index.js",
+  "exports": { ".": { "import": "./dist/index.js" } },
+  "files": [ "dist", "openclaw.plugin.json" ],
+  "scripts": { "clean": "rm -rf dist", "prebuild": "npm run clean", "build": "tsc", "prepublishOnly": "npm run build" },
+  "license": "MIT",
+  "keywords": [ "openclaw", "cora", "connector", "bridge" ],
+  "dependencies": { "ws": "^8.18.0", "qrcode-terminal": "^0.12.0" },
+  "devDependencies": { "openclaw": "^2026.6.10", "@types/ws": "^8.5.0", "@types/qrcode-terminal": "^0.12.0", "@types/node": "^22.0.0", "typescript": "^5.7.0" },
+  "peerDependencies": { "openclaw": ">=2026.3.0" },
+  "peerDependenciesMeta": { "openclaw": { "optional": true } },
+  "openclaw": { "extensions": [ "./dist/index.js" ] }
+}