---
title: "Hermes Agent 官方教程中文版"
description: "基於 Nous Research 官方 docs、llms.txt 和上游原始碼重寫的 Hermes Agent 中文查詢手冊。"
verifiedAt: "2026-05-09"
---

官方教程中文版不是逐字翻譯，而是把 Hermes 官方文件裡的事實整理成「帶工程判斷的中文查詢頁」。遇到實現細節不確定時，以官方 docs、`llms.txt` 和上游原始碼為準。

> [!NOTE]
> **先給結論**：按「**安裝與快速上手 → 配置 → 工具與終端後端 → 記憶 → 技能 → 訊息閘道器**」的順序查。Hermes 能力很多，但不要一次全開——配置自由度越大，許可權邊界越容易擴散。

## 能力範圍

可以把 Hermes Agent 理解成一個**長期執行的 agent runtime（代理執行時）**，它把以下七件事壓在一個程序裡：

- **CLI / TUI（命令列 / 終端 UI）**：本機的對話入口；CLI 適合指令碼化，TUI 適合帶滑鼠和富介面的互動式體驗。
- **Provider 與模型路由**：決定調哪家模型、用哪種鑑權方式（OAuth / API key）、以及一家掛了用哪家 fallback（備用）頂上、credential pool（憑據池）怎麼輪換。
- **Toolsets（工具集）**：把工具按用途分組（web、file、terminal、browser、memory、cron、delegation 等），按需啟用，避免一次給模型開太多許可權。
- **Terminal backends（終端後端）**：決定命令實際在哪裡執行——local（本機）、Docker（容器）、SSH（遠端主機）、Daytona、Modal、Singularity、Vercel Sandbox 共 7 種環境（按 [官方 Tools 頁 Backends 段](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) 當前列表為準）。
- **Memory / session_search（記憶與會話檢索）**：長期事實記憶 + 當前會話內的滾動記憶 + 跨 session 的歷史檢索三件，分別解決不同時間尺度的「記得住」問題。
- **Skills（技能）**：把可複用流程沉澱成 markdown 知識包，再繫結到 slash command（斜槓命令）觸發；帶漸進載入和外部 Skills Hub。
- **Messaging Gateway（訊息閘道器）**：把 Hermes 接到 Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS、Matrix、Mattermost、Home Assistant、DingTalk（釘釘）、Feishu / Lark（飛書）、WeCom（企業微信）、Weixin（微信）、BlueBubbles（iMessage）、QQ、Yuanbao、Microsoft Teams 等 15+ 平臺一站接入。

能力範圍大不等於應該同時啟用。官方教程中文版預設按「**先可用，再擴充套件，再自動化**」的順序組織——別讓你還沒跑通的功能在後臺替你做事。

## 入門章節

<Cards>
  <Card title="安裝 Hermes Agent" description="一行 curl 命令裝到 Linux / macOS / WSL2 / Termux；同時講清安裝目錄、PATH 和常見報錯。" 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" />
  <Card title="規劃學習路徑" description="按你接下來要做的事——本地 CLI / 訊息機器人 / 長期助手 / 自動化 / 開發擴充套件——挑閱讀順序。" href="/zh-Hant/docs/hermes/official/00-getting-started/learning-path" />
</Cards>

## 使用手冊

<Cards>
  <Card title="配置 Hermes Agent" description="讀懂 ~/.hermes/ 下 config.yaml、.env、auth.json、SOUL.md 各自管什麼；以及 terminal backend 怎麼切換。" href="/zh-Hant/docs/hermes/official/01-user-guide/configuration" />
  <Card title="工具系統與終端後端" description="區分呼叫什麼工具（toolsets）和在哪裡執行（terminal backend），兩者解耦才能控制風險。" href="/zh-Hant/docs/hermes/official/01-user-guide/tools" />
  <Card title="記憶系統" description="MEMORY.md、USER.md、凍結快照、session_search、外部 memory provider 各自解決不同時間尺度的記憶問題。" href="/zh-Hant/docs/hermes/official/01-user-guide/memory" />
  <Card title="技能系統" description="把流程沉澱成 skill 之前先看：漸進載入機制、Skills Hub 安全檢查、外部 skill 的金鑰與指令碼風險。" href="/zh-Hant/docs/hermes/official/01-user-guide/skills" />
  <Card title="訊息閘道器與平臺接入" description="把 Hermes 接到聊天平臺前，先理解 Gateway 路由、allowlist 授權、DM 配對和 chat session 隔離。" href="/zh-Hant/docs/hermes/official/01-user-guide/messaging" />
</Cards>

## 和原理篇的分工

官方教程中文版回答**「命令、配置和功能怎麼用」**。原理篇回答**「為什麼這樣設計、什麼時候不要用、風險在哪裡」**。

如果你正在排障或查命令，先來這裡。如果你還沒建立整體認知，先讀 [Hermes Agent 從原理到實戰](/zh-Hant/docs/hermes/understanding) ——花 30 分鐘先把心智模型搭起來，比花 3 小時翻命令更省時間。

## 官方資料

- 官方文件首頁：[https://hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs)
- 官方 `llms.txt`（機器可讀全文索引）：[https://hermes-agent.nousresearch.com/docs/llms.txt](https://hermes-agent.nousresearch.com/docs/llms.txt)
- 上游原始碼：[https://github.com/NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- 命令、引數、環境變數等高時效細節：[Reference 區](https://hermes-agent.nousresearch.com/docs/reference/cli-commands)

## 下一步

<Cards>
  <Card title="從安裝開始" description="第一次使用 Hermes，先完成安裝和基礎 provider 配置——5 分鐘跑通最小閉環。" href="/zh-Hant/docs/hermes/official/00-getting-started/installation" />
  <Card title="看學習路徑" description="已經裝好 Hermes，但不知道下一步讀什麼——按目標場景選條路徑再開始。" href="/zh-Hant/docs/hermes/official/00-getting-started/learning-path" />
</Cards>
