Hermes 微信集成：认证机制、配置字段与接入流程
Hermes Agent 近期新增了微信（WeChat）渠道集成支持。本文梳理其认证机制、配置字段、接入流程及主要约束，供需要将 Hermes 接入微信的用户参考。
认证机制
微信集成采用 iLink Bot API 的二维码扫码登录方式，无需 Webhook，通过长轮询（Long Polling）接收消息。认证流程在本地完成，凭据自动保存到 ~/.hermes/weixin/accounts/，后续无需重复扫码。
配置字段
| 字段 | 必填 | 说明 |
|---|---|---|
WEIXIN_ACCOUNT_ID |
是 | iLink Bot 账号 ID，扫码登录后自动获取 |
WEIXIN_TOKEN |
是 | iLink Bot 鉴权 token |
WEIXIN_BASE_URL |
否 | API 端点，留空使用 iLink 默认服务地址 |
WEIXIN_DM_POLICY |
否 | 私聊策略，见下方说明 |
WEIXIN_GROUP_POLICY |
否 | 群消息策略，见下方说明 |
访问策略
私聊（DM）策略（WEIXIN_DM_POLICY）：
open：接受任何人的私聊allowlist：仅接受白名单用户disabled：关闭私聊pairing：需要配对确认
群消息策略（WEIXIN_GROUP_POLICY）：
open：接受所有群的消息allowlist：仅接受白名单群disabled：关闭群消息（个人账号默认值）
接入流程
hermes gateway setup执行后选择 Weixin，按提示用微信手机 App 扫描终端中显示的二维码，在手机上确认登录。凭据由 hermes 自动保存，无需手动配置 token 字段。
媒体能力
适配器原生支持图片、视频、文件和语音消息。CDN 传输使用 AES-128-ECB 加密/解密，由 hermes 在内部处理，对使用方透明。
主要约束
- 单实例限制：同一个 token 在同一时刻只能被一个 hermes 实例使用。多实例接入需要对应多个独立账号。
- 群消息默认关闭：个人微信账号的
WEIXIN_GROUP_POLICY默认值为disabled，需要显式设置才能接收群消息。 - 消息自动分段：超过 4000 字的回复会按语义边界自动拆分发送。
- 去重窗口：5 分钟内的重复消息会被过滤，防止重复处理。
Member discussion