私聊配对审批
未知用户私聊时生成 pairing code，由管理员在 Hermes 中批准。
№ 024INTEGRATION能力 / IM接入 / 微信 · Weixin
把微信接到
Hermes。
微信接入不是企业自建应用，也不需要公网回调。内核通过 Tencent iLink Bot API 进行扫码绑定，并用 getupdates 长轮询接收消息。
✓环境检查依赖与 Gateway
2扫码绑定微信确认 iLink bot
3访问策略私聊、群聊与 home
4保存验证重启并检查 long-poll
[ STEP 01 ]
运行环境检查
依赖可用
通过aiohttp 与 cryptography 已可导入。Gateway 可启动当前 profile 的 managed runtime 可重启。
通过账号未绑定尚未写入
待扫码WEIXIN_ACCOUNT_ID。Token 锁未检测扫码成功后检查是否已有其他 Gateway 占用。
待测 [ STEP 02 ]
微信扫码绑定 iLink bot
ILINK QR LOGIN
请使用微信手机端扫码
扫码后需要在手机端确认。成功后内核返回 account_id、bot_token、base_url 与 user_id，前端只展示脱敏摘要。
状态等待扫码qrcode_status: wait
[ STEP 03 ]
凭据与高级连接配置
Account ID
iLink bot account id，扫码成功后写入。
Bot Token
敏感凭据，仅保存到当前 profile。
iLink API
默认不需要修改。
CDN Base
媒体加密上传与下载使用。
[ STEP 04 ]
访问策略
指定用户 ID
只允许 WEIXIN_ALLOWED_USERS 中的微信用户。
允许所有私聊
试用最快，但任何能发起私聊的人都可唤起 Agent。
群聊策略
iLink bot 身份通常收不到普通微信群事件。
禁用群聊（推荐）
Home Channel
用于 cron 和通知，可先用扫码返回 user_id。
[ SAVE ]
保存并验证 long-poll
凭据已保存
完成WEIXIN_TOKEN 已脱敏写入 .env。等待 Gateway 重启重启后启动
30sweixin-poll 任务。私聊消息测试向 iLink bot 发送“你好 Hermes”。
待测媒体上传测试发送图片或文件，确认 AES CDN 流程正常。
可选 [ REVIEW ]
将写入的配置摘要
| 产品项 | 将写入的配置 | 状态 |
|---|---|---|
| 账号 ID | WEIXIN_ACCOUNT_ID=a5ace6fd••••@im.bot | 扫码返回 |
| 认证 Token | WEIXIN_TOKEN=•••••••• | 敏感 |
| 私聊策略 | WEIXIN_DM_POLICY=pairing | 推荐 |
| 允许所有用户 | WEIXIN_ALLOW_ALL_USERS=false | 安全默认 |
| 群聊策略 | WEIXIN_GROUP_POLICY=disabled | 推荐 |