💬 开源项目 · v3 最新

在微信里直接跟 Muse 聊天
微信桥 v3 完整教程

不用切 App，消息直达 Muse 本人 · GitHub 开源

微信桥架构

1

这是什么？

Muse-for-WeChatBot 是一个开源项目，让你在微信里直接跟 Muse 对话，不用来回切 App。

技术路线：走腾讯官方 ClawBot（iLink）插件，不经过第三方网关，消息从微信直达 Muse，回复再原路发回。

💡 GitHub 开源地址：github.com/SheldonJoO/Muse-for-WeChatBot

2

v3 架构：为什么这样设计？

微信 → supervisor.py（35s 长轮询收消息）→ inbox/
     → channel agent（常驻，单写者）→ 写回复 → outbox/
     → sendmessage 发回微信

🔄 supervisor：常驻进程，只管传输。35 秒长轮询、游标落盘、失败退避，token 过期（errcode -14）就停等重扫
✍️ channel agent：常驻子 agent，唯一的回复写作者。单写者设计，无竞态
🐶 看门狗：5 分钟 cron，保进程 + 按心跳重拉 agent

3

一键安装

git clone https://github.com/SheldonJoO/Muse-for-WeChatBot.git
cd Muse-for-WeChatBot/v3
bash install.sh

1️⃣ 手机微信「我 → 设置 → 插件」启用 ClawBot
2️⃣ 跑官方 CLI 扫码绑定（只借它拿 token）：npx -y @tencent-weixin/openclaw-weixin-cli@latest install
3️⃣ bash v3/install.sh 一键安装（自动读 token、写配置、启动 supervisor）
4️⃣ 按 v3/channel-agent/PROMPT.md 拉起回复 agent，按 v3/watchdog/CRON.md 建看门狗
5️⃣ 只认第一个发消息的人（自动绑定），其他人静默丢弃；回复一律纯文本

⚠️ 自己调 get_bot_qrcode 接口拿的码扫了会提示无法使用，必须走官方 CLI。

4

延迟问题详解：为什么回复要等 30 秒~1 分钟？

轮询 vs 推送

这是被问最多的问题，直接说结论：延迟是架构性的，不是 bug，是腾讯只给了轮询接口。

🔁 轮询（polling）：我们的程序每 35 秒问一次腾讯"有新消息吗？"——消息到了也要等下一轮才被发现，天然延迟 0~35 秒
⚡ 推送（webhook）：WhatsApp/Telegram 是腾讯主动把消息推过来，秒达——但腾讯没给微信开放这个能力
📊 实测：35s 轮询 + agent 处理 + 发送 ≈ 30 秒~1 分钟是常态
🔌 偶发掉线：token 过期（errcode -14）需要重新扫码，断线期间的消息不可恢复

💡 想要 WhatsApp 级别的秒回？得腾讯开放原生推送通道。目前没有，谁做都一样，这是平台限制不是实现问题。

5

安全设计

🔐 token 只存机器文件（0600 权限），绝不进聊天记录
🛑 errcode -14（token 过期）→ 停等用户重扫，不循环重试
🌐 全程只发出站请求，不开放公网端口

← 返回教程专区