6.1 KiB
6.1 KiB
01 — 概述：ClawBot、iLink、OpenClaw 是什么关系
1. 背景
2026 年 3 月，微信上线了官方插件 微信 ClawBot（入口：微信 → 我 → 设置 → 插件 → 微信 ClawBot），这是微信首次官方开放个人账号的 Bot API。在此之前，程序控制微信只有灰色手段：
| 方式 | 典型实现 | 性质 |
|---|---|---|
| 逆向 iPad/网页协议 | WeChatPadPro、itchat(-uos) | 违反用户协议，随时封号 |
| PC 客户端 Hook | DLL 注入、内存读写 | 违法风险，高封号率 |
| 企业微信 API | 官方开放 | 合法，但面向企业不是个人微信 |
| ClawBot / iLink | 微信内置官方插件 | 官方产品，有专项使用条款背书 |
腾讯为此发布了《微信 ClawBot 功能使用条款》（签订地深圳南山，适用中国大陆法律）。条款明确腾讯的定位：只提供消息收发通道，不存储用户输入/输出内容，不提供 AI 服务——AI 能力完全由开发者自己接。
2. 三个概念的分工
| 名词 | 是什么 | 谁的产品 |
|---|---|---|
| ClawBot | 微信客户端内置插件，用户在微信里看到的 AI 联系人（带 "AI" 标识的普通聊天窗口） | 腾讯 |
| iLink（智联） | Bot 通信协议，HTTP/JSON + 长轮询，服务端 ilinkai.weixin.qq.com |
腾讯 |
| OpenClaw | 开源 AI Agent 框架（2025-11 首发，昵称"小龙虾"），腾讯官方通道的默认宿主 | 第三方开源社区（非腾讯） |
关系链条：
用户 → 微信客户端(ClawBot 插件) → iLink 服务器 → Bot 后端（默认是 OpenClaw，可以是任何东西）
腾讯发布的 npm 包：
@tencent-weixin/openclaw-weixin-cli— 一键安装工具（检测 openclaw → 装插件 → 引导扫码 → 重启 gateway）@tencent-weixin/openclaw-weixin— 真正的协议实现包（TypeScript，约 41 个源文件：auth/、api/、cdn/、messaging/、monitor/、config/、storage/）
3. 关键事实：iLink 不绑定 OpenClaw
iLink 是标准 HTTP/JSON API，与 OpenClaw 框架零耦合。 官方的 npm 包只是协议的一个封装实现。任何语言、任何进程都可以直接调 iLink：
- 无需公网 IP（长轮询，主动外连）
- 无需 SDK（
fetch/requests即可） - 无需安装 OpenClaw
已有的非 OpenClaw 实践：
- cc-weixin：把 Claude Code Agent 接进微信
- OpenAkita：Python Agent 框架的微信适配器，直调 iLink 原生 API
- openclaw-weixin-sdk：Java SDK + CLI + Web Terminal
协议跟随情况：2026-04 官方包已迭代到 2.1.x，但 iLink HTTP 协议本体（
getupdates/sendmessage/getuploadurl/ AES-128-ECB / CDN）未变，第三方适配器无需改动。
4. 能力边界总览
下表合并了多个来源的观察，存在版本差异和放量灰度，标注 ⚠️ 的项建议实测确认：
| 项 | 状态 | 备注 |
|---|---|---|
| 私聊（1 对 1） | ✅ 支持 | 主要形态 |
| 群聊 | ⚠️ 未开放/存疑 | 协议源码有 group_id 字段，但多数资料称群聊未开放 |
| 文本收发 | ✅ | 微信侧不支持 Markdown 渲染，发送时应转纯文本 |
| 图片收发 | ✅ | CDN + AES-128-ECB 加密 |
| 语音 | ⚠️ 入站 ✅ / 出站存疑 | 入站 silk 编码且附 ASR 转写文本；有资料称 bot 暂不能主动发语音，也有适配器实现了语音上传 |
| 文件/视频 | ⚠️ 协议支持 | item type 有定义，CDN 链路完整；早期资料称"仅文本"，后续适配器已实现 |
| 主动推送 | ⚠️ 受限 | 需携带入站消息返回的 context_token；有资料称超过 24h 窗口后送达不到 |
| 历史消息拉取 | ❌ | 只有游标机制，无历史 API |
| 一个微信号绑定 bot 数 | 1 个 | 一个微信号 = 一个 bot 实例 |
| 客户端版本要求 | iOS ≥ 8.0.70 | 有资料称安卓 ≥ 8.0.70、鸿蒙 ≥ 8.0.16.40 也已支持 ⚠️ |
| 开放状态 | 逐步放量 | 不是所有账号都能看到插件入口 |
5. 合规要点（详细条款解读见 06 文档）
- 这是官方通道，正常使用无封号风险——这是它相对 itchat/Wechaty 的核心价值。
- 腾讯保留限速、内容识别、拦截、终止连接的权利（条款 4.7）。
- 腾讯不存储消息内容，但收集 IP、操作日志、设备信息用于安全审计（条款 5.3）。
- 禁止用于绕过微信技术保护、违法违规、危害网络安全等用途（条款 4.6）。
- 腾讯可随时变更/终止服务（条款 7.2）——核心业务不要单点依赖它，设计降级方案。
6. 与其他 IM 通道的对比（选型参考）
如果你的 AI 项目不只接微信，可以横向比较（数据来自 OpenAkita 的多平台实践）：
| 平台 | 接收方式 | 需要公网 IP | 群聊 | 合法性 |
|---|---|---|---|---|
| 微信个人号（iLink） | HTTP 长轮询 | 否 | ⚠️ 未开放 | 官方 |
| Telegram | 长轮询 / Webhook | 否 | ✅ | 官方 |
| 飞书 | WebSocket 长连接 | 否 | ✅ | 官方 |
| 钉钉 | Stream (WebSocket) | 否 | ✅ | 官方 |
| 企业微信 | HTTP 回调 | 是 | ✅ (@机器人) | 官方 |
| QQ 官方机器人 | WebSocket | 否 | ✅ | 官方 |
微信 iLink 的独特优势：用户在自己的微信主界面直接和 AI 聊，零安装、零跳转，体验最接近"真人联系人"。独特劣势：仅私聊、主动消息受限、灰度放量。