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 如何调用 iLink1. 整体通信流程执行hermes gateway setup选择 Weixin生成腾讯 iLink 登录二维码链接手机微信扫码授权微信后端下发account_id token凭证Hermes 保存至~/.hermes/.envHermes 网关通过长轮询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 installWSL 启动自动加载微信 Bot 网关。四、使用限制、限流与风控规则实操必看1. 消息速率限制单账号每秒最多 5 条消息输出高频连续回复会触发rate limited报错 ret-2Hermes 内部自带消息延迟缓冲自动降频无需手动加延时。2. 账号风控红线规避封号不用于营销、批量群发、自动骚扰陌生人群聊仅开放少量可信工作群禁止全通讯录群自动应答避免 24 小时不间断高频消息推送夜间可配置网关休眠优先使用微信小号绑定 iLink主号不建议长期挂机机器人。3. 功能限制不支持朋友圈、转账、红包、通讯录批量操作仅消息收发通道单个 iLink 授权绑定单一微信账号一套 Hermes 网关仅能登录一个微信号token 存在有效期长期离线后需要重新扫码授权。五、对比企业微信 WeCom Bot表格iLink Weixin个人微信WeCom 企业微信机器人面向私人个人微信账号企业组织内部群 / 客户群扫码一键授权零企业资质需要企业认证、后台自建应用私聊对话完整支持仅群聊 / 客户联系无私人对话本地 WSL 即可运行必须公网 Webhook 回调地址Hermes 一键配置无需后台操作手动填写 BotID、Secret、加密密钥六、Hermes 接入 iLink 完整排坑指南对应你当前界面二维码渲染失败No module named qrcodebash运行pip3 install qrcode -i https://pypi.tuna.tsinghua.edu.cn/simple安装后重新执行hermes gateway setup终端直接打印二维码不用复制网页链接。二维码链接打开空白 关闭 Windows/WSL 所有代理、VPNiLink 是腾讯国内服务无需翻墙。扫码成功但微信收不到回复执行hermes gateway status确认网关正在运行核对好友 / 群聊是否加入白名单重启网关hermes gateway restart。图像生成自动跳转 Nous 海外平台bash运行hermes setup在 Image Generation 步骤选择国内绘图服务商DeepSeek / 通义万相跳过 Nous 登录。七、优缺点总结优势唯一官方合规个人微信机器人通道封号风险远低于逆向方案本地部署、无需云服务器、内网穿透WSL Ubuntu22.04jammy完美兼容Hermes 深度适配一键扫码、白名单风控、后台挂机一体化完整支持图文 / 文件 / 语音流式 AI 回复体验原生。短板存在消息发送限流不适合超高并发群发场景仅支持消息收发无朋友圈、红包、转账等高级接口token 有有效期长期离线需要重新扫码。