@clawhive/openclaw-plugin 0.2.0

package/dist/src/wake.js

@@ -0,0 +1,101 @@
+const VALID_TASK_TYPES = new Set([
+    "agent_panel_turn",
+    "market_install",
+    "agency_install",
+]);
+export class PluginWakeSubscription {
+    options;
+    channel = null;
+    startResolve = null;
+    startPromise = null;
+    constructor(options) {
+        this.options = options;
+    }
+    async start() {
+        if (this.startPromise) {
+            return this.startPromise;
+        }
+        const channel = this.options.client
+            .channel(`plugin-wake:${this.options.pluginNodeId}`)
+            .on("postgres_changes", {
+            event: "INSERT",
+            schema: "public",
+            table: "plugin_wake_events",
+            filter: `plugin_node_id=eq.${this.options.pluginNodeId}`,
+        }, (payload) => {
+            this.handleWakeRow(payload.new);
+        });
+        this.channel = channel;
+        this.startPromise = new Promise((resolve) => {
+            this.startResolve = resolve;
+            channel.subscribe((status) => {
+                if (channel !== this.channel) {
+                    return;
+                }
+                if (status === "SUBSCRIBED") {
+                    this.startResolve = null;
+                    this.options.logger?.info(`ClawHive wake subscribed plugin_node=${this.options.pluginNodeId}`);
+                    resolve();
+                    return;
+                }
+                if (isTerminalStatus(status)) {
+                    this.startResolve = null;
+                    this.options.logger?.warn(`ClawHive wake subscription status=${status} plugin_node=${this.options.pluginNodeId}`);
+                    resolve();
+                }
+            });
+        });
+        return this.startPromise;
+    }
+    async stop() {
+        const channel = this.channel;
+        this.channel = null;
+        const resolveStart = this.startResolve;
+        this.startResolve = null;
+        if (!channel) {
+            this.startPromise = null;
+            return;
+        }
+        resolveStart?.();
+        await this.options.client.removeChannel(channel);
+        this.startPromise = null;
+    }
+    handleWakeRow(row) {
+        if (!isRecord(row)) {
+            return;
+        }
+        const taskType = row.task_type;
+        if (typeof taskType !== "string" || !VALID_TASK_TYPES.has(taskType)) {
+            return;
+        }
+        const taskId = row.task_id;
+        const pluginNodeId = row.plugin_node_id;
+        const userId = row.user_id;
+        if (!isNonEmptyString(taskId) || !isNonEmptyString(pluginNodeId) || !isNonEmptyString(userId)) {
+            return;
+        }
+        if (pluginNodeId !== this.options.pluginNodeId || userId !== this.options.userId) {
+            return;
+        }
+        this.options.onWake({
+            id: typeof row.id === "string" ? row.id : String(row.id ?? ""),
+            payload: isPlainObject(row.payload) ? row.payload : {},
+            pluginNodeId,
+            taskId,
+            taskType: taskType,
+            userId,
+        });
+    }
+}
+function isTerminalStatus(status) {
+    return status === "CHANNEL_ERROR" || status === "TIMED_OUT" || status === "CLOSED";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isPlainObject(value) {
+    return isRecord(value) && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}

package/openclaw.config.example.yaml

@@ -0,0 +1,10 @@
+channels:
+  - name: clawhive
+    enabled: true
+    config:
+      projectUrl: "https://your-project.supabase.co"
+      pluginToken: "${CLAWHIVE_PLUGIN_TOKEN}"
+      userId: "supabase-user-uuid"
+      pluginNodeId: null
+      nodeName: "OpenClaw Desktop"
+      pluginVersion: "0.1.0"

package/openclaw.plugin.json

@@ -0,0 +1,122 @@
+{
+  "id": "clawhive",
+  "name": "ClawHive",
+  "description": "ClawHive cloud pairing channel for OpenClaw",
+  "channels": ["clawhive"],
+  "channelEnvVars": {
+    "clawhive": [
+      "CLAWHIVE_SUPABASE_MODE",
+      "CLAWHIVE_PROJECT_URL",
+      "CLAWHIVE_PLUGIN_TOKEN",
+      "CLAWHIVE_USER_ID",
+      "CLAWHIVE_SUPABASE_ANON_KEY"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "projectUrl": {
+        "type": "string",
+        "minLength": 1,
+        "title": "ClawHive Project URL",
+        "description": "Optional Supabase project base URL. In local mode, this should be the local project base URL without /rest/v1."
+      },
+      "anonKey": {
+        "type": "string",
+        "minLength": 1,
+        "title": "ClawHive Anon Key",
+        "description": "Optional Supabase anon key. In local mode, this falls back to CLAWHIVE_SUPABASE_ANON_KEY from the current shell."
+      },
+      "pluginToken": {
+        "type": "string",
+        "minLength": 1,
+        "title": "Plugin Token",
+        "description": "Optional bootstrap token. If omitted, the plugin bootstraps and persists one automatically on first gateway run."
+      },
+      "userId": {
+        "type": "string",
+        "minLength": 1,
+        "title": "Supabase User ID",
+        "description": "Owner user id used when registering the plugin node."
+      },
+      "pluginNodeId": {
+        "type": "string",
+        "title": "Plugin Node ID",
+        "description": "Optional previously assigned plugin node id."
+      },
+      "nodeName": {
+        "type": "string",
+        "title": "Node Name",
+        "description": "Display name used for this desktop plugin node."
+      },
+      "pluginVersion": {
+        "type": "string",
+        "title": "Plugin Version",
+        "description": "ClawHive plugin runtime version."
+      },
+      "publishSourceRef": {
+        "type": "string",
+        "title": "Publish Source Ref",
+        "description": "Optional stable source reference used when preparing a marketplace release."
+      },
+      "publishFingerprint": {
+        "type": "string",
+        "title": "Publish Fingerprint",
+        "description": "Optional immutable checksum or fingerprint for a marketplace release artifact."
+      },
+      "minPluginVersion": {
+        "type": "string",
+        "title": "Minimum Plugin Version",
+        "description": "Optional minimum compatible ClawHive plugin runtime version for a published release."
+      },
+      "minOpenClawVersion": {
+        "type": "string",
+        "title": "Minimum OpenClaw Version",
+        "description": "Optional minimum compatible OpenClaw host version for a published release."
+      }
+    }
+  },
+  "uiHints": {
+    "projectUrl": {
+      "label": "Project URL",
+      "placeholder": "https://your-project.supabase.co"
+    },
+    "anonKey": {
+      "label": "Anon Key",
+      "placeholder": "eyJ..."
+    },
+    "pluginToken": {
+      "label": "Plugin Token",
+      "placeholder": "Auto-generated on first run",
+      "sensitive": true
+    },
+    "userId": {
+      "label": "User ID"
+    },
+    "pluginNodeId": {
+      "label": "Plugin Node ID"
+    },
+    "nodeName": {
+      "label": "Node Name",
+      "placeholder": "OpenClaw Desktop"
+    },
+    "pluginVersion": {
+      "label": "Plugin Version"
+    },
+    "publishSourceRef": {
+      "label": "Publish Source Ref",
+      "placeholder": "git:main#<commit>"
+    },
+    "publishFingerprint": {
+      "label": "Publish Fingerprint",
+      "placeholder": "sha256:..."
+    },
+    "minPluginVersion": {
+      "label": "Minimum Plugin Version"
+    },
+    "minOpenClawVersion": {
+      "label": "Minimum OpenClaw Version"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@clawhive/openclaw-plugin",
+  "version": "0.2.0",
+  "description": "ClawHive channel plugin for OpenClaw",
+  "license": "UNLICENSED",
+  "homepage": "https://github.com/optimalAIs/clawhive#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/optimalAIs/clawhive.git",
+    "directory": "openclaw-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/optimalAIs/clawhive/issues"
+  },
+  "keywords": [
+    "clawhive",
+    "openclaw",
+    "plugin",
+    "channel"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./setup-entry": {
+      "types": "./dist/setup-entry.d.ts",
+      "import": "./dist/setup-entry.js"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./runtime-api": {
+      "types": "./dist/runtime-api.d.ts",
+      "import": "./dist/runtime-api.js"
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md",
+    "openclaw.config.example.yaml"
+  ],
+  "scripts": {
+    "check": "tsc --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run check && npm run build && npm pack --dry-run"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "channel": {
+      "id": "clawhive",
+      "name": "ClawHive"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@sentry/node": "^9.16.0",
+    "@sinclair/typebox": "^0.34.41",
+    "@supabase/supabase-js": "^2.103.2",
+    "openclaw": "^2026.4.14",
+    "qrcode-terminal": "^0.12.0",
+    "tar": "^7.4.3",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}