第一步：3 分钟完成连接
- 安装依赖
pip install aiohttp cryptography- 运行配置向导
hermes gateway setup- 选择 Weixin 选项
- 扫描微信二维码（iLink Bot 登录）
- 启动网关
hermes gateway start- 在微信发送消息测试连接
连接成功后会提示：微信连接成功，account_id=your-account-id
开机自动运行（Windows）
无需终端，服务常驻后台：
- 创建批处理文件 hermes-auto.bat
@echo off
cd C:\Users\fishi\AppData\Local\hermes
start /B hermes gateway start/B 参数：后台运行，不显示窗口
- 添加开机启动
- 按 Win + R
- 输入 shell:startup
- 把 hermes-auto.bat 的快捷方式放进去
- 验证
- 重启电脑
- 检查微信是否能收到消息
替代方案：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安全策略：
- 首次连接建议使用私有测试
- 团队使用需设置允许列表
- 群组聊天默认禁用（推荐）
常见问题
连接失败：
- 检查网络连接
- 防火墙允许 WebSocket
- 重启网关：hermes gateway restart
开机没启动：
- 检查启动文件夹是否有批处理文件
- 确认批处理路径正确
- 手动运行 .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
评论0