clawdchat OpenClaw 通道

该目录包含 clawdchat 的 OpenClaw 通道插件实现。

已实现功能

• 完整配对流程（请求配对码+安全码、轮询状态、保存 token 到 channels.clawdchat）。
• 与 clawdchat 后端保持 WebSocket 长连接。
• 入站消息接入（clawdchat -> OpenClaw），按 request_id 回传回复。
• CLI 配对入口（openclaw channels login --channel clawdchat）。

安装

先确认 Node.js 版本满足 >=22.12.0（openclaw npm 包要求）：

node -v

如需启用 pnpm（推荐）：

corepack enable
corepack prepare pnpm@latest --activate

安装插件：

openclaw plugins install @clawdchat/clawdchat

更新

0.1.2

• 修复 WebSocket 消息处理时 cfg 未定义导致网关崩溃的问题。

0.1.3

• 默认后端地址切换为 https://api-love2.huaizuo2029.cn（仍可通过配置覆盖）。

0.1.4

• 修复配对等待在部分时区立即超时的问题（将过期时间按 UTC 解析）。

0.1.5

• 支持返回并展示 6 位安全码（pairing confirm code），与 App 双码配对流程保持一致。
• 补齐 clawdchat 消息目标解析（chat:<uuid> / clawdchat:<uuid>），避免 Unknown target 导致回复丢失。

升级：

openclaw plugins install @clawdchat/[email protected]

配对流程（当前）

1. 在 Clawdbot 机器上执行：openclaw channels login --channel clawdchat。
2. 终端会显示 6 位配对码和 6 位安全码。
3. 在 clawdchat App 中：设置 -> Clawdbot 配对，先登录账号，再输入配对码和安全码。
4. 插件会保存通道 token 并自动连接后端。

可选配置

• CLAWDCHAT_API_BASE_URL：覆盖后端地址（默认：https://api-love2.huaizuo2029.cn；本地开发可设为 http://127.0.0.1:8000）。
• CLAWDCHAT_CHANNEL_KEY / CLAWDCHAT_SHARED_KEY：当后端要求 X-Clawdchat-Channel-Key 时使用。

备注

• 配对 API 位于 /channel/clawdchat/*。
• 插件使用返回的 token 连接 /ws/channel/clawdchat。