Hermes Agent 安裝教程（2026 完整版）

系統要求

Hermes Agent v2026.9.14 對環境的要求是“能跑 Python 3.10+ 和 Node.js 18+”就行。絕大多數 2020 年後的開發機都滿足。

• 作業系統：macOS 12+（Intel / Apple Silicon）/ Ubuntu 20.04+ / Debian 11+ / Fedora 36+ / Arch / WSL2 Ubuntu
• Python：3.10 或更高版本（指令碼檢測到缺失會自動裝 pyenv 並補齊）
• Node.js：18 或更高版本（同樣自動安裝）
• Git：2.30+（用來克隆 Skills registry）
• 磁碟空間：1.5 GB（包含 Skills 快取）
• 網路：能訪問 GitHub raw 與所選 LLM Provider 的 API

不滿足任何一項，hermes doctor 會在安裝結束時點名告訴你具體哪一項 + 怎麼修。

一行指令安裝（Mac + Linux）

把下面這條命令貼進終端回車就行。指令碼會自動處理 Python / Node.js / 依賴 / Hermes CLI / PATH 配置。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

1. 過程預覽

   指令碼會依次：檢查 Python / Node 版本 → 安裝到 ~/.hermes → 把 hermes 命令加進 PATH → 拉取 nous/core 預設 Skills registry → 輸出 hermes 命令路徑。

2. 什麼時候完成

   看到 ✅ Hermes Agent installed at ~/.hermes 表示主流程已結束，整體耗時 1-3 分鐘（取決於網路）。

3. 把 PATH 立即生效

   新開一個終端視窗（macOS Terminal / iTerm / Linux Terminal）就行，或者在當前終端跑 source ~/.zshrc（Mac 預設）/ source ~/.bashrc（多數 Linux）。

裝完直接跑 hermes setup 進入互動式配置，然後 hermes 啟動 Agent。下一節會展開。

Windows 使用者必讀

Hermes Agent 在 Windows 上不原生跑——必須經 WSL2（Windows Subsystem for Linux 2）。這不是 Hermes 的限制，而是 Python 生態對 Windows 路徑處理 + 終端 ANSI 渲染長期的相容性問題。

• Win10 21H2 / Win11 都內建 WSL2，開啟耗時約 5 分鐘
• 推薦發行版：Ubuntu 22.04 LTS（在 Microsoft Store 一鍵裝）
• WSL Ubuntu 裝好之後，在 Ubuntu 終端裡跑上一節那條 install.sh
• VS Code 透過 Remote-WSL 擴充套件可以無縫編輯 WSL 內的專案

完整步驟（含 8 個 WSL 常見報錯）見 /install/windows 專門指南。

安裝驗證：hermes doctor

裝完跑這一條命令一鍵自檢 12 項：Python / Node 版本、PATH、Skills registry 連通性、LLM Provider 連線、磁碟空間、檔案許可權。

hermes doctor

• ✅ 表示透過，不需要管
• ⚠️ 表示警告（不影響正常使用，但可能影響後續高階用法）
• ❌ 表示阻塞，必須解決
• 加 --verbose 看詳細診斷；加 --fix 讓指令碼自動修可修的問題

完整 12 項含義和報錯對照表，見 /cli/doctor 專題。

安裝後必做 5 步

裝完不是結束，下面 5 步是從“能啟動”到“真正能幹活”之間的距離。

1. 1. 配置 LLM Provider（必做）

   跑 hermes setup 進入互動式嚮導，國內推薦先選智譜 GLM-4 或 Kimi（無需代理、按量計費便宜）。海外使用者用 Claude / OpenAI / OpenRouter 都行。詳見 /providers/glm 與 /providers/kimi。

2. 2. 跑你的第一個 Agent 任務

   終端裡直接 hermes，輸入“給我列一下當前目錄下所有 Python 檔案的行數”，看 Agent 怎麼呼叫 Skills 完成任務。這一步主要是確認 LLM 鏈路通了。

