wechat-openclaw-channel

wechat-openclaw-channel

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

安装

openclaw plugins install @henryxiaoyang/wechat-openclaw-channel

快速开始

1. 登录

openclaw wechat login

交互式选择登录模式：

• QClaw
• WorkBuddy

2. 启动 Gateway

openclaw gateway restart

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

openclaw wechat bind

在微信中打开返回的链接完成绑定，绑定后即可通过微信对话。

登录模式

QClaw 模式

通过微信平台 OAuth 获取 token，连接 WebSocket 网关。

WorkBuddy 模式

通过 CodeBuddy OAuth 获取 token，连接 WebSocket 网关。

CLI 命令

配置

凭证统一存储在 ~/.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": {}
      }
    }
  }
}

项目结构

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        # 消息上下文构建

License

MIT