前言
最近在部署 Hermes Agent，通过 iLink（ClawBot）扫码接入微信，配置向导里看到了群聊白名单选项，一开始以为可以直接把机器人拉进微信群，折腾半天后才发现：iLink Bot 这套通道，对普通微信群有硬性限制。本文整理完整配置逻辑、限制说明与备选方案。
核心结论先行： Hermes 通过 iLink 扫码登录得到的是
xxx@im.bot机器人身份，不是你的个人微信账号。这个机器人账号无法被邀请加入普通微信群，iLink 网关也不会向该机器人推送普通微信群的消息事件。群聊相关配置仅为预留开关，绝大多数场景下不会生效。稳定可用的通道只有私聊 DM。
一、Hermes 微信通道两套授权策略（配置向导原文翻译）
1. 私聊 DM 授权策略（Weixin DM Policy）
How should direct messages be authorized? 方向键上下切换，回车 / 空格选中，ESC 取消
- Use DM pairing approval (recommended)【推荐：私聊配对审批】 陌生用户发起私聊时，会触发配对请求，你在终端执行
hermes pairing approve批准后，对方才可以和机器人对话。安全性最高，防止陌生人骚扰机器人。 - Allow all direct messages【允许全部私聊消息】 任何人都可以直接给机器人发私信，无需审批，风险较高。
- Only allow listed user IDs【仅允许名单内用户 ID】 只接收预先填写白名单内用户 ID 发来的私聊。
- Disable direct messages【禁用私聊】 机器人完全不接收任何私聊消息。
推荐选型：Use DM pairing approval，生产环境首选。
2. 群聊 Group 策略（Weixin Group Policy）
重点：下方所有群选项，都有前置条件：iLink 网关必须能够为你的账号类型推送群事件，否则无论怎么设置都无效。
- Disable group chats (recommended)【推荐：禁用群聊】 忽略全部群消息，官方默认推荐选项。
- Allow all group chats【允许全部群聊】 只要 iLink 可以投递群事件，所有群消息都会交给机器人（iLink Bot 基本无法生效）。
- Only allow listed group chat IDs【仅允许名单内群聊 ID】 仅接收白名单内填写的群 ID 消息，多个群 ID 英文逗号分隔；⚠️ 填写的是群聊 ID，不是成员用户 ID。
二、关键问题：微信如何获取 group chat ID？
- 普通手机微信客户端，没有 UI 界面可以直接查看群 ID
- 只有当 iLink 机器人身份成功进入 iLink 体系内支持的群，且群内产生消息时，Hermes Debug 日志的消息 JSON payload 中才会出现
chat_id/opengid，这才是配置里需要填写的 group chat ID。 - 普通微信群，哪怕你拿到逆向出来的群 ID，填入配置也不会生效。因为 iLink 不会推送普通微信群事件给
@im.bot机器人。
一句话：拿到群 ID 也没用，iLink bot 无法进普通微信群。
三、为什么 iLink Bot 不能加入普通微信群？
扫码登录时，你的个人微信仅用于确认登录身份；真正接收消息的是独立的 xxx@im.bot 机器人账号，二者不是同一个主体：
- 普通微信群无法通过微信「邀请好友」的方式，添加
@im.bot这类机器人账号； - 即便有其他方式尝试加入，iLink 网关不会投递普通微信群的消息事件给 bot；
- 配置向导中的群聊选项只是预留功能，iLink Bot 场景下属于无效配置项。
注意：你在微信群 @你的个人微信，不等于 @机器人，群消息不会转发到 Hermes。
四、想要群内机器人，两条可行方案
✅ 方案 A：Hermes 接入【企业微信 WeCom】（推荐需要群聊场景）
Hermes 原生支持企业微信适配器。企业微信机器人应用可以正常加入企业微信群，接收群消息、@触发，群聊白名单策略真实生效。 限制：群成员需要为企业微信联系人。
⚠️ 方案 B：逆向个人微信机器人（不推荐）
基于协议逆向的个人微信机器人，可以加入普通微信群，但存在封号风险，不属于 iLink / Hermes 官方通道。
五、最终推荐配置（iLink Bot 标准生产配置）
- 私聊 DM 策略：
Use DM pairing approval (recommended) - 群聊策略：
Disable group chats (recommended)
这套组合，是 Hermes+iLink 唯一稳定、官方推荐的部署方式，仅使用私聊 DM 配对模式。
六、常见踩坑清单
- ❌ 误区：扫码登录 = 把自己微信账号交给脚本 ✅ 事实：扫码只是授权，bot 是独立
@im.bot身份，不是你的个人微信号。 - ❌ 误区：配置好群白名单，机器人就能收群消息 ✅ 事实：iLink Bot 不投递普通微信群事件，配置无效。
- ❌ 误区：手机微信里找群 ID，填入配置即可 ✅ 事实：普通微信群没有可用的 group chat ID 给 iLink bot 使用。
结语
Hermes iLink Bot 是一套以私聊为核心的 AI Agent 通道，不要对群聊能力抱有期待。如果你的业务场景需要群内对话，优先切换到企业微信 WeCom 适配器，避免在 iLink 个人微信通道上浪费大量时间调试群聊配置。
