2026 Hermes Agent 保姆級安裝教學：macOS / Linux / VPS 一鍵部署 + Telegram 7×24 常駐，只看這一篇

Hermes Agent 由 Nous Research 維護，MIT 授權，文件站 hermes-agent.nousresearch.com。與一次性 CLI 工具不同，它設計為長期執行的閘道器行程：Telegram 訊息、終端機 TUI、Tool Calling、子 Agent 調度與技能 Markdown 自蒸餾共用同一核心。截至 2026 年 6 月，主分支活躍版本為 v0.15.x，安裝腳本會自動處理執行環境依賴，而非要求你手動拼 pyenv 加 nvm。

安裝成功的判準不是 hermes --version 能印出字串——而是：模型 Provider 可用、hermes doctor 全綠或僅剩可接受警告、至少一個聊天閘道器（本文以 Telegram 為例）能收發訊息，且行程在 SSH 斷線後仍由 launchd 或 systemd 拉起。若你關心記憶為何必須落在持久主機，請先讀 架構選型文；本文專注「把二進位跑起來並接上 Telegram」。

可選能力方面：Hermes 支援透過 MCP 掛載外部工具伺服器（檔案系統、瀏覽器、資料庫等），但生產最小集通常是「閘道器 + 模型 API + 本地 SQLite / Markdown 記憶路徑」。技能自進化會在任務結束後把有效流程寫入技能庫，無需額外外掛——這也是安裝後應預留數百 MB 磁碟的原因。

社群 Issue 裡最高頻的失敗模式並非編譯錯誤，而是環境碎片化與主機輪廓不匹配。下表彙總安裝階段常見卡點——對照後可少花一半除錯時間。

• 執行環境版本漂移：系統內建 Python 3.9 或 Node 16 會導致 uv 解析失敗；官方腳本目標為 Python 3.11+ 與 Node 22，混用 Homebrew 與系統 Python 時 PATH 順序錯誤尤為常見。
• 閘道器與 CLI 混淆：在筆電跑通 TUI 後闔上螢幕，Telegram Bot 立刻離線；使用者以為「安裝壞了」，實際是缺少守護行程。
• 模型 Key 與網路：hermes model 指向的 OpenRouter / Nous Portal / OpenAI 相容端點若被防火牆攔截，表現像「Agent 無回應」而非顯式 401。
• 磁碟與權限：在 Docker 無持久卷或 /tmp 清空的 VPS 上，state.db 與技能目錄每次重啟歸零，與 30 天實測 中「記憶不增反減」現象一致。
• 與 OpenClaw 堆疊並行：若團隊已在評估 OpenClaw + Ollama 本地 Agent，Hermes 更偏「多平台閘道器 + 閉環技能」；二者可同機但應分使用者與連接埠，避免爭用 11434 或閘道器監聽口。

結論很直白：安裝 Runbook 必須包含主機選型。MacBook 適合開發除錯；Telegram 7×24 生產閘道器應落在始終在線、磁碟可稽核的節點上——這也是下文推薦 NUKCLOUD Mac Mini M4 雲端租賃 的原因。

下列步驟在 macOS 14+、Ubuntu 22.04+ 與 NUKCLOUD 雲端 Mac 上均已驗證；Linux VPS 路徑相同，僅守護單元改用 systemd（見後文）。

1. 01
   準備主機與 SSH：若走雲端 Mac，先在 下單頁 選定 16GB+ 實例並在 控制台 取得 SSH；凍結 macOS / 發行版小版本號，建立專用 Unix 使用者（如 hermes），勿用 root 長期跑閘道器。
2. 02
   執行官方一鍵安裝：登入後執行下方 curl 腳本；腳本會下載 Hermes 發行包、設定 uv 虛擬環境、安裝 Python 3.11 與 Node 22 工具鏈。完成後重開 Shell 或 source 安裝器提示的 profile 片段。
3. 03
   驗證 CLI：執行 hermes --version 確認 v0.15.x；執行 hermes doctor，逐項修復紅色項——常見為缺少 API Key、state.db 目錄不可寫，或 Node 模組未 link。
4. 04
   互動式 setup：hermes setup 引導設定預設模型 Provider、記憶檔路徑與 TUI 偏好；生產環境建議把 MEMORY.md、技能目錄指向持久 Home 子目錄，而非 /tmp。
5. 05
   本地冒煙測試：hermes tui 發起一輪 Tool Calling 對話，確認模型回應與磁碟寫入；可選 hermes model list / hermes model set 切換 OpenRouter 等 200+ 模型 端點。
