Hermes Agent 接入微信教程（2026）：免公网 IP 扫码绑定个人微信与群聊 AI 助手配置
TL;DR： Hermes Agent 已原生支持个人微信，不用公网 IP、不用服务器，手机扫码就能接上。核心流程：
hermes gateway setup选 Weixin 扫码 → 设置私聊/群聊授权策略 →hermes gateway restart让配置生效 → 在微信里给 Hermes 发消息拿授权码或用/whitelist完成绑定。全程约 5 分钟。注意：走的是第三方接口，建议先用副号试水。
想在微信里直接用上 Hermes——查资料、写总结、整理群聊、做每日推送——这篇教程把全流程走一遍。四步当中，三步是复制粘贴命令，只有扫码那一步需要你动手机。
📚 本文目录（点击跳转）
- 一、准备工作：前置环境依赖与微信封号风控提示
- 二、安装 Python 网关依赖与更新 Hermes Agent
- 三、配置微信网关与扫码绑定（hermes gateway setup）
- 四、安全配置：设置私聊授权与微信群聊响应策略
- 五、重启网关服务与认领微信号（授权码输入）
- 六、全链路测试与微信端实用交互技巧
- Hermes 接入个人微信方案的优缺点分析
- 适合人群与适用场景
- 常见问题 FAQ（收不到消息/风控解绑排查）
- 相关教程
一、准备工作：前置环境依赖与微信封号风控提示
| 检查项 | 要求 | 怎么确认 |
|---|---|---|
| Hermes Agent | 已安装且能正常运行 | 终端里执行 hermes update 能跑起来；没装先看 Hermes 使用与安装教程 |
| Python | 3.10 或更高版本 | 终端执行 python --version |
| 微信号 | 一个能正常登录的个人微信，不是企业微信 | — |
WARNING
动手前必看风险提示：Hermes 接入微信走的是第三方接口（iLink Bot API），不属于微信官方开放能力。个人微信做自动化存在触发平台风控的可能，强烈建议先用不常用的副号测试，稳定运行后再决定是否更换。此外，请务必设置好白名单权限，避免陌生人随意触发导致调用异常。
二、安装 Python 网关依赖与更新 Hermes Agent
需要三个 Python 包和一次版本更新。每个都有用，别跳过：
# 网关通信与加密所需
pip install aiohttp cryptography
# 让二维码直接画在终端里，省得去日志里翻链接
pip install qrcode
# 微信接入是较新的能力，旧版本没有，必须更新
hermes update上面的命令在 Windows PowerShell、macOS、Linux 下通用。
TIP
依赖校验技巧：执行 pip show aiohttp cryptography qrcode，三项都能正确回显版本信息即说明安装成功。若后续报错提示缺少模块，通常是 pip 装到了系统的全局环境而非 Hermes 运行的虚拟环境，切换对应环境重新安装即可。
三、配置微信网关与扫码绑定（hermes gateway setup）
Hermes 提供了终端交互式配置，不用手写配置文件：
hermes gateway setup按提示走三步：
- 用方向键选中 Weixin / WeChat，回车
- 输入
Y确认 - Hermes 会向 iLink Bot API 发起请求，在终端里生成一张微信绑定二维码
然后用手机微信扫码。这个环节是秒级响应的，扫完你就把 Hermes 加进了微信。
扫码这一步做了什么
扫码建立的是你的微信和 Hermes 网关之间的通道，效果相当于把 Hermes 加成了一个微信联系人。
但这时你还用不了它：「谁能用、在哪些场景能用」还没定（第四步），配置也还没生效（第五步）。
TIP
扫码提示：二维码具有时效性，终端提示过期属于正常现象，重新运行 hermes gateway setup 生成新码即可。手机弹出确认登录提示时，点击允许完成接入。
四、安全配置：设置私聊授权与微信群聊响应策略
接线完成后，Hermes 会让你设置授权策略，也就是谁可以调用它、在什么地方可以调用它。
私聊授权
| 选项 | 含义 | 什么时候选 |
|---|---|---|
| DM Pairing Approval（推荐） | 陌生人首次私聊需要你手动批准；批准过的联系人之后直接通过 | 绝大多数个人用户 |
| Open | 任何人私聊都自动通过 | 你确实希望它对所有人开放，比如做公开服务 |
| Disable | 完全关闭私聊 | 只想在群里用，或暂时不想被私聊打扰 |
建议直接选 DM Pairing Approval。 已批准的联系人不受影响，该用还是照用；它挡住的只是陌生人的直接调用。
群聊授权
群聊默认是 Disable，建议保持默认。因为群聊一开，边界和私聊完全不同：
- 群里所有成员都能给 Hermes 发指令，不只是你
- 它会读到这个群里的消息内容
- 无关群的闲聊会持续消耗你的模型额度
所以正确的用法是：先保持关闭，等某个工作群或学习群确实需要了，再单独为那一个群开启。
策略设好了，但网关还在按旧配置运行，要重启才生效。
五、重启网关服务与认领微信号（授权码输入）
保存授权设置后，重启网关让策略生效：
hermes gateway restart重启成功后还有最后一步，认领你自己的微信号：
- 在微信里找到 Hermes，发送任意一条消息
- Hermes 会回复一个授权码
- 把这个授权码输入终端，完成绑定
绑定完成，你的微信号进入白名单。之后别人来私聊时，就按第四步设好的策略放行。
TIP
快捷入白名单方式：部分版本支持直接在微信中向 Hermes 发送 /whitelist 自助加入白名单，省去终端回填授权码的操作。但若对调用权限有严格安全要求，建议优先通过终端手动回填授权码更可控。
六、全链路测试与微信端实用交互技巧
绑定之后先别急着拉群，做一次最小验证：
- 在微信里给 Hermes 发一句普通的话，比如「你好」
- 收到正常回复，说明整条链路通了
想让状态更确定，在终端里看一眼网关：
hermes gateway status确认网关正在运行，就可以正常使用了。
1. 微信端实用操作与交互场景
Hermes 接入微信后，不仅支持常规问答，还支持丰富的 Agent 能力：
- 日常私聊提问与多模态分析：你可以直接发送文本请求，也可以直接发送包含表格、代码或图表的截图，让它提取文本或分析关键数据；
- 群聊定向响应（避免空耗 Token）：在开启授权的群里，建议全员通过
@你的助手微信号 + 任务指令的方式进行交互。如果群内闲聊过多，非@的对话不会频繁唤醒模型，有效节省 API 费用； - 微信端控制指令速查：
/whitelist：管理员或好友快捷认领白名单；/clear或/reset：清空当前会话的上下文记忆，开启新话题；/help：获取当前支持的微信交互命令帮助。
IMPORTANT
网关持续运行须知：Hermes 微信网关需要进程持续在线才能实时收发消息。若在云服务器或本地长期运行，推荐使用 tmux、nohup 或后台守护进程方式保持 hermes gateway 常驻，避免关闭命令行窗口后机器人断线。
回头看，整条链路是三个环节，缺一个都用不了：
| 环节 | 对应操作 | 作用 |
|---|---|---|
| 接线 | hermes gateway setup + 手机扫码 | 打通微信与网关之间的通道 |
| 定规则 | 私聊 / 群聊授权策略 | 决定谁能用、在哪些场景用 |
| 生效并认领 | hermes gateway restart + 输入授权码 | 让配置生效，并把你加入白名单 |
发出去了却没回复？跳到下面的常见问题按症状排查。
Hermes 接入个人微信方案的优缺点分析
优点
- 门槛低：不用公网 IP、不用买服务器，手机扫码就接上了
- 入口现成：微信是你本来就在用的 App，不用再学一个新界面
- 能力完整：私聊、群聊、图片、视频、文件、语音都支持
- 策略可控：私聊和群聊分开授权，陌生人默认进不来
- 跑在自己机器上：Hermes 是本地服务，不是把对话交给一个云端机器人
不足
- 有账号风险：走的是第三方接口，个人微信自动化可能触发风控，别拿主号直接上
- 要一直开着：网关得持续运行才收得到消息，本机关机或休眠就断了
- 群聊边界较粗：群聊开关按群控制，开一个群就是把这个群整体交给它，群内成员都能给它发指令
- 命令随版本变动：接入方式是 Hermes 较新的能力，子命令可能调整，以
hermes gateway --help的输出为准
适合人群与适用场景
适合你，如果：
- 已经在用 Hermes Agent，想把它接到微信这个天天打开的入口
- 想要一个不依赖公网 IP、不用额外服务器的个人微信 AI 助手
- 能接受命令行操作，也愿意先用副号试水
- 有固定的工作群或项目群，想让助手帮忙整理要点、提取待办
不适合你，如果：
- 想用在企业微信或对外客服场景：这是第三方接口，别用于生产环境
- 完全不想碰命令行
- 只有一个微信号，且不能承受任何风控风险
常见问题 FAQ（收不到消息/风控解绑排查）
Hermes 接入微信安全吗？会不会封号？
扫码后没反应，或者提示二维码过期怎么办？
hermes gateway restart 失败怎么办？
在微信里给 Hermes 发消息，收不到回复？
群聊里为什么只有我能用，别人发消息它不理？
绑定之后可以解绑吗？
支持企业微信吗？
Hermes 接入微信后能做什么？
相关教程
- Hermes 安装与使用教程 — 还没装 Hermes？从 Windows 一键安装到模型配置的完整流程
- Hermes 教程专栏 — 模型版本、上手流程和这类接入教程都在这里
- CC Switch 接入 Claude Code 教程 — 如果你还想把别的模型接到自己的工作流里
- ChatGPT 订阅方案对比 — 挑一个模型来驱动你的微信助手