Hermes Agent 官方教程中文版
基於 Nous Research 官方 docs、llms.txt 和上游原始碼重寫的 Hermes Agent 中文查詢手冊。
官方教程中文版不是逐字翻譯,而是把 Hermes 官方文件裡的事實整理成「帶工程判斷的中文查詢頁」。遇到實現細節不確定時,以官方 docs、llms.txt 和上游原始碼為準。
先給結論:按「安裝與快速上手 → 配置 → 工具與終端後端 → 記憶 → 技能 → 訊息閘道器」的順序查。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 段 當前列表為準)。
- 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+ 平臺一站接入。
能力範圍大不等於應該同時啟用。官方教程中文版預設按「先可用,再擴充套件,再自動化」的順序組織——別讓你還沒跑通的功能在後臺替你做事。
入門章節
安裝 Hermes Agent
一行 curl 命令裝到 Linux / macOS / WSL2 / Termux;同時講清安裝目錄、PATH 和常見報錯。
快速上手 Hermes Agent
裝好之後 5 分鐘內完成 provider(推理服務商)配置、第一次對話和 session(會話)恢復。
規劃學習路徑
按你接下來要做的事——本地 CLI / 訊息機器人 / 長期助手 / 自動化 / 開發擴充套件——挑閱讀順序。
使用手冊
配置 Hermes Agent
讀懂 ~/.hermes/ 下 config.yaml、.env、auth.json、SOUL.md 各自管什麼;以及 terminal backend 怎麼切換。
工具系統與終端後端
區分呼叫什麼工具(toolsets)和在哪裡執行(terminal backend),兩者解耦才能控制風險。
記憶系統
MEMORY.md、USER.md、凍結快照、session_search、外部 memory provider 各自解決不同時間尺度的記憶問題。
技能系統
把流程沉澱成 skill 之前先看:漸進載入機制、Skills Hub 安全檢查、外部 skill 的金鑰與指令碼風險。
訊息閘道器與平臺接入
把 Hermes 接到聊天平臺前,先理解 Gateway 路由、allowlist 授權、DM 配對和 chat session 隔離。
和原理篇的分工
官方教程中文版回答**「命令、配置和功能怎麼用」。原理篇回答「為什麼這樣設計、什麼時候不要用、風險在哪裡」**。
如果你正在排障或查命令,先來這裡。如果你還沒建立整體認知,先讀 Hermes Agent 從原理到實戰 ——花 30 分鐘先把心智模型搭起來,比花 3 小時翻命令更省時間。
官方資料
- 官方文件首頁:https://hermes-agent.nousresearch.com/docs
- 官方
llms.txt(機器可讀全文索引):https://hermes-agent.nousresearch.com/docs/llms.txt - 上游原始碼:https://github.com/NousResearch/hermes-agent
- 命令、引數、環境變數等高時效細節:Reference 區