首页/资讯中心/详情

[智能体-572]：Link（智联）是腾讯微信官方开放的个人微信机器人通信协议，对外产品名称叫 ClawBot，是 2026 年腾讯推出、唯一合规的个人微信 Bot 通道。

[智能体-572]：Link（智联）是腾讯微信官方开放的个人微信机器人通信协议，对外产品名称叫 ClawBot，是 2026 年腾讯推出、唯一合规的个人微信 Bot 通道。
📅 发布时间：2026/6/29 8:59:09

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. 整体通信流程

  1. 执行hermes gateway setup选择 Weixin，生成腾讯 iLink 登录二维码链接；
  2. 手机微信扫码授权，微信后端下发account_id + token凭证，Hermes 保存至~/.hermes/.env；
  3. Hermes 网关通过长轮询（Long Polling）持续连接iLink 服务器，实时拉取微信私聊 / 群消息；
  4. 用户消息转发给 Hermes 核心智能体（DeepSeek/Kimi 等模型），完成工具调用、推理；
  5. Hermes 将 AI 回复、生成图片 / 文件通过iLink API 回传给微信客户端展示。

2. 关键技术特性

  1. 无需公网服务器采用客户端主动长轮询，本地 WSL Ubuntu 即可运行，不用内网穿透、域名、云服务器。
  2. 全类型消息原生支持
    • 基础：文本、Markdown 自动转微信格式、@好友；
    • 媒体：图片、视频、本地文档、语音（自动转文字识别）；
    • 交互：发送时显示「对方正在输入」，分段流式输出 AI 回答。
  3. 会话隔离与安全存储
    • token 为短期授权凭证，不会保存微信账号密码；
    • 所有消息中转仅做透传，腾讯 iLink 不存储你的 AI 模型、本地文件数据。
  4. 自动断线重连 WSL 重启、网络波动后网关自动恢复 iLink 长轮询，无需重新扫码登录。

三、Hermes 内 iLink Bot 完整能力

1. 消息权限管控（白名单机制）

Hermes 网关内置分层过滤，规避大量消息触发风控：

  • 私聊策略：allowlist（仅指定好友回复，推荐）/all（全部好友响应）；
  • 群聊策略：disable（默认关闭）/allowlist（仅指定群聊触发 AI）；
  • 陌生人消息直接丢弃，不进入模型推理，大幅降低账号风控概率。

2. Hermes 智能体联动能力

iLink 仅做消息通道，完整复用 Hermes 全部技能：

  1. 联网搜索、本地文件读写、终端代码执行；
  2. 图像生成（通义万相 / DeepSeek 绘图，跳过 Nous 海外平台）；
  3. 长文档解析、百万 Token 上下文问答、工程代码调试；
  4. 多轮连续工具调用，完整自主任务闭环。

3. 服务部署模式

  1. 前台调试：hermes gateway，实时打印微信消息收发日志；
  2. 后台常驻挂机：搭配 tmux，关闭 WSL 终端持续运行；
  3. 开机自启：配置完成后执行hermes gateway install，WSL 启动自动加载微信 Bot 网关。

四、使用限制、限流与风控规则（实操必看）

1. 消息速率限制

  • 单账号每秒最多 5 条消息输出，高频连续回复会触发rate limited（报错 ret=-2）；
  • Hermes 内部自带消息延迟缓冲，自动降频，无需手动加延时。

2. 账号风控红线（规避封号）

  1. 不用于营销、批量群发、自动骚扰陌生人；
  2. 群聊仅开放少量可信工作群，禁止全通讯录群自动应答；
  3. 避免 24 小时不间断高频消息推送，夜间可配置网关休眠；
  4. 优先使用微信小号绑定 iLink，主号不建议长期挂机机器人。

3. 功能限制

  1. 不支持朋友圈、转账、红包、通讯录批量操作（仅消息收发通道）；
  2. 单个 iLink 授权绑定单一微信账号，一套 Hermes 网关仅能登录一个微信号；
  3. token 存在有效期，长期离线后需要重新扫码授权。

五、对比企业微信 WeCom Bot

表格

iLink Weixin（个人微信）WeCom 企业微信机器人
面向私人个人微信账号企业组织内部群 / 客户群
扫码一键授权，零企业资质需要企业认证、后台自建应用
私聊对话完整支持仅群聊 / 客户联系，无私人对话
本地 WSL 即可运行必须公网 Webhook 回调地址
Hermes 一键配置，无需后台操作手动填写 BotID、Secret、加密密钥

六、Hermes 接入 iLink 完整排坑指南（对应你当前界面）

  1. 二维码渲染失败No module named 'qrcode'

    bash

    运行

    pip3 install qrcode -i https://pypi.tuna.tsinghua.edu.cn/simple
    安装后重新执行hermes gateway setup，终端直接打印二维码，不用复制网页链接。
  2. 二维码链接打开空白 关闭 Windows/WSL 所有代理、VPN，iLink 是腾讯国内服务，无需翻墙。
  3. 扫码成功但微信收不到回复
    • 执行hermes gateway status确认网关正在运行；
    • 核对好友 / 群聊是否加入白名单；
    • 重启网关：hermes gateway restart。
  4. 图像生成自动跳转 Nous 海外平台

    bash

    运行

    hermes setup
    在 Image Generation 步骤选择国内绘图服务商（DeepSeek / 通义万相），跳过 Nous 登录。

七、优缺点总结

优势

  1. 唯一官方合规个人微信机器人通道，封号风险远低于逆向方案；
  2. 本地部署、无需云服务器、内网穿透，WSL Ubuntu22.04（jammy）完美兼容；
  3. Hermes 深度适配，一键扫码、白名单风控、后台挂机一体化；
  4. 完整支持图文 / 文件 / 语音，流式 AI 回复体验原生。

短板

  1. 存在消息发送限流，不适合超高并发群发场景；
  2. 仅支持消息收发，无朋友圈、红包、转账等高级接口；
  3. token 有有效期，长期离线需要重新扫码。