正在整理你需要的资料…
把微信当成 AI 助手的对话入口,最怕消息丢了,或者为了接它自建公网服务。wx-bot 走腾讯官方的 ClawBot / iLink 协议:每条消息先落进本地 SQLite 收件箱再推给 Agent,投递失败自动重投,可 webhook 收也可 pull 取;文本、图片、语音、文件、视频都能收发,只出站不对外开端口。
适合想用微信当 AI 助手的对话入口、又不想自建公网服务的人;只处理本人扫码登录的那个微信号,好友消息收不到,Agent 跑在云机器上还得配保活。
wx-bot
把微信当成 AI 助手的对话入口,最怕消息丢了,或者为了接它自建公网服务
下面是把仓库 README 逐节读完后归纳出的中文要点。
消息先落盘到本地 SQLite 收件箱再确认,投递失败自动重投;不对外开端口,本地 API 只监听 loopback;只处理扫码登录的本人微信,不支持好友;支持 webhook 推送与 pull 拉取,收发文本、图片、语音与文件
把指定那句话发给你的 Grok Bot 或 Muse,它会自己装好,你只需用微信扫码;装好后要先用微信给 ClawBot 发一条消息,Agent 才能回复;Grok 的云电脑会自动休眠与重置,需按第 8 步配好每 10 分钟的保活
每条消息是一个 JSON 事件,含 event_id、from_wxid、text、voice_text 与 media 本机路径;同一事件可能重复送达,按 event_id 去重;webhook 用 POST 推送返回 2xx 即送达
提供 status、chatlog、health、requeue、update、uninstall 等命令看状态与排查;chatlog_days 默认 0 关闭,开启后按天写入 jsonl 并保留最近 N 天,升级可跑 install.sh
Agent 收不到消息先跑 wx-bot health --grace 0;好友消息收不到是预期行为,因为只支持本人使用;send 报 no context_token 说明对方还没发过消息;日志出现 -14 或 expired 是登录过期需重新登录
packages/core 管协议与收件箱,packages/cli 是命令行,packages/cloudflare 用于 Workers 部署;项目调用腾讯官方 ClawBot 与 iLink 接口,但与腾讯无关,不是腾讯官方产品
curl -fsSL https://raw.githubusercontent.com/lawrencewzen/wx-bot/main/install.sh | bash
# 源码安装:git clone 后运行 ./install.sh --service(--service 同时装开机自启)| 主要语言 | TypeScript | 许可 | MIT |
|---|---|---|---|
| 创建时间 | 2026-10-09 | 最近提交 | 2026-10-23 |
| 站内采集 | 2026-11-06 起,连续观察 2 天 | 最近一次 | 2026-11-07 |
最近 2 次采集
2026-11-06 207 ★ → 2026-11-07 210 ★ (累计 +3)
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。