GPTPRO

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
  1. 选中 Weixin / WeChat 选项
  2. 输入 Y 确认
  3. Hermes 会自动请求 iLink Bot API 并生成微信绑定二维码

使用手机微信扫码添加即可(过程秒级响应)。

配置界面示意


第三步:授权设置(私聊 & 群聊)

配置完成后,系统会让你设置授权策略:

私聊授权(推荐设置)

  • DM Pairing Approval(强烈推荐):陌生人首次私聊需手动批准,已批准联系人直接通过。既安全又实用,适合绝大多数个人用户。
  • Open:任何人私聊均自动通过(适合完全公开场景)。
  • Disable:完全关闭私聊。

群聊授权(推荐设置)

  • 默认保持 Disable,避免被无关群消息刷屏。
  • 后续可在 Hermes 中对特定工作群/学习群手动开启。

授权设置界面


第四步:重启网关并绑定

保存授权设置后,重启网关:

bash
hermes gateway restart

重启成功后:

  1. 在微信中找到 Hermes 并发送任意消息
  2. Hermes 会回复授权码
  3. 在终端输入授权码完成绑定(或直接在微信发送 /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 实用技巧,欢迎持续关注!

相关文章