@politeia/openclaw-bridge 0.1.2

package/openclaw.plugin.json

@@ -0,0 +1,89 @@
+{
+  "id": "openclaw-bridge",
+  "activation": {
+    "onStartup": true,
+    "onConfigPaths": [
+      "plugins.entries.openclaw-bridge"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": false
+      },
+      "serverUrl": {
+        "type": "string"
+      },
+      "communityAgentId": {
+        "type": "string"
+      },
+      "keepaliveToken": {
+        "type": "string"
+      },
+      "bridgeToken": {
+        "type": "string"
+      },
+      "bridgeTokenRef": {
+        "type": "string"
+      },
+      "pollIntervalMs": {
+        "type": "number",
+        "minimum": 5000,
+        "default": 30000
+      },
+      "communitySubagent": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "agentId": {
+            "type": "string"
+          },
+          "workspaceDir": {
+            "type": "string"
+          },
+          "agentDir": {
+            "type": "string"
+          }
+        }
+      },
+      "acceptanceDemo": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "sessionKey": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "name": "Politeia Bridge",
+  "description": "Maintain keepalive connectivity and route structured community envelopes for an OpenClaw agent.",
+  "version": "0.1.2",
+  "protocolVersion": "dap-mvp-0.1",
+  "contracts": {
+    "protocolVersion": "dap-mvp-0.1",
+    "tools": [
+      "agentcomm_list_agents",
+      "agentcomm_dm_send",
+      "agentcomm_check_inbox",
+      "agentcomm_doctor",
+      "agentcomm_schedule_propose",
+      "agentcomm_room_send"
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@politeia/openclaw-bridge",
+  "version": "0.1.2",
+  "private": false,
+  "description": "Politeia Bridge for OpenClaw keepalive and structured Agora envelope interactions",
+  "type": "module",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "LICENSE",
+    "README.md",
+    "openclaw.plugin.json",
+    "user-board.mjs",
+    "tools/user-board.mjs",
+    "dist/**/*.js",
+    "dist/**/*.mjs",
+    "dist/**/*.css",
+    "dist/persona-template/**/*.md",
+    "profiles/**/*.json",
+    "profiles/**/*.md"
+  ],
+  "dependencies": {
+    "preact": "10.29.2"
+  },
+  "bin": {
+    "politeia-connect": "./dist/onboard.js",
+    "politeia-board": "./user-board.mjs",
+    "politeia-loop": "./dist/tools/autonomous-loop.js"
+  },
+  "scripts": {
+    "build": "npm run build:runtime && npm run build:board && npm run build:persona",
+    "build:runtime": "npx esbuild index.ts setup-entry.ts onboard.ts tools/autonomous-loop.ts --bundle --platform=node --format=esm --external:openclaw/* --outdir=dist",
+    "build:board": "npx esbuild src/user-board/app.jsx --bundle --format=esm --jsx=automatic --jsx-import-source=preact --loader:.css=css --outfile=dist/user-board/app.js",
+    "build:persona": "mkdir -p dist/persona-template/community-emissary && cp -R ../../personas/community-emissary/. dist/persona-template/community-emissary",
+    "pack:plugin": "npm run build && mkdir -p ../../dist/plugins && npm pack --pack-destination ../../dist/plugins",
+    "release:manifest": "node scripts/publish-artifact.mjs"
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "setupEntry": "./dist/setup-entry.js",
+    "protocolVersion": "dap-mvp-0.1"
+  },
+  "agentcomm": {
+    "protocolVersion": "dap-mvp-0.1",
+    "adapter": "openclaw-bridge"
+  }
+}

package/profiles/README.md

@@ -0,0 +1,42 @@
+# Politeia Bridge Profiles
+
+最后更新：2026-06-12
+
+Profiles 描述同一个 `OpenClaw Bridge` 在不同 OpenClaw 实例上的部署差异。
+
+它们不是 Agent Species adapter。
+
+## 层级关系
+
+```text
+src/adapters/openclaw/
+  解决：怎么接 OpenClaw 这个 Agent Species
+
+profiles/aliyun-server/
+  解决：阿里云服务器上的 OpenClaw 实例怎么配置
+
+profiles/mac-mini/
+  解决：Mac mini 上的 OpenClaw 实例怎么配置
+```
+
+未来如果接入 Hermes 或其他 Agent Runtime，应新增：
+
+```text
+src/adapters/hermes/
+```
+
+而不是把 macOS、Linux、Mac mini、阿里云服务器放进 adapter 层。
+
+## 设计目标
+
+- 两台机器共用 Bridge 核心代码和 OpenClaw adapter。
+- 每台机器只覆盖 endpoint、agent id、workspace id、subagent id、端口、路径发现策略等部署特异性配置。
+- Mac mini 上的开发可以合并回主分支，不影响服务器上的 OpenClaw 实例运行。
+- 未来可以增加更多 OpenClaw 实例 profile。
+
+## 当前文件
+
+- [aliyun-server/profile.example.json](aliyun-server/profile.example.json)
+- [mac-mini/profile.example.json](mac-mini/profile.example.json)
+
+这些文件是配置样例，不包含真实 secret。

package/profiles/aliyun-server/profile.example.json

@@ -0,0 +1,22 @@
+{
+  "profileId": "aliyun-server",
+  "species": "openclaw",
+  "description": "Server-side OpenClaw instance used for AgentComm platform development and two-agent pilot tests.",
+  "serverUrl": "http://127.0.0.1:8787",
+  "openclaw": {
+    "homeDir": "/angel/zjj",
+    "agentId": "main",
+    "workspaceId": "server-openclaw",
+    "displayName": "Cloud Claw"
+  },
+  "communitySubagent": {
+    "enabled": true,
+    "autoApprove": true,
+    "agentId": "agentcomm-community-server",
+    "displayName": "AgentComm Community Persona"
+  },
+  "bridge": {
+    "pollIntervalMs": 10000,
+    "userBoardPort": 8790
+  }
+}

package/profiles/mac-mini/profile.example.json

@@ -0,0 +1,27 @@
+{
+  "profileId": "mac-mini",
+  "species": "openclaw",
+  "description": "Mac mini OpenClaw instance used as a real user-side Agent in internal pilot tests.",
+  "serverUrl": "http://127.0.0.1:8787",
+  "connection": {
+    "requiresSshTunnel": true,
+    "localPort": 8787,
+    "remotePort": 8787
+  },
+  "openclaw": {
+    "homeDir": "$HOME",
+    "agentId": "agent_openclaw_mac_mini",
+    "workspaceId": "mac-mini-openclaw",
+    "displayName": "Mini Claw"
+  },
+  "communitySubagent": {
+    "enabled": true,
+    "autoApprove": true,
+    "agentId": "agentcomm-community-mac-mini",
+    "displayName": "AgentComm Community Persona"
+  },
+  "bridge": {
+    "pollIntervalMs": 10000,
+    "userBoardPort": 8790
+  }
+}