安装
openclaw plugins install @henryxiaoyang/wechat-openclaw-channel
快速开始
1.登录
openclaw wechat login
交互式登录选择模式：
-
QClaw — 微信扫码登录目前需要内测码。
-
WorkBuddy — CodeBuddy OAuth 登录
2.启动网关
openclaw gateway restart
3.设备绑定（首次使用）
openclaw wechat bind
在微信中打开返回的链接完成绑定，绑定后即可通过微信对话。
登录模式
QClaw模式
通过微信平台OAuth获取token，连接WebSocket网关。目前需要内测码。
WorkBuddy模式 （推荐）
通过CodeBuddy OAuth获取token，连接WebSocket网关。不需要内测码。
CLI 命令
| 命令 | 说明 |
|---|---|
openclaw wechat login |
酒精登录（选择QClaw 或 WorkBuddy） |
openclaw wechat logout |
清晰登录状态 |
openclaw wechat bind |
获取设备绑定链接 |
配置
价格统一存储在~/.openclaw/openclaw.json的channels.wechat-openclaw-channel下：
{
"channels": {
"wechat-openclaw-channel": {
"loginMode": "workbuddy",
"environment": "production",
"qclaw": {
"jwtToken": "...",
"channelToken": "...",
"apiKey": "...",
"guid": "...",
"userId": "...",
"wsUrl": "...",
"userInfo": {}
},
"workbuddy": {
"accessToken": "...",
"refreshToken": "...",
"userId": "...",
"hostId": "...",
"baseUrl": "https://copilot.tencent.com",
"userInfo": {}
}
}
}
}
| 字段 | 说明 |
|---|---|
loginMode |
当前登录模式：qclaw或workbuddy |
environment |
环境：production（默认）或test |
qclaw |
QClaw 模式依据（登录后自动写入） |
workbuddy |
WorkBuddy 模式依赖（登录后自动写入） |
项目结构
index.ts # 插件入口，注册渠道、CLI、启停 WebSocket
auth/
types.ts # 认证相关类型（LoginMode, QClawCredentials, WorkBuddyCredentials）
environments.ts # 生产/测试环境配置
device-guid.ts # 设备 GUID 生成
qclaw-api.ts # QClaw JPRX 网关 API 客户端
codebuddy-api.ts # CodeBuddy (copilot.tencent.com) API 客户端
wechat-login.ts # QClaw 扫码登录流程（交互式）
wechat-qr-poll.ts # QR 码 URL 生成
device-bind.ts # 设备绑定流程
websocket/
types.ts # AGP 协议类型
websocket-client.ts # QClaw WebSocket 客户端
centrifuge-client.ts # WorkBuddy Centrifuge WebSocket 客户端
message-handler.ts # 消息处理（调用 Agent）
message-adapter.ts # AGP ↔ OpenClaw 消息适配
common/
runtime.ts # OpenClaw 运行时单例
agent-events.ts # Agent 事件订阅
message-context.ts # 消息上下文构建