Hermes Agent 中文文件

Hermes Agent 中文文件 — 完整指南 (2026)

與官方 v2026.9.14 同步的中文文件:安裝、CLI 指令、Skills 系統、MCP 整合與故障排查全收錄。配程式碼示例與 CLI 速查表。

Hermes Agentv2026.9.14最後更新

5 分鐘速覽

Hermes Agent 是 Nous Research 開源的自學習 AI Agent。Mac / Linux 2 分鐘裝好,Windows 走 WSL2,配好任意 LLM Provider 後,就能直接用 內建 Skills 與 Skills Hub 社群目錄。本頁是中文文件樞紐:下面每個 H2 都鏈到對應主題的專門長文。

安裝快速連結

基礎

Mac / Linux 一行安裝

curl 管道指令碼一鍵完成。指令碼會自動處理 Python、Node.js、依賴,並把 hermes 命令加進 PATH。

檢視安裝指南

Windows

Windows (WSL2)

Win10 / Win11 用 WSL2 + Ubuntu 安裝的完整流程,附 8 個常見報錯處理。

檢視 Windows 教程

首輪使用

5 分鐘快速開始

裝完後跑第一個 Hermes 任務,理解自學習閉環是怎麼工作的。

檢視 Quickstart

CLI 指令速查表

最常用的 CLI 指令一表打盡。完整 50+ 命令清單見專門的 CLI 教程。

命令用途示例
hermes setup首次配置 LLM Provider 和 API Key。hermes setup
hermes啟動互動式 Agent,開始執行任務。hermes
hermes doctor12 項自檢(安裝、依賴、網路、配置、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 系統

Skills 是可複用的能力模組——程式碼審查、資料查詢、文件生成、網頁抓取等等。Hermes 維護 內建目錄與 Skills Hub,目前共有 內建 Skills 與 Skills Hub 社群目錄。用 hermes skills install <name> 一鍵安裝,hermes skills list 檢視已裝,按 YAML/JS 規範也能寫自己的。

  • 內建目錄與 Skills Hub:nous/core、nous/dev、community/skills、partner/skills。
  • 內建 Skills 與 Skills Hub 社群目錄,覆蓋程式碼、運維、資料、寫作、研究等場景。
  • 自學習閉環:每次對話都會被沉澱進 Skill 發現機制。
  • 自定義 Skill:寫 skill.yaml + handler.js,或在現有 Skill 上擴充套件。

故障排查

從真實安裝和首輪執行收集到的高頻問題。先跑 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。

本頁定位

  • 本頁是文件樞紐——每個 H2 都鏈到對應主題的專門長文。
  • 內容已與官方 Hermes Agent v2026.9.14 同步。
  • 更深的 API 參考與邊界情況,請使用下方官方文件入口。

需要完整官方文件?

完整官方 Hermes 文件仍是最完整的參考來源。如果需要更細的結構、最新版本結構或本頁未覆蓋的細節,請直接開啟官方 docs。

開啟官方 Hermes 文件