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

一、背景：为什么从 OpenClaw 转向 Hermes

在做"AI + 运维 + 知识沉淀"这套体系时，我最开始用的是多 Agent 调度。

一开始体验不错，尤其在：

多 Agent 分工（AI资讯 / 写作 / 分析）
Telegram / 微信等多渠道接入
自动化任务执行

但随着我开始往"知识沉淀 + 内容生产"方向走，逐渐发现它的局限：

OpenClaw 的问题

更偏"调度系统"，而不是"内容生产系统"
对本地知识库支持较弱
Agent 需要单独设计和维护
更适合自动化执行，不适合长期知识积累

为什么选择 Hermes

相比之下，Hermes 更符合我的需求：

✅ 更像"个人 AI 助手"
✅ 原生支持文件 / 上下文 / 命令
✅ 更适合知识库生成
✅ 支持 OpenAI 兼容接口（如阿里云 Coding Plan）
✅ 支持微信接入

所以最终我的架构思路变成：

text 复制代码

OpenClaw → 调度系统
Hermes → 内容与知识沉淀

二、安装 Hermes Agent

1. 一键安装

bash 复制代码

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes

2. 验证是否成功

text 复制代码

你好

如果能正常回复，说明 Hermes 已经安装成功。

三、第一个坑：自动继承 OpenClaw 配置

现象

刚安装完 Hermes，我发现：

模型"看起来能用"
但行为异常
配置不受控

原因

Hermes 会读取环境变量：

bash 复制代码

~/.bashrc
~/.env
系统环境变量

而我之前在 OpenClaw 中配置过：

bash 复制代码

OPENAI_API_KEY
OPENAI_BASE_URL

👉 Hermes 自动继承了这些配置

解决方法

彻底清理：

bash 复制代码

rm -rf ~/.hermes
rm -rf ~/.config/hermes
rm -rf ~/.cache/hermes

然后：

bash 复制代码

nano ~/.bashrc

删除：

bash 复制代码

OPENAI_API_KEY=
OPENAI_BASE_URL=

更干净的方案（推荐）

bash 复制代码

sudo adduser hermes
su - hermes

👉 使用独立用户运行 Hermes，彻底隔离环境

四、第二个坑：阿里云 Coding Plan API 配置

我使用的是阿里云 Coding Plan（通义千问）。

一开始我用的是：

text 复制代码

Custom endpoint（手动填 URL）

结果疯狂报错：

400 Bad Request
404 Not Found
模型不存在

正确方式（关键）

👉 不要用 Custom Endpoint

直接选择 Hermes 内置：

text 复制代码

Alibaba Cloud / DashScope (Coding)

正确配置步骤

bash 复制代码

hermes model

选择：

text 复制代码

Alibaba Cloud / DashScope (Coding)

输入：

text 复制代码

API Key: sk-sp-xxxx

模型选择

最终验证可用：

text 复制代码

qwen3.5-plus

为什么之前失败

❌ 错误方式

text 复制代码

Custom endpoint + coding.dashscope.aliyuncs.com

问题：

Hermes 请求结构不完全兼容
Coding Plan 有调用限制

❌ 错误模型

text 复制代码

kimi-k2.5
qwen3-max-xxxx

问题：

不一定开放权限
兼容性问题

正确组合

text 复制代码

Provider: Alibaba Cloud (Coding)
Model: qwen3.5-plus
Key: sk-sp-xxxx

五、第三个坑：本地能用，但微信不回

现象

text 复制代码

CLI：正常回复
微信：完全没反应

正确排查思路（非常重要）

按层判断：

text 复制代码

1. Hermes 是否正常 → CLI OK
2. 模型是否正常 → CLI OK
3. 微信通道是否正常 → 已连接

👉 问题一定在"网关或权限"

六、微信接入 Hermes

配置步骤

bash 复制代码

hermes channels

选择：

text 复制代码

Weixin (WeChat)

扫码登录。

成功标志

text 复制代码

account_id=xxx@im.bot
DM pairing enabled

七、第四个坑：微信不回（最终核心问题）

现象

微信发送消息无回复
Hermes 正常运行
模型正常

关键操作：让 Hermes 自检

我直接问：

text 复制代码

请帮我检查微信为什么不回复

Hermes 返回：

text 复制代码

Unauthorized user

问题本质

text 复制代码

权限问题（pairing机制）

默认配置：

bash 复制代码

WEIXIN_ALLOW_ALL_USERS=false
WEIXIN_DM_POLICY=pairing

👉 未授权用户不能使用

解决方法

bash 复制代码

hermes pairing list

看到：

text 复制代码

Pending Pairing Requests:
weixin  CODE  xxx@im.wechat

批准：

bash 复制代码

hermes pairing approve weixin CODE

验证

微信发送：

text 复制代码

测试

👉 成功回复 ✅

快速解决（测试用）

bash 复制代码

nano ~/.hermes/.env

修改：

bash 复制代码

WEIXIN_ALLOW_ALL_USERS=true

然后：

bash 复制代码

hermes gateway restart

八、第五个坑：进程问题（微信断联）

现象

text 复制代码

微信突然不回

原因

text 复制代码

关闭终端 → Hermes 停止

解决

使用：

systemd（推荐）
tmux / screen

九、完整排错思路（核心经验）

以后遇到问题，按这个顺序：

text 复制代码

1. CLI 是否正常 → Hermes 本体
2. 模型是否正常 → API问题
3. 微信是否连接 → channels状态
4. 是否收到消息 → debug日志
5. 是否被拦截 → pairing机制

十、最终稳定架构

当前稳定运行：

text 复制代码

微信
 ↓
Hermes
 ↓
阿里云 Coding Plan（qwen3.5-plus）

后续优化方向：

text 复制代码

微信 → OpenClaw → Hermes → 模型

十一、总结

这次踩坑最大的感受：

text 复制代码

Hermes 本身不复杂，复杂的是：
环境变量 + API配置 + 通道权限

最关键三点

不要用 Custom Endpoint 接 Coding Plan
必须用 Hermes 内置 Alibaba Cloud provider
微信不回，优先看权限（pairing），不是模型

最优安装路径

text 复制代码

1. 安装 Hermes
2. 配置 Alibaba Cloud provider
3. 选择 qwen3.5-plus
4. CLI 验证
5. 接入微信
6. 配对授权

最后一条经验

text 复制代码

微信不回 ≠ 模型问题  
90% 是权限或通道问题

这套流程走通之后，Hermes 就可以稳定作为一个：

text 复制代码

可通过微信随时对话的 AI 助手

用于后续知识沉淀、运维分析等场景。

复制代码