---
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="/zh-Hant/docs/hermes/official/00-getting-started/installation" />
  <Card title="快速上手 Hermes Agent" description="裝好之後 5 分鐘內完成 provider、第一次對話和 session 恢復。" href="/zh-Hant/docs/hermes/official/00-getting-started/quickstart" />
</Cards>

如果這條鏈路還不穩定，**不要**先看 Gateway、cron、MCP、skills 或開發者擴充套件。

## 按經驗等級走

> 官方學習路徑頁給了三檔時間估算（Beginner ~1 小時 / Intermediate ~2–3 小時 / Advanced ~4–6 小時）。本文的中文路徑比官方多一點："為什麼這一步" 的說明。

### 新手：跑起來、能對話、能恢復、能看懂報錯（約 1 小時）

1. [安裝 Hermes Agent](/zh-Hant/docs/hermes/official/00-getting-started/installation) —— 命令可用、PATH 生效。
2. [快速上手 Hermes Agent](/zh-Hant/docs/hermes/official/00-getting-started/quickstart) —— provider 配置 + 第一次對話。
3. [配置 Hermes Agent](/zh-Hant/docs/hermes/official/01-user-guide/configuration) —— 看清 `~/.hermes/` 下各檔案的分工。
4. [第一個穩定閉環](/zh-Hant/docs/hermes/understanding/02-first-stable-loop) —— 把上面三步壓成可重複的最小流程。
5. [工具系統與終端後端](/zh-Hant/docs/hermes/understanding/04-tools-terminal-backends) —— 在開 toolset 之前先理解執行邊界。

### 進階：把 Hermes 從本地 CLI 擴充套件成長期助手或訊息入口（約 2–3 小時）

1. [Sessions 與恢復](/zh-Hant/docs/hermes/official/00-getting-started/quickstart) —— session 複用是後續所有功能的載體。
2. [訊息閘道器](/zh-Hant/docs/hermes/official/01-user-guide/messaging) —— 接平臺前先理解 allowlist 和 DM pairing。
3. [工具系統](/zh-Hant/docs/hermes/official/01-user-guide/tools) —— 遠端接入前控制工具許可權。
4. [技能系統](/zh-Hant/docs/hermes/official/01-user-guide/skills) —— 把可複用流程沉澱為 skill。
5. [記憶系統](/zh-Hant/docs/hermes/official/01-user-guide/memory) —— 長期事實記憶的寫入門檻。
6. [自動化邊界](/zh-Hant/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="/zh-Hant/docs/hermes/official/01-user-guide/tools" />
  <Card title="Skills" description="把可複用流程和過程性知識沉澱為按需載入的 skill；外部 skill 裝前必查金鑰與指令碼。" href="/zh-Hant/docs/hermes/official/01-user-guide/skills" />
  <Card title="Memory" description="MEMORY.md（專案）、USER.md（使用者）、session_search（歷史檢索）、外部 memory provider 各自解決不同時間尺度的記憶問題。" href="/zh-Hant/docs/hermes/official/01-user-guide/memory" />
  <Card title="Messaging" description="透過 Gateway 接 Telegram、Discord、Slack、WhatsApp、Signal、Email、DingTalk、Feishu、WeCom 等 15+ 平臺。" href="/zh-Hant/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="/zh-Hant/docs/hermes/official/01-user-guide/configuration" />
  <Card title="Hermes Agent 是什麼" description="如果還沒建立整體心智模型，先從原理篇第一篇開始——花 30 分鐘比直接翻命令省一整天。" href="/zh-Hant/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)
