---
title: "规划 Hermes Agent 学习路径"
description: "按经验等级和使用场景选择 Hermes Agent 文档阅读顺序，先跑通基础闭环，再进入工具、记忆、消息网关和自动化。"
verifiedAt: "2026-05-09"
---

Hermes Agent 的官方文档树很大：CLI、TUI、provider（推理服务商）、sessions（会话）、tools、memory、skills、context files（上下文文件）、MCP（模型上下文协议）、Gateway、cron、delegation（子代理委派）、hooks（生命周期钩子）、batch（批处理）、RL training（强化学习训练）、plugins、developer guide（开发者指南）全都在里面。学它不适合从第一篇一路扫到最后一篇——**先完成基础闭环，再按你接下来要做的事深入**。

官方资料：[Learning Path](https://hermes-agent.nousresearch.com/docs/getting-started/learning-path)、[llms.txt](https://hermes-agent.nousresearch.com/docs/llms.txt)、[GitHub README](https://github.com/NousResearch/hermes-agent)。

> [!NOTE]
> **先给结论**：所有人先完成「安装 → provider 配置 → 第一次对话 → session 恢复」；之后再按「**本地 CLI / 消息机器人 / 长期助手 / 自动化 / 开发扩展 / 研究训练**」六类目标选择路径。基础不稳就开扩展，等于在裂缝上加压。

## 共同起点

无论你后面想做什么，都先完成这条链路：

```text
Installation -> Quickstart -> first chat -> session resume
（安装 → 快速上手 → 第一次对话 → 会话恢复）
```

对应入口：

<Cards>
  <Card title="安装 Hermes Agent" description="先确保命令可用、~/.hermes 目录存在、provider 配置入口正常。" href="/docs/hermes/official/00-getting-started/installation" />
  <Card title="快速上手 Hermes Agent" description="装好之后 5 分钟内完成 provider、第一次对话和 session 恢复。" href="/docs/hermes/official/00-getting-started/quickstart" />
</Cards>

如果这条链路还不稳定，**不要**先看 Gateway、cron、MCP、skills 或开发者扩展。

## 按经验等级走

> 官方学习路径页给了三档时间估算（Beginner ~1 小时 / Intermediate ~2–3 小时 / Advanced ~4–6 小时）。本文的中文路径比官方多一点："为什么这一步" 的说明。

### 新手：跑起来、能对话、能恢复、能看懂报错（约 1 小时）

1. [安装 Hermes Agent](/docs/hermes/official/00-getting-started/installation) —— 命令可用、PATH 生效。
2. [快速上手 Hermes Agent](/docs/hermes/official/00-getting-started/quickstart) —— provider 配置 + 第一次对话。
3. [配置 Hermes Agent](/docs/hermes/official/01-user-guide/configuration) —— 看清 `~/.hermes/` 下各文件的分工。
4. [第一个稳定闭环](/docs/hermes/understanding/02-first-stable-loop) —— 把上面三步压成可重复的最小流程。
5. [工具系统与终端后端](/docs/hermes/understanding/04-tools-terminal-backends) —— 在开 toolset 之前先理解执行边界。

### 进阶：把 Hermes 从本地 CLI 扩展成长期助手或消息入口（约 2–3 小时）

1. [Sessions 与恢复](/docs/hermes/official/00-getting-started/quickstart) —— session 复用是后续所有功能的载体。
2. [消息网关](/docs/hermes/official/01-user-guide/messaging) —— 接平台前先理解 allowlist 和 DM pairing。
3. [工具系统](/docs/hermes/official/01-user-guide/tools) —— 远程接入前控制工具权限。
4. [技能系统](/docs/hermes/official/01-user-guide/skills) —— 把可复用流程沉淀为 skill。
5. [记忆系统](/docs/hermes/official/01-user-guide/memory) —— 长期事实记忆的写入门槛。
6. [自动化边界](/docs/hermes/understanding/08-automation-boundaries) —— 后台任务上线前的安全基线。

### 高级：扩展工具、开发插件、接 MCP、做批处理或研究训练（约 4–6 小时）

1. 官方 [Plugins](https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins) / [MCP](https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp) / [Hooks](https://hermes-agent.nousresearch.com/docs/user-guide/features/hooks) 文档
2. 官方 [Architecture](https://hermes-agent.nousresearch.com/docs/developer-guide/architecture) / [Agent Loop](https://hermes-agent.nousresearch.com/docs/developer-guide/agent-loop) / [Prompt Assembly](https://hermes-agent.nousresearch.com/docs/developer-guide/prompt-assembly) 文档
3. 官方 [Adding Tools](https://hermes-agent.nousresearch.com/docs/developer-guide/adding-tools) / [Creating Skills](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) 文档
4. 官方 [Batch Processing](https://hermes-agent.nousresearch.com/docs/user-guide/features/batch-processing) 文档
5. 上游源码和测试：[github.com/NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)

高级路径**不适合**跳过基础闭环直接看源码。不了解 session、toolsets、memory 和 provider runtime（推理服务商运行时），源码阅读会很散，看到的是一堆类名而不是动作链路。

## 按使用场景走

> 与官方 By Use Case 段对照——挑一条贴近你目标的路径开干。

### 本地 CLI 编码助理

```text
Installation -> Quickstart -> CLI Usage -> Code Execution -> Context Files -> Tips & Tricks
（安装 → 快速上手 → 配置 → 工具 → 上下文文件 → 安全）
```

### Telegram / Discord / Slack 机器人

```text
Installation -> Configuration -> Messaging Gateway -> Telegram/Discord 子页 -> Voice Mode -> Security
（安装 → 配置 → 消息网关 → 选定平台 → 语音模式 → 安全）
```

### 个人长期助手

```text
Quickstart -> Memory -> Skills -> Sessions -> Gateway -> Cron
（快速上手 → 记忆 → 技能 → 会话 → 消息网关 → 定时）
```

### 团队共享入口

```text
Quickstart -> Messaging -> allowlist / DM pairing -> toolsets per platform -> logs
（快速上手 → 消息平台 → 允许名单与私聊配对 → 按平台设工具集 → 日志审计）
```

### 自动化任务

```text
Quickstart -> Cron -> Delegation -> Hooks -> Delivery -> rollback plan
（快速上手 → 定时 → 子代理委派 → 钩子 → 投递 → 回滚预案）
```

### 自定义能力开发

```text
Plugins -> Tools -> Skills -> MCP -> Architecture -> Tests
（插件 → 工具 → 技能 → MCP 集成 → 架构源码 → 测试）
```

## 功能地图

<Cards>
  <Card title="Tools" description="文件、终端、浏览器、web、memory、cron、delegation 等可调用能力——按 toolset 分组按需启用。" href="/docs/hermes/official/01-user-guide/tools" />
  <Card title="Skills" description="把可复用流程和过程性知识沉淀为按需加载的 skill；外部 skill 装前必查密钥与脚本。" href="/docs/hermes/official/01-user-guide/skills" />
  <Card title="Memory" description="MEMORY.md（项目）、USER.md（用户）、session_search（历史检索）、外部 memory provider 各自解决不同时间尺度的记忆问题。" href="/docs/hermes/official/01-user-guide/memory" />
  <Card title="Messaging" description="通过 Gateway 接 Telegram、Discord、Slack、WhatsApp、Signal、Email、DingTalk、Feishu、WeCom 等 15+ 平台。" href="/docs/hermes/official/01-user-guide/messaging" />
</Cards>

这组中文教程**不复刻官方完整目录**，而是把最关键的使用面重写成中文学习路径。遇到实现细节（命令参数、配置可选值、限额），以官方 docs、`llms.txt` 和 GitHub 源码为准——本站只是中文导航与判断指引，不是命令字典。

## 每读一页都问三件事

读 Hermes 文档容易"看完就忘"，因为页面间联动密集、术语很多。每读完一页，强制自己回答下面三个问题：

- **这页解决的真实问题是什么？**（不是"它在讲 cron"，而是"它解决了我哪种实际场景下的什么痛点"）
- **它依赖前面哪一层能力？**（cron 依赖 session + 工具集 + 日志，session 不稳就开 cron 等于在流沙上盖楼）
- **今天启用它，最小验收动作是什么？**（不是"配完就行"，而是"配完后我跑哪条命令能确认它真的在工作"）

能回答这三个问题，再进入下一页。不能回答，说明你是在**堆功能**，不是在搭稳定工作流——回头补这页或回退一层再读。

## 下一步

<Cards>
  <Card title="配置 Hermes Agent" description="继续读懂 ~/.hermes 下 config.yaml、.env、auth.json 各自的分工，以及 provider 和 terminal backend 怎么切换。" href="/docs/hermes/official/01-user-guide/configuration" />
  <Card title="Hermes Agent 是什么" description="如果还没建立整体心智模型，先从原理篇第一篇开始——花 30 分钟比直接翻命令省一整天。" href="/docs/hermes/understanding/01-what-is-hermes-agent" />
</Cards>

## 官方资料

- [Learning Path 官方页](https://hermes-agent.nousresearch.com/docs/getting-started/learning-path)
- [llms.txt 全文索引](https://hermes-agent.nousresearch.com/docs/llms.txt)
- [GitHub README](https://github.com/NousResearch/hermes-agent)
