如何从 0 搭建 Hermes Agent，并打通微信的（完整踩坑与排错记录）

一、背景为什么从 OpenClaw 转向 Hermes在做“AI 运维 知识沉淀”这套体系时我最开始用的是多 Agent 调度。一开始体验不错尤其在多 Agent 分工AI资讯 / 写作 / 分析Telegram / 微信等多渠道接入自动化任务执行但随着我开始往“知识沉淀 内容生产”方向走逐渐发现它的局限OpenClaw 的问题更偏“调度系统”而不是“内容生产系统”对本地知识库支持较弱Agent 需要单独设计和维护更适合自动化执行不适合长期知识积累为什么选择 Hermes相比之下Hermes 更符合我的需求✅ 更像“个人 AI 助手”✅ 原生支持文件 / 上下文 / 命令✅ 更适合知识库生成✅ 支持 OpenAI 兼容接口如阿里云 Coding Plan✅ 支持微信接入所以最终我的架构思路变成OpenClaw → 调度系统 Hermes → 内容与知识沉淀二、安装 Hermes Agent1. 一键安装curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.bashrc hermes2. 验证是否成功你好如果能正常回复说明 Hermes 已经安装成功。三、第一个坑自动继承 OpenClaw 配置现象刚安装完 Hermes我发现模型“看起来能用”但行为异常配置不受控原因Hermes 会读取环境变量~/.bashrc ~/.env 系统环境变量而我之前在 OpenClaw 中配置过OPENAI_API_KEY OPENAI_BASE_URL Hermes 自动继承了这些配置解决方法彻底清理rm -rf ~/.hermes rm -rf ~/.config/hermes rm -rf ~/.cache/hermes然后nano ~/.bashrc删除OPENAI_API_KEY OPENAI_BASE_URL更干净的方案推荐sudo adduser hermes su - hermes 使用独立用户运行 Hermes彻底隔离环境四、第二个坑阿里云 Coding Plan API 配置我使用的是阿里云 Coding Plan通义千问。一开始我用的是Custom endpoint手动填 URL结果疯狂报错400 Bad Request404 Not Found模型不存在正确方式关键 不要用 Custom Endpoint直接选择 Hermes 内置Alibaba Cloud / DashScope (Coding)正确配置步骤hermes model选择Alibaba Cloud / DashScope (Coding)输入API Key: sk-sp-xxxx模型选择最终验证可用qwen3.5-plus为什么之前失败❌ 错误方式Custom endpoint coding.dashscope.aliyuncs.com问题Hermes 请求结构不完全兼容Coding Plan 有调用限制❌ 错误模型kimi-k2.5 qwen3-max-xxxx问题不一定开放权限兼容性问题正确组合Provider: Alibaba Cloud (Coding) Model: qwen3.5-plus Key: sk-sp-xxxx五、第三个坑本地能用但微信不回现象CLI正常回复 微信完全没反应正确排查思路非常重要按层判断1. Hermes 是否正常 → CLI OK 2. 模型是否正常 → CLI OK 3. 微信通道是否正常 → 已连接 问题一定在“网关或权限”六、微信接入 Hermes配置步骤hermes channels选择Weixin (WeChat)扫码登录。成功标志account_idxxxim.bot DM pairing enabled七、第四个坑微信不回最终核心问题现象微信发送消息无回复Hermes 正常运行模型正常关键操作让 Hermes 自检我直接问请帮我检查微信为什么不回复Hermes 返回网关未启动和用户未授权问题本质权限问题pairing机制默认配置WEIXIN_ALLOW_ALL_USERSfalse WEIXIN_DM_POLICYpairing 未授权用户不能使用解决方法hermes pairing list看到Pending Pairing Requests: weixin CODE xxxim.wechat批准hermes pairing approve weixin CODE验证微信发送测试 成功回复 ✅快速解决测试用nano ~/.hermes/.env修改WEIXIN_ALLOW_ALL_USERStrue然后hermes gateway restart八、第五个坑进程问题微信断联现象微信突然不回原因关闭终端 → Hermes 停止解决使用systemd推荐tmux / screen九、完整排错思路核心经验以后遇到问题按这个顺序1. CLI 是否正常 → Hermes 本体 2. 模型是否正常 → API问题 3. 微信是否连接 → channels状态 4. 是否收到消息 → debug日志 5. 是否被拦截 → pairing机制十、最终稳定架构当前稳定运行微信 ↓ Hermes ↓ 阿里云 Coding Planqwen3.5-plus后续优化方向微信 → OpenClaw → Hermes → 模型十一、总结这次踩坑最大的感受Hermes 本身不复杂复杂的是 环境变量 API配置 通道权限最关键三点不要用 Custom Endpoint 接 Coding Plan必须用 Hermes 内置 Alibaba Cloud provider微信不回优先看权限pairing不是模型最优安装路径1. 安装 Hermes 2. 配置 Alibaba Cloud provider 3. 选择 qwen3.5-plus 4. CLI 验证 5. 接入微信 6. 配对授权最后一条经验微信不回 ≠ 模型问题 90% 是权限或通道问题这套流程走通之后Hermes 就可以稳定作为一个可通过微信随时对话的 AI 助手用于后续知识沉淀、运维分析等场景。