# 🚀 Hermes Agent 完全指南：从零开始掌握会自我进化的 AI 智能体
**The agent that grows with you** | 官方中文教程 | 2026 年 4 月更新
[](https://github.com/nousresearch/hermes-agent)
[](https://github.com/nousresearch/hermes-agent)
[](https://hermesagent.org.cn/)
—
## 📖 写在前面
> **Hermes Agent** 是由 **Nous Research** 于 2026 年 2 月推出的开源 AI 智能体框架，官方定位为 *”The agent that grows with you”*（会随着使用不断成长的 Agent）。
在不到两个月的时间里，Hermes Agent 的 **GitHub 星标突破 35k+**，成为 AI Agent 赛道增长最快的项目之一。
与 OpenClaw 那种”用完即走”的无状态模式不同，Hermes 的核心理念是让 AI 成为**长期在线的数字员工**，而非一次性聊天机器人。它具备：
✅ **自我进化** – 自动将成功的操作序列转化为可复用的技能
✅ **持久记忆** – 内置四层记忆系统，越用越懂你
✅ **多平台支持** – Telegram、Discord、微信、飞书等主流平台
✅ **模型无关** – 支持 OpenAI、Anthropic、Google Gemini、DeepSeek 等 200+ 模型
—
## 🎯 一、Hermes Agent 是什么？
### 1.1 核心定位
Hermes Agent 是一个**开源、自托管、支持长期记忆与 Skills 的 AI Agent**。
### 1.2 为什么选择 Hermes？
| 特性 | 说明 |
|——|——|
| 🔥 **自我进化** | Agent 会自动将成功的操作序列转化为可复用的技能 |
| 🧠 **持久记忆** | 内置四层记忆系统，越用越懂你 |
| 🌐 **多平台支持** | Telegram、Discord、微信、飞书等主流平台 |
| 🤖 **模型无关** | 支持 OpenAI、Anthropic、Google Gemini、DeepSeek 等 200+ 模型 |
—
## 🆚 二、Hermes vs OpenClaw：深度对比
很多用户纠结于选哪个，我用一句话总结它们的根本区别：
> **OpenClaw 是”拿来主义”** —— 有 13000+ 社区技能直接装，接上就能干活
> **Hermes Agent 是”自我进化”** —— 技能是自己长出来的，用两个月后你会发现它比你更了解你的工作流程
具体差异体现在五个核心维度：
| 维度 | OpenClaw | Hermes Agent |
|——|———-|————–|
| 💾 **记忆机制** | Markdown 文件 + 插件 | 原生多层记忆架构 |
| 🛠️ **技能来源** | 社区下载 (13000+) | 自动学习生成 |
| 🛡️ **安全沙箱** | 默认无 | 五层防御体系 |
| 💰 **Token 成本** | 全量加载 | 渐进式加载 |
| 🎯 **适用场景** | 开箱即用 | 长期在线数字员工 |
> **💡 选型建议**
> – 追求海量插件、开箱即用 → **OpenClaw**
> – 追求越用越强、省心安全 → **Hermes Agent**
> – 两个都用也行，技能格式可以互通！
—
## 🚀 三、快速安装与配置
### 3.1 前置要求
“`bash
# Python 环境
Python 3.10+
# 安装方式
pip install hermes-agent
# 或者使用 Docker
docker pull hermesagent/hermes-agent:latest
“`
### 3.2 初始化向导 ⚙️
运行以下命令进入交互式配置：
“`bash
hermes setup
“`
向导会引导你完成以下配置：
1. ✅ 选择默认模型提供商（OpenAI / Anthropic / Nous Portal / OpenRouter 等）
2. ✅ 输入 API Key（安全写入 ~/.hermes/.env）
3. ✅ 选择终端后端（本地 / Docker / SSH）
4. ✅ 配置记忆功能（**建议开启**）
5. ✅ 选择语言偏好（中文 / 英文）
配置完成后会自动保存到 `~/.hermes/config.yaml`。
### 3.3 模型选择 🔧
运行交互式模型选择器：
“`bash
hermes model
“`
或者直接指定模型：
“`bash
hermes –model openai/gpt-4o
hermes –model anthropic/claude-3-5-sonnet
hermes –model ollama/llama3.2
hermes –model deepseek/deepseek-chat
“`
### 3.4 API Key 配置 🔑
API Key 存储在 `~/.hermes/.env` 文件中：
“`bash
# 方式一：直接编辑
nano ~/.hermes/.env
# 方式二：通过命令设置（推荐）
hermes config set NOUS_API_KEY your_key_here
hermes config set OPENAI_API_KEY your_key_here
hermes config set ANTHROPIC_API_KEY your_key_here
“`
.env 文件格式参考：
“`bash
# Nous Portal
NOUS_API_KEY=nsk-xxxxxxxxxxxx
# OpenRouter
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxx
# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxx
# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
“`
—
## 💻 四、常用命令行与技巧
### 4.1 基本交互
#### 进入交互模式
“`bash
hermes
“`
这会打开一个持续对话界面，支持多轮对话和上下文保持。
#### 单次问答
“`bash
hermes chat -q “你好，请介绍一下你自己”
hermes chat -q “用 Python 写一个快速排序算法”
hermes chat -q “总结一下今天的新闻”
“`
#### 管道输入
“`bash
echo “解释这段代码” | hermes chat
cat error.log | hermes chat -q “帮我分析这个错误”
“`
### 4.2 会话管理 📚
“`bash
# 继续上一次会话
hermes –continue
# 按标题恢复会话
hermes -r “fix-auth”
# 列出历史会话
hermes sessions list
“`
### 4.3 斜杠命令速查 📋
| 命令 | 作用 | 使用场景 |
|——|——|———-|
| `/compress` | 手动压缩上下文 | Token 快用完时 |
| `/verbose` | 显示工具执行过程 | 调试 Agent 行为 |
| `/model xxx` | 实时切换模型 | 简单任务用便宜模型 |
| `/usage` | 查看 token 消耗 | 成本控制 |
| `/bg
| `/plan <需求>` | 先生成计划 | 复杂任务先确认思路 |
| `/rollback [n]` | 文件系统回滚 | Agent 改坏了东西 |
### 4.4 工具集控制 ⚙️
“`bash
# 启用指定工具集
hermes –toolsets web,terminal,browser
# 禁用所有工具（纯对话模式）
hermes –toolsets none
# 查看所有可用工具集
hermes toolsets list
“`
—
## 🧠 五、记忆系统详解
Hermes 的记忆不是简单的”聊天记录存盘”，而是一个**分层体系**：
| 记忆类型 | 存储位置 | 容量 | 用途 |
|———|———-|——|——|
| **MEMORY.md** | ~/.hermes/MEMORY.md | ~2,200 字符 | 项目笔记、工作流规律 |
| **USER.md** | ~/.hermes/USER.md | ~1,375 字符 | 用户画像、技术栈、沟通风格 |
| **会话历史** | SQLite + FTS5 | 无限 | 全文检索历史对话 |
| **Honcho 集成** | 云/自托管 | 无限 | 深度用户建模（可选） |
### 💡 关键点
– MEMORY.md 和 USER.md 由 Agent **自主维护**，不需要手动编辑
– 会话历史支持 FTS5 全文检索：`hermes memory search “关键词”`
– Docker 部署时需挂载 `~/.hermes` 作为 volume，否则容器重建会丢失记忆
—
## 🛠️ 六、技能（Skill）系统
### 6.1 什么是 Skill？
Skill 是 Hermes Agent 的核心学习机制。每当 Agent 完成一个复杂任务——特别是中间出过错然后自己修了、走了非显而易见但有效的路径、或者你做了纠正——它会自动触发学习循环，在 `~/.hermes/skills/` 目录下生成标准的 SKILL.md 文件。
### 6.2 三种创建方式
#### 方式一：自动提炼 ⭐
在对话中，Hermes 会自动识别可复用的操作序列并提示保存为技能。
> **示例：**
> “`
> 你：帮我查一下 Python requests 库的最新版本，然后检查我的项目是否需要更新
>
> Hermes：[执行一系列操作后]
> 我注意到这个流程可以复用。是否将其保存为技能”check_package_version”？
>
> 你：是的，保存
> “`
#### 方式二：手动创建
在 `~/.hermes/skills/` 下创建 YAML 文件：
“`yaml
name: git_summary
description: 生成当前 Git 仓库的提交摘要报告
version: “1.0”
tags:
– git
– development
steps:
– tool: terminal
command: git log –oneline -20
description: 获取最近 20 条提交记录
– tool: llm
prompt: |
基于以上 git 信息，生成一份简洁的中文摘要报告
“`
#### 方式三：对话生成
“`bash
hermes chat -q “帮我创建一个技能，功能是检查系统资源使用情况”
“`
### 6.3 渐进式加载（Progressive Disclosure）✨
这是 Hermes 技能系统最精巧的设计之一：
“`
Level 0: 仅加载技能列表 (~3k tokens)
↓ (Agent 判断需要某个技能)
Level 1: 真正需要时才加载完整内容
↓ (技能引用外部文件)
Level 2: 按需加载参考文档/模板文件
“`
这比传统框架全量加载所有技能节省大量 token！
—
## 🛡️ 七、安全设计
Hermes Agent 内置**五层安全防线**：
1. 🔐 **用户授权机制** – 危险操作需手动审批
2. ✅ **命令审批策略** – 支持一次/会话/始终/拒绝四种模式
3. 📦 **容器隔离** – 支持 local/Docker/SSH/Daytona/Singularity/Modal 六种后端
4. 🔒 **MCP 凭证过滤** – 自动检测敏感信息
5. 🔍 **上下文文件扫描** – 防止注入攻击
> ⚠️ **截至 2026 年 4 月，Hermes Agent 没有公开记录的任何 CVE 漏洞。**
—
## 🌐 八、消息平台配置
让 Hermes 在 Telegram、Discord 等平台响应：
“`bash
hermes gateway setup
“`
以 Telegram 为例，向导会引导你：
1. 从 @BotFather 获取 Bot Token
2. 配置允许的用户 ID
3. 启动网关：`hermes gateway start`
### 支持的平台一览
| 平台 | 支持状态 |
|——|———|
| Telegram | ✅ |
| Discord | ✅ |
| Slack | ✅ |
| WhatsApp | ✅ |
| Signal | ✅ |
| 微信 | ✅ |
| 飞书 | ✅ |
| 钉钉 | ✅ |
—
## 💡 九、实战技巧与最佳实践
### 9.1 AGENTS.md 项目规则
在项目根目录放置 `AGENTS.md` 文件，Hermes 启动时会自动读取：
“`markdown
# 项目上下文
– 这是一个 FastAPI 后端项目
– 所有数据库操作必须使用 async/await
– 测试文件放在 tests/ 目录下
– 禁止提交 .env 文件
– API 路由统一使用 /api/v1/ 前缀
“`
### 9.2 SOUL.md 人格配置
`~/.hermes/SOUL.md` 定义 Agent 的行为风格：
“`markdown
You are a senior backend engineer.
Be terse and direct.
Skip explanations unless asked.
Always consider error handling and edge cases.
“`
### 9.3 Token 省钱技巧 💰
1. **保持系统提示稳定** – 不要频繁修改 SOUL.md 和 AGENTS.md
2. **善用 `/compress`** – 主动压缩而不是等到被迫截断
3. **渐进式技能加载** – 不用一次性把所有技能塞进上下文
—
## ❓ 十、常见问题与排错
### Q1: 如何迁移 OpenClaw 数据？
“`bash
hermes claw migrate
“`
### Q2: Docker 部署后记忆丢失？
确保挂载 volume：
“`bash
docker run -v ~/.hermes:/root/.hermes hermesagent/hermes-agent
“`
### Q3: 切换模型失败？
检查 API Key 是否正确：
“`bash
hermes config show
“`
—
## 📝 总结
Hermes Agent 代表了一种全新的 AI 助手范式——**会从经验中学习**的数字员工。如果你需要一个能够长期使用、持续进化、越用越省心的 AI 伙伴，Hermes Agent 值得尝试。
—
## 🔗 相关链接
– 🌐 **官网**: https://hermes.xaapi.ai/
– 🐙 **GitHub**: https://github.com/nousresearch/hermes-agent
– 📚 **中文文档**: https://hermesagent.org.cn/
– 🇨🇳 **中文社区**: https://hermesagentai.cn/
—
**喜欢这篇文章吗？给 Hermes 点个 Star 吧！** ⭐