3. 3. 安裝常用 Skills

   hermes skills install code-review 裝一個程式碼審查 Skill；hermes skills list 看已安裝清單。Hermes 自帶 Skills Hub 共 bundled and community Skills，按需安裝即可。

4. 4. 配置 Memory（可選但強烈建議）

   預設 Hermes 是無狀態的。開啟 Memory 後跨會話記住你的偏好和專案結構。hermes config memory enable + hermes memory init。

5. 5. 接入訊息平臺（可選）

   釘釘 / 飛書 / Slack 都可以透過 Hermes Gateway 接入，做團隊 AI 助手或工單機器人。詳見 /integrations/dingtalk 和 /integrations/feishu。

常見安裝報錯

90% 的安裝報錯都是這 6 類。挨個對照排查即可。

• curl: (60) SSL certificate problem

  原因 / Cause: 系統證書過期或被代理軟體攔截（常見於公司網路）。

  修复 / Fix: 先 sudo apt-get install ca-certificates 或 brew install openssl 更新證書。仍報錯就讓網路管理員加 raw.githubusercontent.com 到白名單。

• Python: command not found

  原因 / Cause: macOS 12 預設不再帶 python（只有 python3）。安裝指令碼會自動裝 pyenv 但需要重啟終端。

  修复 / Fix: 關掉當前終端視窗，新開一個再跑命令。或在當前終端跑 source ~/.zshrc。

• EACCES: permission denied 寫入 /usr/local

  原因 / Cause: Linux 上指令碼試圖把 hermes 軟鏈到 /usr/local/bin 但當前使用者沒許可權。

  修复 / Fix: 不要用 sudo 跑安裝指令碼——指令碼預設裝到 ~/.hermes 不需要 root。如果之前不小心 sudo 過，先 sudo rm -rf ~/.hermes && rm -rf /usr/local/bin/hermes，再用普通使用者重跑。

• WSL2 裡跑安裝指令碼卡在 Installing Python deps

  原因 / Cause: WSL2 預設 DNS 用 Windows 主機解析，國內網路下 pypi.org 偶爾抽風。

  修复 / Fix: 在 WSL Ubuntu 裡 echo "[network]\ngenerateResolvConf = false" | sudo tee /etc/wsl.conf 然後 wsl --shutdown 重啟 WSL，再手動設定 /etc/resolv.conf 為 8.8.8.8。

• hermes: command not found（裝完之後）

  原因 / Cause: PATH 沒生效。指令碼寫到 ~/.zshrc 或 ~/.bashrc 但當前終端沒重新載入。

  修复 / Fix: source ~/.zshrc（Mac 預設）/ source ~/.bashrc（多數 Linux）。或者重開終端。

• hermes doctor 報告 Skills registry unreachable

  原因 / Cause: GitHub raw 域名被攔或 DNS 汙染。

  修复 / Fix: 中國大陸使用者：讓 Hermes 走代理。export HTTPS_PROXY=http://127.0.0.1:7890（你本地 Clash / V2Ray 埠）後再 hermes skills sync。或在 hermes config 裡設定 skills.mirror 為社群映象。

解除安裝

Hermes 把所有東西都裝在 ~/.hermes，解除安裝乾淨一行指令搞定。

rm -rf ~/.hermes && unlink $(which hermes) 2>/dev/null

• ~/.zshrc 或 ~/.bashrc 裡安裝時追加的 export PATH 行可以手動刪掉
• LLM Provider 的 API Key 存在 ~/.hermes/config.toml，rm 之後即不可恢復，重要 Key 先備份
• 已安裝的 Skills 也都在 ~/.hermes/skills，會一起刪掉

更新到最新版

日常升級一行指令；細節（版本切換、回滾、Beta 通道）見 /cli/update 專題。

hermes update

• 預設升級到當前 Stable 通道的最新版
• hermes update --version v2026.9.14 鎖定到具體版本
• hermes update --rollback 回滾到上一個本機用過的版本
• hermes update --channel beta 切到 Beta 通道試新功能

升級前 Hermes 會自動備份 ~/.hermes/config.toml 到 ~/.hermes/backups/，不會丟配置。