wechat-bridge

name	wechat-bridge
description	微信接入 OpenClaw 的桥接工具。基于 qclaw-wechat-client 实现微信扫码登录、消息收发，将微信用户消息转发到 OpenClaw 处理。当用户需要接入微信、配置微信桥接、启动/停止微信服务时使用此技能。
metadata	{"openclaw":{"emoji":"💬","requires":{"bins":["node"]},"install":[{"id":"node","kind":"node","package":"qclaw-wechat-client@^0.1.1","label":"Install qclaw-wechat-client (npm)"}],"category":"integration","tags":["wechat","qclaw","bridge","messaging"]}}

WeChat Bridge - 微信接入 OpenClaw

基于 qclaw-wechat-client 的微信桥接，实现微信 ↔ OpenClaw 双向消息通信。

消息流转

微信用户消息 → 腾讯 AGP WebSocket → bridge.mjs → cron agentTurn (isolated)
    → AI 处理 → bridge 轮询 cron runs → AGP sendTextResponse → 微信用户

回复机制（轮询模式）

1. 收到微信消息 → 创建一次性 cron agentTurn job（delivery=webhook 作为备用）
2. 每 2 秒轮询 cron runs 获取运行结果
3. 检测到 action: "finished" → 提取 summary → 通过 AGP 发回微信
4. 超时 60 秒未完成 → 回复"回复超时"
5. pending job 超过 5 分钟自动清理（防内存泄漏）

前置要求

1. QClaw 邀请码 — 腾讯内测资格
2. Node.js 18+ — 已在 PATH 中
3. OpenClaw Gateway 运行中 — 默认 http://127.0.0.1:18789

首次设置

1. 安装依赖

cd ~/.openclaw/workspace/skills/wechat-bridge
npm install

2. 扫码登录

node scripts/login.mjs

• 终端显示二维码，微信扫码
• 扫码后浏览器跳转，从地址栏复制 code 参数粘贴回终端
• 登录成功后 session 自动保存到 config/session.json

3. 启动桥接服务

# systemd 服务（推荐，已配置）
sudo systemctl start wechat-bridge
sudo systemctl enable wechat-bridge  # 开机自启
sudo systemctl status wechat-bridge

# 前台运行（调试用）
node scripts/bridge.mjs

4. 环境变量（可选）

变量	默认值	说明
OPENCLAW_GATEWAY	http://127.0.0.1:18789	OpenClaw Gateway 地址
OPENCLAW_TOKEN	openclaw123	Gateway 认证 token
BRIDGE_PORT	3456	Webhook 监听端口

日常操作

# 查看服务状态
curl http://localhost:3456/status

# 查看日志
tail -f logs/bridge.log

# 重新登录（token 过期时）
node scripts/login.mjs

# 停止服务
pkill -f "bridge.mjs"

注意事项

• Session 过期 — 微信登录会话会过期，需定期执行 login.mjs 重新登录
• Token 自动刷新 — Channel token 每 2 小时自动刷新，无需手动干预
• 网络要求 — 需要能访问腾讯 mmgrcalltoken.3g.qq.com 和 jprx.m.qq.com