基礎
Mac / Linux 一行安裝
curl 管道指令碼一鍵完成。指令碼會自動處理 Python、Node.js、依賴,並把 hermes 命令加進 PATH。
檢視安裝指南Hermes Agent 中文文件
與官方 v2026.9.14 同步的中文文件:安裝、CLI 指令、Skills 系統、MCP 整合與故障排查全收錄。配程式碼示例與 CLI 速查表。
Hermes Agent 是 Nous Research 開源的自學習 AI Agent。Mac / Linux 2 分鐘裝好,Windows 走 WSL2,配好任意 LLM Provider 後,就能直接用 內建 Skills 與 Skills Hub 社群目錄。本頁是中文文件樞紐:下面每個 H2 都鏈到對應主題的專門長文。
基礎
curl 管道指令碼一鍵完成。指令碼會自動處理 Python、Node.js、依賴,並把 hermes 命令加進 PATH。
檢視安裝指南Windows
Win10 / Win11 用 WSL2 + Ubuntu 安裝的完整流程,附 8 個常見報錯處理。
檢視 Windows 教程首輪使用
裝完後跑第一個 Hermes 任務,理解自學習閉環是怎麼工作的。
檢視 Quickstart最常用的 CLI 指令一表打盡。完整 50+ 命令清單見專門的 CLI 教程。
| 命令 | 用途 | 示例 |
|---|---|---|
hermes setup | 首次配置 LLM Provider 和 API Key。 | hermes setup |
hermes | 啟動互動式 Agent,開始執行任務。 | hermes |
hermes doctor | 12 項自檢(安裝、依賴、網路、配置、API Key 等)。 | hermes doctor |
hermes update | 升級到最新版本。 | hermes update |
hermes skills install | 從 內建目錄與 Skills Hub 安裝現成 Skill。 | hermes skills install code-review |
hermes skills list | 檢視已安裝的所有 Skill。 | hermes skills list |
hermes gateway start | 啟動 Gateway 服務接訊息平臺。 | hermes gateway start |
hermes config | 檢視或編輯當前配置。 | hermes config get |
想看每個命令的所有 flag、引數、子指令完整說明?繼續到 CLI 專門教程。
Skills 是可複用的能力模組——程式碼審查、資料查詢、文件生成、網頁抓取等等。Hermes 維護 內建目錄與 Skills Hub,目前共有 內建 Skills 與 Skills Hub 社群目錄。用 hermes skills install <name> 一鍵安裝,hermes skills list 檢視已裝,按 YAML/JS 規範也能寫自己的。
從真實安裝和首輪執行收集到的高頻問題。先跑 hermes doctor,它能自動覆蓋大部分。
hermes: command not found
安裝後 PATH 沒重新整理。執行 source ~/.bashrc 或新開終端視窗。也確認 ~/.hermes/bin 在 PATH 裡。
API Key 認證失敗
重新跑 hermes setup,貼上 Key 時去掉前後空格,確認 Provider 與 Key 匹配(智譜 Key 只能配 provider=glm)。
WSL2 安裝卡在依賴解析
企業網路下 WSL2 預設 DNS 經常掛掉。先執行 sudo bash -c "echo 'nameserver 8.8.8.8' > /etc/resolv.conf",再重跑安裝。
Skills 安裝報 checksum 不一致
Registry 快取過期。執行 hermes skills cache clean,然後重新 hermes skills install <name>。
近期版本要點。完整 changelog 在 GitHub release notes。
v2026.9.14
自學習閉環 GA、內建 Skill 目錄與 Skills Hub 上線、Gateway 加固以支援生產級訊息整合、hermes doctor 擴充套件到 12 項檢查。
v0.9.x 系列
Skill 編寫規範穩定;Memory 模組預覽;OpenClaw 配置遷移工具;LLM Provider 矩陣擴充。
更早
CLI 重構、Gateway alpha、Skills 初步支援。完整歷史見專案 changelog。
完整官方 Hermes 文件仍是最完整的參考來源。如果需要更細的結構、最新版本結構或本頁未覆蓋的細節,請直接開啟官方 docs。
開啟官方 Hermes 文件