hermes doctor 驗收環境；③ hermes setup 接 LLM；④ hermes gateway install 實現 7×24。結構含環境矩陣、六步 Runbook、報錯表與宿主選型。
2026 為什麼要裝 Hermes Agent？和 OpenClaw 差在哪
很多人搜「開源 AI Agent 教學」時，會在 Hermes Agent、OpenClaw、LangGraph、CrewAI 之間猶豫。一句話區分：Hermes 偏「住在你機器上的個人值班員」——預設把 USER.md / MEMORY.md / Skill 寫在 ~/.hermes，Gateway 負責渠道；OpenClaw 更強調多頻道閘道與 ClawHub 技能生態；LangGraph / CrewAI 更像編排框架，要自己拼記憶與部署。
自進化 Skill：同類任務再次出現時優先載入 ~/.hermes/skills/，社群實測 30 天內 Skill 從個位數漲到十餘個時，同類任務 token 可降約 38%（非品質分，僅供參考）。
模型無關：Anthropic、OpenAI、OpenRouter、GitHub Copilot、Ollama 均可，金鑰寫在 ~/.hermes/.env。
MCP 擴展：相容 Model Context Protocol，可掛 GitHub、瀏覽器自動化等 Server。
Hermes Agent 安裝環境要求：macOS、Linux、VPS 怎麼選
| 項目 | 最低要求 | 推薦（生產 Gateway） |
|---|---|---|
| 系統 | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）或 Ubuntu 24.04 LTS |
| Python / Node | 腳本自動安裝 3.11 / Node 18+ | 腳本預設 Node 22，無需 sudo |
| 記憶體 | 4 GB（僅 API + Gateway） | 16 GB（瀏覽器自動化 + 本地 7B 回落） |
| 磁碟 | 約 1.5 GB（含 Skills 快取） | ≥ 20 GB SSD |
| 網路 | 可存取 GitHub raw + LLM API | 穩定低延遲出口 |
| 宿主場景 | 7×24 可用性體感 | 適合階段 |
|---|---|---|
| 筆電合蓋 | ≈ 60%，Skill 複利易斷 | 僅 POC |
| x86 VPS 4GB | ≈ 99.5%，無 macOS 專屬 Skill 路徑 | 純 Linux 使用者 |
| Mac Mini M4 月租 | 機房 SLA，launchd 原生守護 | Telegram 生產、Camoufox 自動化 |
Hermes Agent 完整安裝：六步 Runbook（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
無頭伺服器可跳過瀏覽器依賴：bash -s -- --skip-browser。腳本會安裝 uv、Python 3.11、Node 22、ripgrep、ffmpeg，並將倉庫放到 ~/.hermes/hermes-agent/，全域命令 hermes 寫入 PATH。成功標誌：✅ Hermes Agent installed at ~/.hermes。
執行安裝腳本：上文 curl 命令；Windows 可用 PowerShell 版 install.ps1，但生產仍推薦 WSL2 + Linux 腳本。
重新載入 Shell：source ~/.zshrc 或 source ~/.bashrc，解決 hermes: command not found。
健康檢查：hermes doctor 自檢 Python、Node、ripgrep、ffmpeg、PATH、API Key 等約 12 項；hermes --version 確認 v0.14.x / v0.15 候選。
設定大腦：hermes setup 全流程向導，或 hermes model 單獨選 OpenRouter / Anthropic / Ollama；金鑰寫入 ~/.hermes/.env，例如 hermes config set OPENROUTER_API_KEY sk-or-xxxx。
CLI 冒煙：執行 hermes，試「總結今日 AI 新聞」或「統計目前目錄檔案數」，確認工具呼叫與模型路由正常。
升級與遷移：日常 hermes update；若升級後報設定缺失，執行 hermes config check && hermes config migrate。
Hermes Agent Telegram 接入：BotFather 到 gateway install
裝完 CLI 只解決「本機對話」；要在手機上隨時派活，需要 Gateway。流程：在 Telegram 找 @BotFather → /newbot → 儲存 Token → 用 @userinfobot 查自己的數字 ID。
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
互動向導會寫入 TELEGRAM_BOT_TOKEN 與 TELEGRAM_ALLOWED_USERS。Linux 生產可 sudo hermes gateway install --system 並用 journalctl -u hermes-gateway -f 看日誌；macOS 用 launchd 使用者服務即可。
| 報錯 / 現象 | 原因 | 處理 |
|---|---|---|
hermes: command not found | PATH 未載入 | 重開終端機或 source rc 檔 |
API key not set | 未設定 LLM | hermes model |
| 群聊不回覆 | Bot 隱私模式 | BotFather 關 Group Privacy，踢出再拉入群 |
ModuleNotFoundError: dotenv | 誤用系統 Python | 用 ~/.hermes/hermes-agent/venv/bin/hermes |
提示：常用命令還包括 hermes tools、hermes config check；MCP 可在 ~/.hermes/config.yaml 宣告 mcp_servers，headless 環境用 hermes mcp login + SSH 隧道完成 OAuth。
安裝之後：Skill 複利與 Mac Mini M4 宿主硬數據
Star 規模：截至 2026 年 6 月，hermes-agent 約 174,720 Star，安裝與 Telegram 文件迭代以 macOS 路徑最完整。
功耗：M4 閒置約 4–6W，Gateway + 自動化典型 15–25W，適合常年開機。
統一記憶體：16GB UMA 下 Gateway 常駐約 4GB 級，與 Camoufox、SQLite WAL 共享位址空間，較 x86 小 VPS 更少 swap 抖動。
筆電合蓋、樹莓派 I/O 瓶頸、純 Linux VPS 缺 macOS 瀏覽器 Skill——這些不是「安裝失敗」，而是宿主選錯導致 Gateway SLA 不達標。若你要讓 Hermes 在 Telegram 上 7×24 接單並持續寫 Skill，MESHLAUNCH 的 Mac Mini M4 雲端裸機月租通常是更優解：SSH 與本地同款 curl 安裝、launchd 守護、退租前可打包 ~/.hermes 遷移。先看租用價格頁按日試跑，維運邊界見雲端說明中心。