ba754ccc31
- Auth module: WeChat OAuth2 scan-to-login flow with terminal QR code - Token persistence to ~/.openclaw/wechat-access-auth.json (chmod 600) - Token resolution: config > saved state > interactive login - Invite code verification (configurable bypass) - Production/test environment support - AGP WebSocket client with heartbeat, reconnect, wake detection - Message handler: Agent dispatch with streaming text and tool calls - Random device GUID generation (persisted, no real machine ID)
wechat-access-unqclawed
OpenClaw 微信通路插件 — 通过 WeChat OAuth 扫码登录获取 token，连接 AGP WebSocket 网关收发消息。
功能
- 微信扫码登录（终端二维码 + 浏览器链接）
- Token 自动持久化，重启免登录
- AGP 协议 WebSocket 双向通信（流式文本、工具调用）
- 邀请码验证（可配置跳过）
- 支持生产/测试环境切换
安装
npm install
依赖 Node.js v22+，作为 OpenClaw 渠道插件运行。
配置
在 OpenClaw 配置文件的 channels.wechat-access 下：
{
"channels": {
"wechat-access": {
"token": "",
"wsUrl": "",
"bypassInvite": false,
"environment": "production"
}
}
}
| 字段 | 类型 | 说明 |
|---|---|---|
token |
string | 手动指定 channel token（留空则走扫码登录） |
wsUrl |
string | WebSocket 网关地址（留空则使用环境默认值） |
bypassInvite |
boolean | 跳过邀请码验证 |
environment |
string | production 或 test |
authStatePath |
string | 自定义 token 持久化路径 |
Token 获取策略
- 读取配置中的
token— 如果有，直接使用 - 读取本地保存的登录态（
~/.openclaw/wechat-access-auth.json） - 以上都没有 — 启动交互式微信扫码登录
项目结构
index.ts # 插件入口，注册渠道、启停 WebSocket
auth/
types.ts # 认证相关类型
environments.ts # 生产/测试环境配置
device-guid.ts # 设备 GUID 生成（随机，持久化）
qclaw-api.ts # QClaw JPRX 网关 API 客户端
state-store.ts # Token 持久化
wechat-login.ts # 扫码登录流程编排
websocket/
types.ts # AGP 协议类型
websocket-client.ts # WebSocket 客户端（连接、心跳、重连）
message-handler.ts # 消息处理（调用 Agent）
message-adapter.ts # AGP <-> OpenClaw 消息适配
common/
runtime.ts # OpenClaw 运行时单例
agent-events.ts # Agent 事件订阅
message-context.ts # 消息上下文构建
http/ # HTTP webhook 通道（备用）
协议
AGP (Agent Gateway Protocol) — 基于 WebSocket Text 帧的 JSON 消息协议，详见 websocket.md。
License
MIT