微信开放官方 Bot API:ClawBot 插件上手记录
今天(2026 年 3 月 22 日),微信的「插件」页面里悄悄出现了一个新东西——ClawBot 官方插件。版本号 @tencent-weixin/openclaw-weixin v1.0.2,接入的是 OpenClaw AI 网关框架。
这意味着个人微信终于有了官方、合法的 Bot 接入通道。在此之前,想在微信里跑机器人,要么用 Web 协议(早就被封得差不多了),要么走 iPad/Mac 协议的灰色地带,随时可能封号。现在腾讯直接给出了一个 HTTP/JSON 的接口,叫 iLink(智联),服务器端稳定运行,不用操心客户端协议。
插件能做什么
ClawBot 插件本身是一个「连接器」,它不提供 AI 能力,而是把微信消息路由到你部署的 OpenClaw 实例,再由 OpenClaw 调用后端的大模型或技能。
- 私聊对话:一对一收发消息
- 流式输出:AI 回复可以实时打字
- 长连接推送:基于长轮询,消息延迟很低
- 多媒体:文本、图片、语音、文件、视频都支持
- Skills 调用:能触发 OpenClaw 技能市场里的工具
- 群聊互通:配置后可以加入群聊
对比以前玩过的 WeChatPadPro 这类方案,iLink Bot API 的好处肉眼可见:合法稳定,不怕微信更新,没有封号焦虑。协议层也从模拟客户端变成了标准的 HTTP/JSON + Bearer Token。
iLink 协议关键点
接口全部部署在 https://ilinkai.weixin.qq.com 下,没有 SDK,可以直接用 curl 或 fetch。
核心端点一览
| Endpoint | Method | 作用 |
|---|---|---|
/ilink/bot/get_bot_qrcode | GET | 获取登录二维码 |
/ilink/bot/get_qrcode_status | GET | 轮询扫码状态 |
/ilink/bot/getupdates | POST | 长轮询收消息(这是核心) |
/ilink/bot/sendmessage | POST | 发消息 |
/ilink/bot/getuploadurl | POST | 获取 CDN 预签名上传地址 |
/ilink/bot/sendtyping | POST | 发送「正在输入」状态 |
认证机制
每个请求都要带上固定的头:
Content-Type: application/json
AuthorizationType: ilink_bot_token
X-WECHAT-UIN: base64(随机 uint32)
Authorization: Bearer <你的 bot_token>
X-WECHAT-UIN 每次请求要变,这是防重放的。我猜为了省事可以直接生成一个随机数然后 base64,不用每次真去算 UIN。
长轮询 getUpdates
和 Telegram Bot API 类似:


