OpenClaw 微信支持插件 — 支持 QClaw 和 WorkBuddy 双模式

戈三哥

安装

1. openclaw plugins install @henryxiaoyang/wechat-openclaw-channel

复制代码

快速开始

1. 登录

1. openclaw wechat login

复制代码

交互式登录选择模式：

• QClaw — 微信扫码登录目前需要内测码。
  
• WorkBuddy — CodeBuddy OAuth 登录
  

2. 启动网关

1. openclaw gateway restart

复制代码

3. 设备绑定（首次使用）

1. 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 下：

1. {
2.   "channels": {
3.     "wechat-openclaw-channel": {
4.       "loginMode": "workbuddy",
5.       "environment": "production",
6.       "qclaw": {
7.         "jwtToken": "...",
8.         "channelToken": "...",
9.         "apiKey": "...",
10.         "guid": "...",
11.         "userId": "...",
12.         "wsUrl": "...",
13.         "userInfo": {}
14.       },
15.       "workbuddy": {
16.         "accessToken": "...",
17.         "refreshToken": "...",
18.         "userId": "...",
19.         "hostId": "...",
20.         "baseUrl": "https://copilot.tencent.com",
21.         "userInfo": {}
22.       }
23.     }
24.   }
25. }

复制代码

字段说明

字段	说明
loginMode	当前登录模式：qclaw或workbuddy
environment	环境：production（默认）或test
qclaw	QClaw 模式依据（登录后自动写入）
workbuddy	WorkBuddy 模式依赖（登录后自动写入）

项目结构

1. index.ts                    # 插件入口，注册渠道、CLI、启停 WebSocket
2. auth/
3.   types.ts                  # 认证相关类型（LoginMode, QClawCredentials, WorkBuddyCredentials）
4.   environments.ts           # 生产/测试环境配置
5.   device-guid.ts            # 设备 GUID 生成
6.   qclaw-api.ts              # QClaw JPRX 网关 API 客户端
7.   codebuddy-api.ts          # CodeBuddy (copilot.tencent.com) API 客户端
8.   wechat-login.ts           # QClaw 扫码登录流程（交互式）
9.   wechat-qr-poll.ts         # QR 码 URL 生成
10.   device-bind.ts            # 设备绑定流程
11. websocket/
12.   types.ts                  # AGP 协议类型
13.   websocket-client.ts       # QClaw WebSocket 客户端
14.   centrifuge-client.ts      # WorkBuddy Centrifuge WebSocket 客户端
15.   message-handler.ts        # 消息处理（调用 Agent）
16.   message-adapter.ts        # AGP ↔ OpenClaw 消息适配
17. common/
18.   runtime.ts                # OpenClaw 运行时单例
19.   agent-events.ts           # Agent 事件订阅
20.   message-context.ts        # 消息上下文构建

复制代码

epic_ai

好文，微信支持插件的趋势基本被楼主说中了。

frost144

WorkBuddy模式（推荐） 通过CodeBuddy OAuth获取token，连接WebSocket网关。

这段深有同感，WorkBuddy确实是这样。

hyper878

已阅，受益匪浅，楼主加油更新。

salmon_storm_34

从头看到尾，收获不少，感谢分享。

griffin_omega_75

深度好文，就是WorkBuddy那块还想看个具体例子，期待下篇。