news 2026/4/18 8:01:28

如何从 0 搭建 Hermes Agent,并打通微信的(完整踩坑与排错记录)

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何从 0 搭建 Hermes Agent,并打通微信的(完整踩坑与排错记录)

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

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

一开始体验不错,尤其在:

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

但随着我开始往“知识沉淀 + 内容生产”方向走,逐渐发现它的局限:

OpenClaw 的问题

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

为什么选择 Hermes

相比之下,Hermes 更符合我的需求:

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

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

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

二、安装 Hermes Agent

1. 一键安装

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

2. 验证是否成功

你好

如果能正常回复,说明 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 Request
  • 404 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_id=xxx@im.bot DM pairing enabled

七、第四个坑:微信不回(最终核心问题)

现象

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

关键操作:让 Hermes 自检

我直接问:

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

Hermes 返回:

网关未启动和用户未授权

问题本质

权限问题(pairing机制)

默认配置:

WEIXIN_ALLOW_ALL_USERS=false WEIXIN_DM_POLICY=pairing

👉 未授权用户不能使用


解决方法

hermes pairing list

看到:

Pending Pairing Requests: weixin CODE xxx@im.wechat

批准:

hermes pairing approve weixin CODE

验证

微信发送:

测试

👉 成功回复 ✅


快速解决(测试用)

nano ~/.hermes/.env

修改:

WEIXIN_ALLOW_ALL_USERS=true

然后:

hermes gateway restart

八、第五个坑:进程问题(微信断联)

现象

微信突然不回

原因

关闭终端 → Hermes 停止

解决

使用:

  • systemd(推荐)
  • tmux / screen

九、完整排错思路(核心经验)

以后遇到问题,按这个顺序:

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

十、最终稳定架构

当前稳定运行:

微信 ↓ Hermes ↓ 阿里云 Coding Plan(qwen3.5-plus)

后续优化方向:

微信 → OpenClaw → Hermes → 模型

十一、总结

这次踩坑最大的感受:

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

最关键三点

  1. 不要用 Custom Endpoint 接 Coding Plan
  2. 必须用 Hermes 内置 Alibaba Cloud provider
  3. 微信不回,优先看权限(pairing),不是模型

最优安装路径

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

最后一条经验

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

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

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

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

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/18 7:58:25

Windows Cleaner:三步彻底解决C盘爆红问题,让电脑重获新生!

Windows Cleaner:三步彻底解决C盘爆红问题,让电脑重获新生! 【免费下载链接】WindowsCleaner Windows Cleaner——专治C盘爆红及各种不服! 项目地址: https://gitcode.com/gh_mirrors/wi/WindowsCleaner 你的Windows电脑是…

作者头像 李华
网站建设 2026/4/18 7:58:23

智能代码生成在团队中落地失败的7个隐性陷阱(92%团队踩过第4个)

第一章:智能代码生成在团队中的落地实践 2026奇点智能技术大会(https://ml-summit.org) 智能代码生成已从实验性工具演进为支撑日常研发的关键基础设施。在中型以上工程团队中,其价值不再局限于单点提效,而在于重构协作范式——将重复性编码…

作者头像 李华
网站建设 2026/4/18 7:58:23

DIY USB2.0拓展坞:从原理图到PCB布局全解析

1. USB2.0拓展坞的核心原理 USB2.0拓展坞本质上是一个信号中继和电源分配设备。它的核心功能是通过主控芯片将单个USB接口扩展为多个接口,同时确保信号完整性和供电稳定性。理解这个基本原理是DIY的第一步。 USB2.0标准支持480Mbps的理论传输速率,实际应…

作者头像 李华
网站建设 2026/4/18 7:56:36

从零部署VideoAgentTrek-ScreenFilter:Ubuntu系统配置与Docker容器化指南

从零部署VideoAgentTrek-ScreenFilter:Ubuntu系统配置与Docker容器化指南 最近在折腾一些视频内容智能处理的项目,发现了一个挺有意思的工具叫VideoAgentTrek-ScreenFilter。简单来说,它能帮你自动分析视频,识别并处理屏幕上的特…

作者头像 李华