6. 06
   Pin 版本並備份：記錄目前 release tag；對 ~/.hermes（或 setup 指定路徑）做首次 tarball 備份。生產閘道器禁止未經 staging 直接追蹤 main 分支。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
exec $SHELL -l
hermes --version
hermes doctor
hermes setup
hermes tui

安裝後第一件事是讓模型通路穩定。hermes model 子命令（或 setup 寫入的設定檔）指定 Provider：常見為 OpenRouter API Key、Nous Portal 或自建 OpenAI 相容閘道器。切換模型不會自動遷移記憶檔——大改 Provider 前請備份 state.db 與 Markdown 記憶。

MCP（可選）：在設定中宣告 MCP Server 清單後，Hermes 可把檔案瀏覽、Git、資料庫等能力以 Tool 形式注入 Agent 迴圈。最小生產集可暫不啟用 MCP，待閘道器穩定後再加；每增一個 MCP 行程，記憶體占用約增加 100–300 MB，在 16GB 雲端 Mac 上仍可控。

技能自進化：複雜任務結束後，Hermes 將可複用流程蒸餾為 Markdown 技能檔（單條約 2,200 字元 上限，含去重）。無需額外「訓練腳本」——只要閘道器持續在線、磁碟持久，技能庫會隨使用在數週內從個位數漲到數十條。這與 三層記憶架構 第二層直接對應。

• 儲存庫熱度：GitHub Star 約 17.4 萬（2026 年 6 月，以頁面即時數為準），MIT 授權，數百貢獻者。
• 執行環境堆疊：安裝器捆綁 Python 3.11、Node 22、uv 套件管理，避免系統 Python 3.9 陷阱。
• 模型廣度：透過 OpenRouter 等可切換 200+ 模型；本地 Metal 推理需 macOS 主機，與 Linux VPS 純 API 路徑不同。

Telegram 是 Hermes 社群最常用的生產渠道：手機端發訊息，閘道器行程轉發到 Agent 核心，回覆經 Bot API 返回。設定入口為 hermes gateway setup（或文件中等價互動流程），按提示貼上 BotFather Token、可選 Webhook / 長輪詢模式，並指定監聽連接埠與日誌路徑。

macOS — launchd：在 ~/Library/LaunchAgents/ 建立 plist，ProgramArguments 指向 hermes gateway start（或文件目前子命令），KeepAlive 設為 true，StandardOutPath / StandardErrorPath 指向輪替日誌。載入：launchctl load ~/Library/LaunchAgents/com.hermes.gateway.plist。NUKCLOUD 雲端 Mac 與自購 Mini 路徑相同。

Linux — systemd：在 /etc/systemd/system/hermes-gateway.service 撰寫 Unit，User=hermes，ExecStart=/home/hermes/.local/bin/hermes gateway start，Restart=always。然後 systemctl enable --now hermes-gateway。VPS 上務必確認 出站 443 可達 Telegram API。

1. 01
   在 @BotFather 建立 Bot，複製 Token；勿提交到 Git，寫入 chmod 600 的本地 env 檔。
2. 02
   執行 hermes gateway setup，選擇 Telegram，貼上 Token，完成 Webhook 或 polling 設定。
3. 03
   前景試跑 hermes gateway start，手機向 Bot 發 /start，確認往返延遲與 Tool 呼叫日誌正常。
4. 04
   寫入 launchd plist 或 systemd unit；管理 TUI 僅走 SSH 隧道，勿將管理連接埠暴露公網。
5. 05
   模擬當機：kill 閘道器行程，確認 30 秒內自動拉起；檢查 state.db 與技能目錄仍在。
6. 06
   設定日誌輪替與磁碟告警；Telegram 渠道穩定運行 72 小時後再邀請團隊進群。

hermes gateway setup
hermes gateway start
hermes gateway status

同一套安裝指令在不同主機上的維運摩擦差異巨大。下表協助你在「先裝在哪」階段就做對選擇。

安裝與閘道器階段的常見報錯可按下表快速定位：

需要 Hermes + 可選本地 Metal 推理同機時，Linux VPS 無法替代 macOS；需要 Telegram 7×24 且不想賭家庭寬頻時，五美元 VPS 的超賣與長摘要卡頓會在使用者模型剛「變聰明」時放大當機成本。對要可稽核磁碟、靜態 SSH 邊界、還能在 Agent 空閒視窗跑 Xcode CI 的團隊，NUKCLOUD 多區域雲端 Mac Mini M4 通常是比「筆電 + 廉價 VPS」更穩的生產平面——可從 定價頁 按小時 pilot 再決定是否自購 Mini。