微信官方 ClawBot 插件接入指南：iLink 协议与实战解析
2026 年 3 月 22 日，腾讯微信正式发布 ClawBot 官方插件，通过 iLink 协议开放了个人微信的 Bot API。这标志着开发者可以通过官方渠道，让 AI 助手直接接入微信个人号，实现私聊对话、群聊互动及文件收发等完整功能。
一、插件概况：什么是 ClawBot？
ClawBot 是腾讯微信官方推出的 AI 助手连接插件，底层基于 iLink（智联）协议，接入域名为 ilinkai.weixin.qq.com。
相比以往依赖 Hook 或模拟协议的旧方案，iLink Bot API 在合法性、稳定性和封号风险上都有显著优势：
| 维度 | 旧方案（WeChatPadPro 等） | iLink Bot API |
|---|---|---|
| 合法性 | 违反微信服务协议，灰色地带 | ✅ 官方开放，合法合规 |
| 稳定性 | 每次微信更新可能失效 | ✅ 服务器端 API，稳定可靠 |
| 封号风险 | 极高，随时可能被封 | ✅ 正常使用无封号风险 |
| 协议层 | 模拟 iPad/移动端协议 | ✅ HTTP/JSON，标准接口 |
| 媒体支持 | 有限 | ✅ 图片/语音/文件/视频完整支持 |
| 群聊 | 需要特殊处理 | ✅ 原生支持 |
核心能力
- 私聊对话：微信用户与 OpenClaw 机器人一对一交流
- 流式输出：AI 回复内容实时流式传输
- 长连接模式：基于长轮询的消息推送机制
- 多媒体支持：文本、图片、语音、文件、视频
- Skills 调用：可调用 OpenClaw 技能市场的兼容技能
- 群聊互通：支持微信群聊场景（需配置）
二、技术亮点：iLink 协议深度解析
腾讯开放的接口全部在 https://ilinkai.weixin.qq.com 下，采用 HTTP/JSON 协议，无需 SDK，可直接用 fetch 调用。
1. 核心端点
| Endpoint | Method | 功能 |
|---|---|---|
/ilink/bot/get_bot_qrcode | GET | 获取登录二维码 |
/ilink/bot/get_qrcode_status | GET | 轮询扫码状态 |
/ilink/bot/getupdates | POST | 长轮询收消息（核心） |
/ilink/bot/sendmessage | POST | 发送消息 |
