前两天刷 GitHub Trending,一个叫 Hermes Agent 的项目两周冲到 23k star。
我当时的反应跟大多数人一样:又一个 OpenClaw 仿品?
直到我自己动手装了一遍。
整个过程出乎意料地简单——先装 Claude Code,再用 Claude Code 帮我装 Hermes Agent,全程五分钟,四条命令搞定。 中间甚至不需要手动改配置文件,Claude 帮你全部搞定。
这篇文章就是完整的安装实录。你跟着做,五分钟后就有一个跑在你服务器上的 AI Agent,还能直接在 Telegram 上跟它对话。
先说 Hermes Agent 是什么
Hermes Agent 是 Nous Research 开源的一个 AI Agent 框架。Nous Research 你可能听过——做 Hermes 4 系列开源模型的那家实验室。
它和 OpenClaw 本质上是同一类东西:一个能帮你干活的 AI 代理,写代码、搜信息、管文件、跑定时任务,还能接到 Telegram 上当私人助手。
但 Hermes 有一个 OpenClaw 到现在都没做好的能力:它会自己学习。
不是 README 里写个"we support memory"就完事了。它会把你交给它的任务自动变成可复用的技能,下次遇到类似的事直接调用,还能根据新情况自我优化。用一个月和用一天,体验是不一样的。
另外,Hermes 全部用 Python 写的。这意味着当它在你机器上执行操作的时候,你可以直接去看源码,搞清楚它到底在干什么。对于一个有终端权限的 AI Agent,"我能看懂它的代码"这件事本身就是信任的基础。
安装前的准备
你需要:
- • 一台 Linux 服务器(VPS 就行,我用的腾讯云)
- • 一个 Claude API 的访问渠道(下面会说怎么搞)
- • 一个 Telegram 账号(如果你想在手机上用的话)
关于 Claude API
Hermes Agent 支持各种模型,但我推荐用 Claude——目前 Agent 场景下综合表现最好的模型之一。
直接用 Anthropic 官方 API 当然可以,但价格不便宜。我用的是 apiPlus 的中转服务(https://api.apiplus.cloud),价格大概是官方的几折,稳定性也还行。
你需要:
-
- 注册 apiPlus 账号
-
- 在后台创建一个令牌(API Key),格式是
sk-xxxxxx
- 在后台创建一个令牌(API Key),格式是
-
- 记住 Base URL:
https://api.apiplus.cloud
- 记住 Base URL:
后面安装的时候会用到。
第一步:安装 Claude Code
没错,我们先装 Claude Code。
为什么?因为 Claude Code 本身就是一个终端里的 AI 编程助手,我们可以用它来帮我们安装和配置 Hermes Agent——让 AI 帮你装 AI,效率拉满。
npm install -g @anthropic-ai/claude-code
装完之后,需要让 Claude Code 指向你的 API 中转地址:
export ANTHROPIC_BASE_URL=https://api.apiplus.cloud
export ANTHROPIC_API_KEY=sk-xxxxxx # 替换成你自己的 Key
验证一下能不能用:
claude
如果正常进入对话界面,说明 Claude Code 已经就绪。
第二步:用 Claude Code 安装 Hermes Agent
这一步是整个流程最爽的地方。
直接在 Claude Code 里说:
帮我安装 Hermes Agent,仓库地址是 https://github.com/neilbtc2020/hermes-agent
我使用的是 apiPlus 的 claude-opus-4-6
baseUrl 是:https://api.apiplus.cloud
apikey=sk-xxxxxx(替换成你的 Key)
Claude Code 会自动帮你:
-
- 克隆仓库
-
- 运行安装脚本
-
- 配置 config.yaml 里的模型和 API 地址
-
- 写入 .env 文件里的密钥
你基本上就是坐着看它干活。
装完之后 reload shell:
source ~/.bashrc
验证安装:
hermes --version
看到类似 Hermes Agent v0.7.0 的输出就说明装好了。
第三步:配置 Telegram Bot
如果你想在手机上随时跟 Hermes 对话,这一步必做。
1. 创建 Bot
在 Telegram 里找 @BotFather,发送 /newbot,按提示起个名字。BotFather 会返回一个 Bot Token,整段复制下来。
2. 获取你的 Telegram ID
找 @userinfobot,它会返回你的数字 ID。
3. 告诉 Claude Code 帮你配
回到 Claude Code,直接说:
帮我配置 Hermes 的 Telegram 集成
Bot Token 是:(粘贴 BotFather 返回的整段)
我的 Telegram ID 是:(你的数字 ID)
Claude Code 会自动把这些信息写进 .env 文件:
TELEGRAM_BOT_TOKEN=你的Token
TELEGRAM_ALLOWED_USERS=你的ID
TELEGRAM_HOME_CHANNEL=你的ID
4. 启动网关
hermes gateway start
现在打开 Telegram,给你的 Bot 发条消息试试。
就这?就这。
回顾一下,整个过程就四步:
# 1. 装 Claude Code
npm install -g @anthropic-ai/claude-code
# 2. 配 API 中转
export ANTHROPIC_BASE_URL=https://api.apiplus.cloud
export ANTHROPIC_API_KEY=sk-xxxxxx
# 3. 用 Claude Code 装 Hermes(在 claude 对话里说一句话)
# "帮我安装 Hermes Agent,仓库地址是..."
# 4. 启动 Telegram 网关
hermes gateway start
没有手动改配置文件,没有调试依赖冲突,没有看半小时文档。用 AI 装 AI,这大概就是 2026 年该有的安装体验。
装完之后,Hermes 能干什么
装好只是开始。说说 Hermes Agent 真正有意思的地方。
它的文件结构一目了然
~/.hermes/
├── config.yaml # 主配置,所有设置都在这
├── .env # API 密钥集中管理
├── SOUL.md # 人格设定(你可以自定义它的性格)
├── memories/ # 持久记忆(它自己会写)
├── skills/ # 技能库(自动生成 + 手动添加)
├── cron/ # 定时任务
├── sessions/ # 会话记录
└── logs/ # 日志
所有密钥在 .env,所有配置在 config.yaml,技能和记忆各自独立。不像有些工具,配置散落在五六个地方,出了问题都不知道去哪找。
学习闭环:越用越聪明
这是 Hermes 最核心的能力,值得展开说。
传统 AI Agent 是无状态的——每次对话结束就忘了一切。你上周让它帮你部署过一个项目,这周再让它做类似的事,它又从头问你一遍服务器地址。
Hermes 不一样。它有四层学习机制:
第一层:主动记忆。 它会自己判断什么信息值得记住,自动写入 memories/ 目录。不需要你说"记住这个"。比如你告诉它服务器 IP,下次你说"部署到服务器",它直接用上次记住的 IP。
第二层:技能自动生成。 当你让它完成一个复杂任务后,它会自动把流程提炼成一个 SKILL.md 文件。下次遇到类似任务,直接调用,不用重新推理。
第三层:技能自优化。 技能不是一成不变的。每次使用时如果遇到新情况,它会更新技能文件,把新的处理方式加进去。
第四层:用户建模。 通过 Honcho 框架,Hermes 逐渐构建对你的理解——你的工作习惯、偏好、常用工具。用得越久越懂你。
代价:学习系统在后台运行会消耗额外的 token,响应速度比纯聊天 Agent 稍慢一点。但这个 trade-off 是值得的。
操作全透明
Hermes 执行每一步都实时显示:
💻 terminal: "mkdir -p /tmp/output && ..."
✍️ write_file: "/home/user/project/script.py"
💻 terminal: "python3 script.py"
📝 skill_manage: "data-processor"
每个终端命令、文件写入、技能操作,明明白白。对于一个有系统权限的 Agent,这种透明度不是加分项,是必需品。
模型随便切
hermes model
支持 OpenAI、Anthropic、OpenRouter(200+ 模型)、Nous Portal、Kimi、MiniMax,甚至本地 Ollama。切换不用改代码。
如果你用 apiPlus 中转,config.yaml 里这样配:
model:
default: "claude-opus-4-6"
provider: "custom"
base_url: "https://api.apiplus.cloud/v1"
一个配置文件搞定,不用到处 export 环境变量。
和 OpenClaw 比,到底怎么选
| 维度 | Hermes Agent | OpenClaw |
|---|---|---|
| 语言 | 纯 Python | Node.js |
| 学习机制 | 完整闭环(记忆 + 技能生成 + 自优化 + 用户建模) | 有记忆,无自动技能生成 |
| 社区 | ~23k star(新项目) | ~340k star |
| 可视化 | 纯命令行 | 有 Dashboard |
| 代码可读性 | Python,结构清晰 | 多模块,复杂度较高 |
| 迁移 | 支持一键从 OpenClaw 迁移 | — |
我的判断:OpenClaw 是一把成熟的瑞士军刀,功能齐全,社区庞大。Hermes 是一个在成长的助手——今天比昨天多懂你一点,下个月比这个月更好用。
如果你需要稳定开箱即用,选 OpenClaw。
如果你愿意花五分钟装一个会学习的 Agent,试试 Hermes。
反正迁移也就一行命令:
hermes claw migrate
总结
整个安装流程:
-
- 装 Claude Code →
npm install -g @anthropic-ai/claude-code
- 装 Claude Code →
-
- 配 API 中转 → 指向 apiPlus 的 Base URL
-
- 用 Claude Code 装 Hermes → 一句话搞定
-
- 配 Telegram → 粘贴 Bot Token 和 ID
-
- 启动 →
hermes gateway start
- 启动 →
五分钟,四条命令,一个会学习的 AI Agent 就跑起来了。
一个工具如果不能随着使用变得更顺手,那它就只是一个工具。如果能,它就接近一个助手了。
相关链接:
- • Hermes Agent GitHub:https://github.com/NousResearch/hermes-agent
- • 官方文档:https://hermes-agent.nousresearch.com/docs/
- • apiPlus 中转服务:https://api.apiplus.cloud
- • Claude Code:https://docs.anthropic.com/en/docs/claude-code
