hermes-agent 中文使用教程
2026-07-23发表于
Ai一、项目速览
入门 · 1 分钟版
Hermes Agent 是一个由 Nous Research 构建的 自进化 AI 代理。它的核心卖点不是“又一个 AI 聊天机器人”,而是它拥有一个内置的学习循环:它会从对话中创建技能、在使用中改进技能、主动推送自己记住知识、搜索自己的历史对话,并跨会话构建对你的理解模型。
它是什么:一个运行在终端、Telegram、Discord、Slack 等平台上的 AI 代理框架。你给它一个任务,它执行、学习、记住、改进。
它解决什么问题:传统 AI 助手每次对话都从零开始,不会积累经验。Hermes 会把你教它的东西变成可复用的技能,下次遇到类似任务时直接调用。
谁最该用:想拥有一个“越用越聪明”的 AI 助手的人,尤其是开发者、运维人员和知识工作者。
作者视角:你可以把它理解成“AI 版的 Alfred Workflow”——它不光执行命令,还会把你每次手动纠正它的过程吸收为技能。这个设计思路挺有意思,实际用下来确实能感觉到它“变聪明”。
二、核心功能与架构
进阶 · 推荐细读
学习循环:这是 Hermes 最独特的设计。当你纠正它的行为或教它一个新方法时,它会自动创建一个技能文件(skill)并存入 ~/.hermes/skills/。下次遇到类似场景,它会先搜索已有技能再行动。这个循环包括四个阶段:观察(你的操作)→ 创建(技能文件)→ 应用(下次调用)→ 改进(根据反馈调整)。
多平台网关:Hermes 运行一个名为 gateway 的进程,同时连接 Telegram、Discord、Slack、WhatsApp、Signal 和 CLI。你可以在手机上通过 Telegram 给它发消息,它会在云 VM 上执行并返回结果。所有平台共享同一个记忆和技能库。
模型无关:你可以在 OpenAI、Anthropic、OpenRouter、本地模型之间自由切换,只需一条命令 hermes model,无需改代码。这避免了被单一模型锁定。
原生终端界面(TUI):不是简单的对话窗口,而是一个完整的终端界面,支持多行编辑、斜杠命令自动补全、对话历史、流式输出工具结果。这对于需要复杂操作的开发者来说很实用。
一句话判断:如果你需要一个“越用越好用”的 AI 助手,且不在乎它是 CLI 而不是 GUI,Hermes 是目前最值得尝试的方案之一。
三、动手实践
入门
环境准备
Hermes 安装非常简单,一条命令即可完成。它依赖 Python 3.10+ 和 curl,但安装脚本会自动处理剩余依赖。
Linux/macOS:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows(PowerShell 管理员模式):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
安装完成后,运行 hermes setup 启动配置向导。它会引导你选择模型提供商(推荐先用 OpenRouter 免费体验)、配置 API 密钥、设置基础偏好。
最小可运行示例
安装配置完成后,直接启动对话:
hermes
你会进入 TUI 界面。输入以下内容测试基础能力:
帮我写一个 Python 脚本,读取当前目录下所有 .txt 文件,统计每个文件的行数,输出到 summary.txt
Hermes 会生成代码并执行。你不需要手动复制粘贴到编辑器。如果结果有误,直接纠正它:
不对,我要的是按行数降序排列,文件名和行数之间用冒号分隔
Hermes 会修正代码并重新执行。这个纠正过程会自动被它记住为技能。
常见踩坑
坑 1:模型提供商选择
如果你选 OpenAI,但 API Key 是 OpenRouter 的,会导致认证失败。建议第一次用 hermes model 时选择 OpenRouter,它支持多种模型且免费额度够测试。
坑 2:Windows 上的杀毒软件误报
Hermes 的安装包会被 Defender 或 Bitdefender 拦截。解决方法是在杀毒软件中添加排除路径:
Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"
注意排除文件夹而不是文件 hash,因为 Hermes 更新时会改变 hash。
作者视角:这个坑我专门测过,Windows 上安装完成后如果
hermes命令找不到,大概率是杀毒软件把uv(Hermes 的包管理器)隔离了。排除路径后重新运行安装脚本即可。
四、进阶玩法
深入 · 老手可选
自定义技能
Hermes 的技能存储在 ~/.hermes/skills/ 目录下,每个技能是一个 Markdown 文件。你可以手动创建或修改技能,让 Hermes 在特定场景下自动执行特定行为。
创建一个技能让 Hermes 自动整理代码仓库:
# skill: code-review
## trigger
用户说"review this repo"或"检查代码"
## instructions
1. 运行 `find . -name "*.py" -type f` 列出所有 Python 文件
2. 对每个文件运行 `pylint` 并记录警告
3. 统计警告数量,按严重程度分类
4. 输出一个 Markdown 报告,包含:
- 文件总数
- 各严重级别警告数
- 警告最多的 5 个文件
5. 将报告保存为 `review-$(date +%Y%m%d).md`
保存为 ~/.hermes/skills/code-review.md 后,下次你说“review this repo”,Hermes 会自动执行这个流程。
跨平台网关配置
启动网关让 Hermes 同时服务于多个平台:
hermes gateway
这会在后台启动一个进程,连接所有已配置的通信平台。你可以在 Telegram 上发消息,Hermes 在服务器上执行,结果返回 Telegram。配置平台连接需要在 hermes setup 中分别设置每个平台的 API Token。
作者视角:网关模式是 Hermes 真正的杀手锏。把它部署在一台 5 美元的 VPS 上,然后通过 Telegram 控制,相当于你有了一个 24 小时在线的私人 AI 助手。注意网关需要持续运行,建议用
systemd或screen管理。
五、判断与建议
进阶
应该选它:
- 你需要一个越用越聪明的 AI 助手,且愿意花时间调教它
- 你主要工作在 CLI/终端环境,不喜欢 GUI 聊天界面
- 你希望 AI 助手能跨平台(Telegram + Discord + Slack)统一工作
- 你有多模型需求,想在不同任务中切换不同 LLM
不该选它:
- 你只需要一个简单的聊天机器人,不想配置任何东西
- 你的工作流程完全在 GUI 应用内(如 Figma、Notion),Hermes 无法直接集成
- 你需要的是代码补全 IDE 插件(如 GitHub Copilot),而不是任务执行代理
- 你对“AI 学习你的操作”有隐私顾虑,不希望它保存技能和记忆
一句话结论:Hermes 是目前最接近“个人 AI 助理”这一概念的开源项目,尤其适合愿意投入时间调教、追求长期效率提升的开发者。如果你只是想“试试 AI”,建议先用 OpenRouter 免费额度体验一下再决定是否深入。
项目信息
| 项目 | 值 |
|---|---|
| 仓库 | NousResearch/hermes-agent |
| 语言 | Python |
| Star | 219,175 |
| Fork | 41,543 |
| 主页 | https://hermes-agent.nousresearch.com |
参考链接
71
43
1
934
文章目录
评论