Hermes Agent Mac 安裝指南：閘道與 OpenClaw 遷移（2026）
Hermes Agent 是 Nous Research 的開源自進化 AI 代理（github.com/NousResearch/hermes-agent，MIT）。它不是一次性聊天介面，而是執行學習閉環：精選記憶、代理自建技能、FTS5 工作階段檢索、排程 cron，以及 Telegram、Discord、Slack、WhatsApp、Signal 等訊息閘道。本指南在 Mac 上完成安裝與閘道設定——MacBook 或無外接顯示器的 Mac mini 均可，不假設你必須租用雲端主機。
為何在 Mac 上執行 Hermes
Hermes 標榜「隨處可跑」，但 macOS 仍是實用預設環境：
- 原生安裝器 — 一行
install.sh支援 macOS（及 Linux/WSL）。 - Apple Silicon — 透過
uv使用 Python 3.11、Node 工具鏈，以及ffmpeg/ripgrep。 - 閘道程序 —
hermes gateway在背景保持，便於用 Telegram 聊天；若 Mac 睡眠，閘道會中斷，除非遷到常開主機。 - OpenClaw 路徑 — 若你已在 Mac 上執行 OpenClaw，可用
hermes claw migrate從~/.openclaw匯入記憶與技能。
可引用定義：Hermes Agent 是帶持久記憶、agentskills.io 相容技能、多平台訊息閘道，以及六種終端後端（local、Docker、SSH、Singularity、Modal、Daytona）的 MIT 代理框架。
與流程層對比：Obra Superpowers 強化設計/TDD 紀律；Hermes 提供執行階段、工具與頻道——二者疊加而非互斥。
若閘道需下載較大依賴，請注意本機出口頻寬；Hermes 本身不綁定任何雲端廠商。僅在 SSH 後端指向遠端時，東京節點才特別相關。
macOS 上的架構
| 元件 | 路徑/指令 | 作用 |
|---|---|---|
| CLI | hermes 於 ~/.local/bin | 互動 TUI、斜線指令 |
| 設定 | ~/.hermes/ | 提供商金鑰、工具開關、閘道設定 |
| 閘道 | hermes gateway start | Telegram/Discord/Slack 等橋接 |
| 代理迴圈 | Python 3.11 venv（uv） | 工具呼叫、子代理、cron |
外部參考：Hermes 文件；若閘道與 Docker 後端同機執行，可依 Apple Mac mini 規格 規劃記憶體。
提供商靈活：hermes model 可在 Nous Portal、OpenRouter（200+ 模型）、OpenAI、Anthropic、NVIDIA NIM 與自訂端點間切換。
Mac 八步安裝手冊
- 步驟 1 — 前置條件 — macOS 13+；若同時開 Docker 後端與閘道，建議 16 GB 記憶體；
xcode-select --install。 - 步驟 2 — 官方安裝 —
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash，然後source ~/.zshrc。 - 步驟 3 — 驗證 CLI —
hermes doctor與hermes --version。 - 步驟 4 — 首次設定 —
hermes setup；Nous 捆綁工具可用hermes setup --portal。 - 步驟 5 — 模型與工具 —
hermes model、hermes tools。 - 步驟 6 — TUI 冒煙測試 — 執行
hermes，使用/model、/skills、/usage。 - 步驟 7 — 可選訊息閘道 —
hermes gateway setup與hermes gateway start。 - 步驟 8 — 從 OpenClaw 遷移 —
hermes claw migrate --dry-run後執行正式遷移。
若需 24/7 閘道：在備用 Mac mini 關閉睡眠，或透過 SSH 終端後端 在遠端 Mac 執行。
終端後端：本機 Mac 與 SSH
| 後端 | 適用情境 | Mac 角色 |
|---|---|---|
local | 日常 MacBook 開發 | 代理 shell 在筆電 |
docker | 可重現沙箱 | 本機 Docker Desktop |
ssh | 閘道在筆電、執行在遠端 | MacBook 控制 Mac mini 或 VPS |
modal / daytona | 工作階段間休眠 | 閒置成本低 |
詳見 工具文件。
故障排除
hermes: command not found
將 ~/.local/bin 加入 PATH 並重新載入 shell；必要時重跑 install.sh。
hermes doctor 報 Python/uv 錯誤
安裝 uv 後執行 hermes update 與 hermes doctor。
閘道已連線但無回覆
檢查日誌、bot token 與 DM 白名單；重啟 gateway。
啟用 docker 後端時請更新 Docker Desktop，避免首次工具呼叫過慢。排程任務與閘道應共用同一 ~/.hermes/ 目錄以簡化權限管理。
在 TUI 用 /usage 追蹤 token，再逐步開啟高成本工具，可避免 Telegram 訊息費用失控。
若需 24/7 回應而筆電會睡眠，可將 SSH 後端指向常開 Mac mini，無須額外購買硬體也能先以遠端主機驗證流程。
建議為閘道建立獨立 macOS 使用者，並關閉 iCloud 同步桌面，避免 FTS5 索引與個人檔案混用。完成八步安裝後，先用一則 Telegram 測試訊息確認工具輸出，再啟用其他通訊平台，可降低同時除錯的負擔。
若你同時執行多個代理，請為 hermes 保留獨立 API 金鑰與日誌目錄，避免與 OpenClaw 或其他工具的環境變數互相覆寫。完成後請保留一份設定備份。
FAQ
hermes claw migrate 可橋接兩者。hermes gateway 24/7 且筆電會睡眠時，才考慮常開的 Mac mini 或小 VPS。hermes update，再執行 hermes doctor 確認環境。