第一步：3 分钟完成连接

1. 安装依赖 

   pip install aiohttp cryptography

2. 运行配置向导 

   hermes gateway setup
  • 选择 Weixin 选项
  • 扫描微信二维码（iLink Bot 登录）

3. 启动网关 

   hermes gateway start
  • 在微信发送消息测试连接

连接成功后会提示：微信连接成功，account_id=your-account-id

---

开机自动运行（Windows）

无需终端，服务常驻后台：

1. 创建批处理文件 hermes-auto.bat 

   @echo off
   cd C:\Users\fishi\AppData\Local\hermes
   start /B hermes gateway start
> /B 参数：后台运行，不显示窗口

2. 添加开机启动

  • 按 Win + R
  • 输入 shell:startup
  • 把 hermes-auto.bat 的快捷方式放进去

3. 验证

  • 重启电脑
  • 检查微信是否能收到消息

替代方案：Windows 服务 

npm install -g windows-service
hermes-service install
hermes-service start

---

使用场景

日常查询（打开微信就能用）：

  • 问天气：今日天气
  • 查新闻：新闻简报
  • 写文档：写博客，主题：...

技术任务：

  • 分析文件：发送 PDF/Excel 文件
  • 运行代码：执行 python 脚本分析数据
  • 自动化：定时任务配置

---

配置说明

环境配置（可选）： 

export WEIXIN_HOME_CHANNEL_NAME="Home"
export WEIXIN_ALLOW_ALL_USERS=true

安全策略：

  • 首次连接建议使用私有测试
  • 团队使用需设置允许列表
  • 群组聊天默认禁用（推荐）

---

常见问题

连接失败： 1. 检查网络连接 2. 防火墙允许 WebSocket 3. 重启网关：hermes gateway restart

开机没启动： 1. 检查启动文件夹是否有批处理文件 2. 确认批处理路径正确 3. 手动运行 .bat 文件看报错

微信提示安全警告：首次绑定正常，点击确认即可

无法加入群组：iLink Bot 仅支持私聊，不支持个人微信拉入普通群组

---

技术要点

  • 连接机制：WebSocket 长连接 + Long-poll
  • 数据安全：本地配置，AES-128-ECB 加密 CDN
  • 消息特性：Markdown 格式支持、消息分块、输入指示器
  • 性能优化：消息队列缓冲、智能缓存、重复消息去重

---

参考资源

  • 官方文档：https://hermes-agent.nousresearch.com/docs/user-guide/messaging/weixin
  • GitHub：https://github.com/NousResearch/hermes-agent