curl 一鍵安裝 · hermes doctor 自檢 · 模型與 Gateway · 平台對照 · 六步 Runbook
想在 2026 年跑通 Nous Research Hermes Agent（GitHub 約 17.4 萬 Star）卻卡在 PATH、API Key 或 Telegram 不回覆？本文提供手把手安裝路徑：官方 curl | bash 自動安裝 Python 3.11 / Node 22、hermes doctor 十二項自檢、hermes setup 配模型與 Gateway，再到 Telegram 7×24。結構含環境需求、部署平台對照、六步 Runbook、常見報錯表，並說明為何生產常駐更推薦 Mac Mini M4 月租。
Hermes Agent（Nous Research，MIT）是 2026 年 GitHub 熱度最高的開源 自進化 AI Agent 之一：完成一類任務後會自動產生可複用 Skill，社群口徑同類任務 token 可降約 38%；透過 Gateway 接入 Telegram / Discord / Slack 等 20+ 平台，支援 MCP 與 Claude / OpenRouter / Ollama 等多後端。與 OpenClaw、LangGraph 的差異在於：跨 Session 持久記憶（SESSION → MEMORY.md → USER.md）與原生 Skill 自動建立，且官方安裝腳本可在 $5 級 VPS 或 Mac 上跑通——但生產 7×24 與 macOS 瀏覽器類 Skill 仍更吃宿主選型。
本文不寫空泛概念，只解決安裝期五大痛點：hermes: command not found、未配 API Key、升級後設定漂移、Telegram 群組聊天無回應、以及「裝在本機合蓋就斷」的常駐難題。若你已跑通安裝並關心記憶架構，可對照三層記憶與 7×24 實測。
| 環境項目 | 最低需求 | 建議（生產 Gateway） |
|---|---|---|
| 系統 | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+（Apple Silicon）或 Ubuntu 24.04 LTS |
| Python / Node | 腳本自動安裝 3.11 / 22 | 無須手動安裝，以 hermes doctor 為準 |
| 記憶體 | 4 GB（僅 Gateway + 雲端 API） | 16 GB+；本機模型建議 32 GB UMA |
| 磁碟 | 約 1.5 GB（含 Skills 快取） | 20 GB SSD+，留 FTS5 與日誌成長空間 |
| 網路 | 可存取 GitHub raw + LLM API | 穩定低延遲，利於 IM webhook |
以為要先裝 Python/Node：官方 install.sh 用 uv 安裝 Python 3.11、Node 22、ripgrep、ffmpeg，無須 sudo。
裝完不 source Shell：PATH 未刷新導致 command not found，需 source ~/.zshrc 或新開終端機。
跳過 hermes doctor：十二項自檢能提前發現 API Key、ffmpeg、PATH 問題，比盲跑 hermes 省一小時。
無頭伺服器開瀏覽器相依：VPS 請加 --skip-browser，避免 Camoufox 類相依拉掛安裝。
本機 POC 當生產：MacBook 合蓋 Gateway 斷檔，Skill 複利無法累積；7×24 需專用宿主。
同一行 curl | bash，換宿主後差異在uptime、IO、macOS 原生路徑。安裝教學能跑通 ≠ 適合讓 Gateway 與 Skill 複利 7×24 上線——下表按「裝完 Hermes 之後」的生產體感歸納（社群與機房實測區間）。
| 平台 | 7×24 可用性 | Skill 複利 | 月成本體感 | 適合場景 |
|---|---|---|---|---|
| 個人 MacBook | ≈ 60%（合蓋即斷） | 頻繁中斷 | NT$0 硬體 + 高焦慮 | 僅 POC / 本機 CLI 試玩 |
| 樹莓派 4B 8GB | ≈ 88% | I/O 瓶頸，長任務易逾時 | 硬體一次性 | 玩票，不建議生產 Gateway |
| x86 VPS 4GB | ≈ 99.5% | 穩定，無 macOS Skill | 按量計費 | 純 API + Telegram，不要瀏覽器自動化 |
| Mac Mini M4 月租 | 機房 SLA，30 天級 100% | UMA + launchd 守護，Skill 持續累積 | 固定月租 | Telegram 7×24 + Camoufox / 本機 Ollama |
安裝只需十分鐘；選對 7×24 宿主才決定 Skill 是複利還是反覆從零開始。
M4 統一記憶體讓 Gateway（社群口徑常駐約 4.2 GB）、瀏覽器自動化與 SQLite WAL 共享位址空間；launchd 在 macOS 上比 Linux systemd 更貼合官方測試路徑。短期驗證可先租 1 個月，跑通 Telegram 與 Skill 曲線再決定自購——詳見30 天親歷。
以下步驟在 macOS / Linux / WSL2 通用；無頭 VPS 在第 1 步加 --skip-browser。資料與設定預設落在 ~/.hermes/，升級前請備份。
一鍵安裝：執行官方腳本，等待 ✅ Hermes Agent installed at ~/.hermes，然後 source ~/.zshrc（Linux 用 ~/.bashrc）。
健康檢查：hermes doctor 通過 Python、Node、ripgrep、ffmpeg、PATH；hermes --version 確認 v0.14+。
設定模型：hermes setup 或 hermes model；OpenRouter / Anthropic / Nous Portal 等寫入 ~/.hermes/.env。
CLI 冒煙測試：hermes 進入互動，下發含工具呼叫的任務（如「統計目前目錄檔案數」）確認 API 通暢。
Telegram：BotFather 建立 Bot → hermes gateway setup 選 Telegram，填 Token 與 TELEGRAM_ALLOWED_USERS；群組聊天需關隱私模式並重新邀請 Bot 入群。
7×24 守護：hermes gateway install && hermes gateway start；Linux 可用 sudo hermes gateway install --system，macOS 走 launchd 使用者服務。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc hermes doctor hermes setup hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
API Key 也可手動寫入：hermes config set OPENROUTER_API_KEY sk-or-xxxx 或追加到 ~/.hermes/.env。升級後若報設定缺失，執行 hermes config check && hermes config migrate。
下列症狀多出現在「腳本已成功但服務不可用」階段——按表逐項排除，避免同時改模型、遷移目錄與重裝 Gateway。
| 報錯 / 現象 | 常見原因 | 處理 |
|---|---|---|
| hermes: command not found | PATH 未刷新 | source ~/.zshrc 或新開終端機 |
| API key not set | 未設定 LLM | hermes model 或寫入 ~/.hermes/.env |
| Missing config after update | 版本升級設定漂移 | hermes config check && hermes config migrate |
| ModuleNotFoundError: dotenv | 誤用系統 Python | 使用 ~/.hermes/hermes-agent/venv/bin/hermes |
| Telegram 群組聊天無回應 | Bot 隱私模式 | BotFather 關 Group Privacy，踢出再重新邀請入群 |
Hermes 支援任意 MCP Server（GitHub、資料庫、瀏覽器等），在 ~/.hermes/config.yaml 宣告 mcp_servers；無頭環境 OAuth 可用 hermes mcp login + SSH 通道。生產建議先跑通單通道再疊 MCP，便於日誌二分定位。
提示：Windows 可用 PowerShell 安裝腳本，但 Dashboard /chat 終端面板相依 WSL2；建議 WSL2 + Linux 安裝路徑，與本文 Runbook 一致。
~/.hermes/hermes-agent/，全域指令由腳本寫入 PATH。hermes doctor 涵蓋約 12 項（Python 3.11、Node 22、ripgrep、ffmpeg、API Key 等）。筆電與家用 NAS 能完成安裝驗收，卻在合蓋休眠、跨區 VPS IO 與缺少 macOS 瀏覽器 Skill 上削弱 Telegram 7×24 體驗；樹莓派則難扛本機 8B 與長任務。對要把 Hermes 當「常駐同事」的團隊，Mac Mini M4 月租把 uptime、UMA 與 launchd 打包成可預期 OpEx——比重複重裝更省時間。
若你已完成本文 Runbook 並需要生產級 7×24 節點，VpsMesh 提供 Mac Mini M4 雲端租用：SSH 交付、面板看資源、退租前可備份整個 ~/.hermes/。方案見 Mac Mini M4 租用價格，部署問題見 雲端說明中心，線上下單見 訂購頁。
注意：勿在同一週末同時換宿主、升級 Hermes 大版本、改 Telegram 白名單——三項並行無法二分定位。先 hermes gateway status 穩定 24h，再動模型或 MCP。
不需要。官方 install.sh 透過 uv 安裝 Python 3.11、Node.js 22、ripgrep 與 ffmpeg，儲存庫位於 ~/.hermes/hermes-agent/。安裝後執行 source ~/.zshrc 並執行 hermes doctor 驗收十二項檢查。
預設隱私模式下群組聊天只回應 / 指令。在 BotFather → Bot Settings → Group Privacy 選擇 Turn off，並將 Bot 踢出群組後重新邀請。同時確認 TELEGRAM_ALLOWED_USERS 含你的數字 ID，且 hermes gateway status 為執行中。