規劃 Hermes Agent 學習路徑
按經驗等級和使用場景選擇 Hermes Agent 文件閱讀順序,先跑通基礎閉環,再進入工具、記憶、訊息閘道器和自動化。
Hermes Agent 的官方文件樹很大:CLI、TUI、provider(推理服務商)、sessions(會話)、tools、memory、skills、context files(上下文檔案)、MCP(模型上下文協議)、Gateway、cron、delegation(子代理委派)、hooks(生命週期鉤子)、batch(批處理)、RL training(強化學習訓練)、plugins、developer guide(開發者指南)全都在裡面。學它不適合從第一篇一路掃到最後一篇——先完成基礎閉環,再按你接下來要做的事深入。
官方資料:Learning Path、llms.txt、GitHub README。
先給結論:所有人先完成「安裝 → provider 配置 → 第一次對話 → session 恢復」;之後再按「本地 CLI / 訊息機器人 / 長期助手 / 自動化 / 開發擴充套件 / 研究訓練」六類目標選擇路徑。基礎不穩就開擴充套件,等於在裂縫上加壓。
共同起點
無論你後面想做什麼,都先完成這條鏈路:
Installation -> Quickstart -> first chat -> session resume
(安装 → 快速上手 → 第一次对话 → 会话恢复)對應入口:
安裝 Hermes Agent
先確保命令可用、~/.hermes 目錄存在、provider 配置入口正常。
快速上手 Hermes Agent
裝好之後 5 分鐘內完成 provider、第一次對話和 session 恢復。
如果這條鏈路還不穩定,不要先看 Gateway、cron、MCP、skills 或開發者擴充套件。
按經驗等級走
官方學習路徑頁給了三檔時間估算(Beginner ~1 小時 / Intermediate ~2–3 小時 / Advanced ~4–6 小時)。本文的中文路徑比官方多一點:"為什麼這一步" 的說明。
新手:跑起來、能對話、能恢復、能看懂報錯(約 1 小時)
- 安裝 Hermes Agent —— 命令可用、PATH 生效。
- 快速上手 Hermes Agent —— provider 配置 + 第一次對話。
- 配置 Hermes Agent —— 看清
~/.hermes/下各檔案的分工。 - 第一個穩定閉環 —— 把上面三步壓成可重複的最小流程。
- 工具系統與終端後端 —— 在開 toolset 之前先理解執行邊界。
進階:把 Hermes 從本地 CLI 擴充套件成長期助手或訊息入口(約 2–3 小時)
- Sessions 與恢復 —— session 複用是後續所有功能的載體。
- 訊息閘道器 —— 接平臺前先理解 allowlist 和 DM pairing。
- 工具系統 —— 遠端接入前控制工具許可權。
- 技能系統 —— 把可複用流程沉澱為 skill。
- 記憶系統 —— 長期事實記憶的寫入門檻。
- 自動化邊界 —— 後臺任務上線前的安全基線。
高階:擴充套件工具、開發外掛、接 MCP、做批處理或研究訓練(約 4–6 小時)
- 官方 Plugins / MCP / Hooks 文件
- 官方 Architecture / Agent Loop / Prompt Assembly 文件
- 官方 Adding Tools / Creating Skills 文件
- 官方 Batch Processing 文件
- 上游原始碼和測試:github.com/NousResearch/hermes-agent
高階路徑不適合跳過基礎閉環直接看原始碼。不瞭解 session、toolsets、memory 和 provider runtime(推理服務商執行時),原始碼閱讀會很散,看到的是一堆類名而不是動作鏈路。
按使用場景走
與官方 By Use Case 段對照——挑一條貼近你目標的路徑開幹。
本地 CLI 編碼助理
Installation -> Quickstart -> CLI Usage -> Code Execution -> Context Files -> Tips & Tricks
(安装 → 快速上手 → 配置 → 工具 → 上下文文件 → 安全)Telegram / Discord / Slack 機器人
Installation -> Configuration -> Messaging Gateway -> Telegram/Discord 子页 -> Voice Mode -> Security
(安装 → 配置 → 消息网关 → 选定平台 → 语音模式 → 安全)個人長期助手
Quickstart -> Memory -> Skills -> Sessions -> Gateway -> Cron
(快速上手 → 记忆 → 技能 → 会话 → 消息网关 → 定时)團隊共享入口
Quickstart -> Messaging -> allowlist / DM pairing -> toolsets per platform -> logs
(快速上手 → 消息平台 → 允许名单与私聊配对 → 按平台设工具集 → 日志审计)自動化任務
Quickstart -> Cron -> Delegation -> Hooks -> Delivery -> rollback plan
(快速上手 → 定时 → 子代理委派 → 钩子 → 投递 → 回滚预案)自定義能力開發
Plugins -> Tools -> Skills -> MCP -> Architecture -> Tests
(插件 → 工具 → 技能 → MCP 集成 → 架构源码 → 测试)功能地圖
Tools
檔案、終端、瀏覽器、web、memory、cron、delegation 等可呼叫能力——按 toolset 分組按需啟用。
Skills
把可複用流程和過程性知識沉澱為按需載入的 skill;外部 skill 裝前必查金鑰與指令碼。
Memory
MEMORY.md(專案)、USER.md(使用者)、session_search(歷史檢索)、外部 memory provider 各自解決不同時間尺度的記憶問題。
Messaging
透過 Gateway 接 Telegram、Discord、Slack、WhatsApp、Signal、Email、DingTalk、Feishu、WeCom 等 15+ 平臺。
這組中文教程不復刻官方完整目錄,而是把最關鍵的使用面重寫成中文學習路徑。遇到實現細節(命令引數、配置可選值、限額),以官方 docs、llms.txt 和 GitHub 原始碼為準——本站只是中文導航與判斷指引,不是命令字典。
每讀一頁都問三件事
讀 Hermes 文件容易"看完就忘",因為頁面間聯動密集、術語很多。每讀完一頁,強制自己回答下面三個問題:
- 這頁解決的真實問題是什麼?(不是"它在講 cron",而是"它解決了我哪種實際場景下的什麼痛點")
- 它依賴前面哪一層能力?(cron 依賴 session + 工具集 + 日誌,session 不穩就開 cron 等於在流沙上蓋樓)
- 今天啟用它,最小驗收動作是什麼?(不是"配完就行",而是"配完後我跑哪條命令能確認它真的在工作")
能回答這三個問題,再進入下一頁。不能回答,說明你是在堆功能,不是在搭穩定工作流——回頭補這頁或回退一層再讀。
下一步
配置 Hermes Agent
繼續讀懂 ~/.hermes 下 config.yaml、.env、auth.json 各自的分工,以及 provider 和 terminal backend 怎麼切換。
Hermes Agent 是什麼
如果還沒建立整體心智模型,先從原理篇第一篇開始——花 30 分鐘比直接翻命令省一整天。