微信官方 Bot API 上手：ClawBot 插件的 iLink 协议细节

POST /ilink/bot/getupdates
{
  "get_updates_buf": "<上次返回的游标，首次为空>",
  "base_info": {"channel_version": "1.0.2"}
}

服务器会 hold 住连接最多 35 秒，有消息就立刻返回。没消息就 35 秒后返回空，然后你再发起下一次请求。

消息结构

收到消息的 JSON 大致长这样：

{
  "from_user_id": "[email protected]",
  "to_user_id": "[email protected]",
  "message_type": 1,
  "context_token": "AARzJWAFAAABAAAAAAAp...",
  "item_list": [
    {
      "type": 1,
      "text_item": {"text": "你好"}
    }
  ]
}

ID 规律：用户是 [email protected]，Bot 是 [email protected]。message_type 的值：

• 1：文本
• 2：图片（CDN 加密）
• 3：语音（silk 编码，附带转文字）
• 4：文件
• 5：视频

回复时必须带上 context_token

这是一上线就容易踩坑的地方。每条收到的消息都有一个 context_token，你发送回复的时候必须原样填进去，不然消息不会关联到正确的聊天窗口，用户那边可能收不到或串到别的会话里。

POST /ilink/bot/sendmessage
{
  "msg": {
    "to_user_id": "[email protected]",
    "message_type": 2,
    "message_state": 2,
    "context_token": "<从收到的消息里取>",
    "item_list": [
      {"type": 1, "text_item": {"text": "你好！"}}
    ]
  }
}

CDN 媒体加密

微信 CDN 上的所有媒体文件都经过了 AES-128-ECB 加密，下载后得解一下才能用。好在 protocol 文档里给了密钥获取方式，不算复杂。

快速接个 Bot 试试

前提：微信升级到 iOS 8.0.70+（Android 同理最新版），并且你手头有一个运行中的 OpenClaw 实例。

1. 打开微信 → 我 → 设置 → 插件，找到「ClawBot」卡片。
2. 在你的 OpenClaw 服务器上执行：

   npx -y @tencent-weixin/openclaw-weixin-cli@latest install
   

3. 终端会显示一个二维码，用微信扫它，确认绑定。
4. 看到「连接成功」就完了，然后可以在微信里给 Bot 发消息测试。

几分钟的事。配合 Claude Agent SDK，15 分钟就能搭一个能查系统信息的小助手。比如发：「告诉我现在我是什么电脑，什么电量」，它就会调系统命令，回来完整的机型和电量数据。

官方法律条款要注意

腾讯这次发布了《微信 ClawBot 功能使用条款》，重点：

'我们仅提供微信 ClawBot 插件与第三方 AI 服务的信息收发，不存储你的输入内容与输出结果，不提供 AI 相关服务。'

也就是说，iLink 只是一个消息管道，AI 服务、数据存储全是你自己的事。签订地在深圳南山区，适用中国大陆法律，是正式产品，有法律文件背书，不是灰色地带。

现状与后续

目前插件还在灰度测试阶段，很多人可能还看不到入口。QQ 那边早就通过 OpenClaw 接入了机器人，微信这边开始试水。已经支持的渠道还有飞书、钉钉、Telegram、Discord 等，OpenClaw 的多平台能力让这件事顺理成章。

参考资源：

• OpenClaw 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/hao-ji-xing/openclaw-weixin
• 菜鸟教程：https://www.runoob.com/ai-agent/openclaw-weixin.html