Hermes 接入微信教程:5分钟丝滑上手个人微信(Hermes Agent 原生支持)
Hermes Agent 正式原生支持个人微信!无需公网 IP、无需复杂配置,微信扫码即可完成绑定。私聊、群聊、图片、视频、文件、语音消息全部支持,长轮询直连,体验极致丝滑。
搜索关键词 Hermes 接入微信 的朋友们,这篇保姆级教程专为快速上手打造,前后操作不到 5 分钟。无论你是想用 Hermes 查资料、设提醒、整理群聊,还是做每日推送,都能轻松实现。
目录
前置条件
- 已安装 Hermes Agent(未安装请参考 Hermes 官方文档 完成安装)
- Python 3.10 或更高版本
- 一个可正常登录的个人微信号(非企业微信)
第一步:更新 & 安装依赖
bash
# 安装必要 Python 包
pip install aiohttp cryptography
# 可选:终端二维码展示(强烈建议安装)
pip install qrcode
# 更新 Hermes 到最新版本(支持微信的关键)
hermes update第二步:交互配置微信网关
推荐使用终端交互式配置,操作最简单:
bash
hermes gateway setup- 选中 Weixin / WeChat 选项
- 输入
Y确认 - Hermes 会自动请求 iLink Bot API 并生成微信绑定二维码
使用手机微信扫码添加即可(过程秒级响应)。

第三步:授权设置(私聊 & 群聊)
配置完成后,系统会让你设置授权策略:
私聊授权(推荐设置)
- DM Pairing Approval(强烈推荐):陌生人首次私聊需手动批准,已批准联系人直接通过。既安全又实用,适合绝大多数个人用户。
- Open:任何人私聊均自动通过(适合完全公开场景)。
- Disable:完全关闭私聊。
群聊授权(推荐设置)
- 默认保持 Disable,避免被无关群消息刷屏。
- 后续可在 Hermes 中对特定工作群/学习群手动开启。

第四步:重启网关并绑定
保存授权设置后,重启网关:
bash
hermes gateway restart重启成功后:
- 在微信中找到 Hermes 并发送任意消息
- Hermes 会回复授权码
- 在终端输入授权码完成绑定(或直接在微信发送
/whitelist自动加入白名单)

常见问题解答(FAQ)
Q:扫码后没有反应怎么办?
A:确认手机网络正常,重新执行 hermes gateway setup 生成新二维码。
Q:二维码过期了?
A:终端会提示过期,直接重新运行 hermes gateway setup 刷新即可。
Q:网关重启失败?
A:先执行 hermes gateway status 查看状态。若端口冲突,可在配置文件中修改端口。
Q:微信消息收不到?
A:检查授权设置——私聊是否设为 Disable,或群聊是否未单独开启该群。
Hermes 接入微信后能做什么
- 私聊智能助手:随时让 Hermes 查资料、写总结、翻译、生成创意
- 群聊助手:拉进工作群/项目群,自动整理会议要点、提取待办事项
- 自动化推送:配合定时任务,每天推送天气、日程、RSS 资讯、股票提醒等
- 多媒体处理:直接发送图片、语音、文件给 Hermes 进行分析和处理
Hermes 接入微信 极大降低了使用门槛,让 AI 助手真正融入日常沟通场景。
Happy Hacking 🎉
如果你在 Hermes 接入微信 过程中遇到其他问题,欢迎在评论区留言,我会持续更新这篇教程。
更多 Hermes 实用技巧,欢迎持续关注!