[智能体-572]：Link（智联）是腾讯微信官方开放的个人微信机器人通信协议，对外产品名称叫 ClawBot，是 2026 年腾讯推出、唯一合规的个人微信 Bot 通道。
iLink Bot（微信 ClawBot）完整详解（适配 Hermes 接入场景）
一、基础定义与官方定位
1. 全称与底层协议
iLink（智联）是腾讯微信官方开放的个人微信与机器人通信协议，对外产品名称叫ClawBot，是2026年腾讯推出、唯一合规的个人微信 Bot 通道。
- 接入域名：
ilinkai.weixin.qq.com（腾讯官方服务器，全链路 HTTPS 加密） - 底层载体：OpenClaw AI 网关框架，Hermes 微信适配器完全基于iLink API 封装
- 核心作用：打通个人微信账号 ↔ 本地 AI 智能体（Hermes），转发双向消息、媒体文件
2. 核心本质区别（对比逆向微信机器人）
表格
| 维度 | iLink Bot（官方合规） | 逆向 /iPad/ 网页协议机器人（灰色） |
|---|---|---|
| 合规性 | 腾讯官方开放，签署使用协议，极低封号风险 | 违反微信用户协议，大号极易永久封禁 |
| 登录方式 | 微信扫码授权，生成临时 token，不劫持账号登录态 | 模拟设备登录，劫持会话，风控检测极强 |
| 通信方式 | 长轮询拉取消息，无需公网 IP、Webhook | 模拟客户端心跳，频繁触发风控校验 |
| 媒体支持 | 原生文本 / 图片 / 视频 / 文件 / 语音，CDN 加密传输 | 媒体上传下载易触发限流、封号 |
| 版本兼容 | 微信更新不失效，API 由腾讯持续维护 | 微信升级即失效，需要逆向重写 |
二、核心技术架构（Hermes 如何调用 iLink）
1. 整体通信流程
- 执行
hermes gateway setup选择 Weixin，生成腾讯 iLink 登录二维码链接； - 手机微信扫码授权，微信后端下发
account_id + token凭证，Hermes 保存至~/.hermes/.env； - Hermes 网关通过长轮询（Long Polling）持续连接iLink 服务器，实时拉取微信私聊 / 群消息；
- 用户消息转发给 Hermes 核心智能体（DeepSeek/Kimi 等模型），完成工具调用、推理；
- Hermes 将 AI 回复、生成图片 / 文件通过iLink API 回传给微信客户端展示。
2. 关键技术特性
- 无需公网服务器采用客户端主动长轮询，本地 WSL Ubuntu 即可运行，不用内网穿透、域名、云服务器。
- 全类型消息原生支持
- 基础：文本、Markdown 自动转微信格式、@好友；
- 媒体：图片、视频、本地文档、语音（自动转文字识别）；
- 交互：发送时显示「对方正在输入」，分段流式输出 AI 回答。
- 会话隔离与安全存储
- token 为短期授权凭证，不会保存微信账号密码；
- 所有消息中转仅做透传，腾讯 iLink 不存储你的 AI 模型、本地文件数据。
- 自动断线重连 WSL 重启、网络波动后网关自动恢复 iLink 长轮询，无需重新扫码登录。
三、Hermes 内 iLink Bot 完整能力
1. 消息权限管控（白名单机制）
Hermes 网关内置分层过滤，规避大量消息触发风控：
- 私聊策略：
allowlist（仅指定好友回复，推荐）/all（全部好友响应）； - 群聊策略：
disable（默认关闭）/allowlist（仅指定群聊触发 AI）； - 陌生人消息直接丢弃，不进入模型推理，大幅降低账号风控概率。
2. Hermes 智能体联动能力
iLink 仅做消息通道，完整复用 Hermes 全部技能：
- 联网搜索、本地文件读写、终端代码执行；
- 图像生成（通义万相 / DeepSeek 绘图，跳过 Nous 海外平台）；
- 长文档解析、百万 Token 上下文问答、工程代码调试；
- 多轮连续工具调用，完整自主任务闭环。
3. 服务部署模式
- 前台调试：
hermes gateway，实时打印微信消息收发日志； - 后台常驻挂机：搭配 tmux，关闭 WSL 终端持续运行；
- 开机自启：配置完成后执行
hermes gateway install，WSL 启动自动加载微信 Bot 网关。
四、使用限制、限流与风控规则（实操必看）
1. 消息速率限制
- 单账号每秒最多 5 条消息输出，高频连续回复会触发
rate limited（报错 ret=-2）； - Hermes 内部自带消息延迟缓冲，自动降频，无需手动加延时。
2. 账号风控红线（规避封号）
- 不用于营销、批量群发、自动骚扰陌生人；
- 群聊仅开放少量可信工作群，禁止全通讯录群自动应答；
- 避免 24 小时不间断高频消息推送，夜间可配置网关休眠；
- 优先使用微信小号绑定 iLink，主号不建议长期挂机机器人。
3. 功能限制
- 不支持朋友圈、转账、红包、通讯录批量操作（仅消息收发通道）；
- 单个 iLink 授权绑定单一微信账号，一套 Hermes 网关仅能登录一个微信号；
- token 存在有效期，长期离线后需要重新扫码授权。
五、对比企业微信 WeCom Bot
表格
| iLink Weixin（个人微信） | WeCom 企业微信机器人 |
|---|---|
| 面向私人个人微信账号 | 企业组织内部群 / 客户群 |
| 扫码一键授权，零企业资质 | 需要企业认证、后台自建应用 |
| 私聊对话完整支持 | 仅群聊 / 客户联系，无私人对话 |
| 本地 WSL 即可运行 | 必须公网 Webhook 回调地址 |
| Hermes 一键配置，无需后台操作 | 手动填写 BotID、Secret、加密密钥 |
六、Hermes 接入 iLink 完整排坑指南（对应你当前界面）
- 二维码渲染失败
No module named 'qrcode'bash
运行
安装后重新执行pip3 install qrcode -i https://pypi.tuna.tsinghua.edu.cn/simplehermes gateway setup，终端直接打印二维码，不用复制网页链接。 - 二维码链接打开空白 关闭 Windows/WSL 所有代理、VPN，iLink 是腾讯国内服务，无需翻墙。
- 扫码成功但微信收不到回复
- 执行
hermes gateway status确认网关正在运行； - 核对好友 / 群聊是否加入白名单；
- 重启网关：
hermes gateway restart。
- 执行
- 图像生成自动跳转 Nous 海外平台
bash
运行
在 Image Generation 步骤选择国内绘图服务商（DeepSeek / 通义万相），跳过 Nous 登录。hermes setup
七、优缺点总结
优势
- 唯一官方合规个人微信机器人通道，封号风险远低于逆向方案；
- 本地部署、无需云服务器、内网穿透，WSL Ubuntu22.04（jammy）完美兼容；
- Hermes 深度适配，一键扫码、白名单风控、后台挂机一体化；
- 完整支持图文 / 文件 / 语音，流式 AI 回复体验原生。
短板
- 存在消息发送限流，不适合超高并发群发场景；
- 仅支持消息收发，无朋友圈、红包、转账等高级接口；
- token 有有效期，长期离线需要重新扫码。