macOS / Linux 一鍵部署 · hermes doctor · LLM 設定 · Gateway 7×24 · 遠端 Mac 驗收
誰會遇到這個問題？你已在 GitHub 上看到 Nous Research 的 Hermes Agent（截至 2026 年 6 月約 17 萬 Star），想從零裝通 CLI、接上 LLM、再用 Telegram 隨時喚醒——卻在 PATH、API Key 或 Gateway 隱私模式上卡住。結論：按官方 curl | bash 裝好後，用 hermes doctor 驗收，再配 Gateway 背景服務即可 7×24 常駐；生產環境建議租用 Mac Mini M4，避免合蓋斷線。本文結構：環境需求 → 一鍵安裝 → 驗證與 LLM → Telegram → Skill 機制 → 錯誤對照表 → 平台選型 → FAQ。
Hermes Agent 是 Nous Research 在 MIT 授權下開源的「自進化 AI Agent」：完成任務後會把成功路徑封裝為可重用的 Skill，下次同類任務的 token 消耗可下降約 38%（社群 30 天實測：Skill 數 3→19）。它透過 Gateway 接入 Telegram、Discord、Slack、WhatsApp 等 20+ 平台，並支援 MCP Server 擴充。
與站內常寫的 OpenClaw 相比：OpenClaw 在中文 IM 與企業整合案例較多；Hermes 強調 Nous 模型生態、三層記憶（SESSION → MEMORY.md → USER.md）與 Skill 自動沉澱。CrewAI / LangGraph 更偏編排框架，Hermes 則是「裝完即用」的常駐 Agent 產品。若你已讀過「為何需要 7×24 Mac」選型文，本文專注怎麼裝、怎麼配、怎麼跑通。
2026 年 6 月前後，社群討論集中在三件事：安裝腳本是否涵蓋依賴、Gateway 能否以 systemd / launchd 守護，以及Telegram 群組隱私模式導致「Bot 在線卻不回訊息」。本文依真實工單順序編排，避免只貼官方 README 卻跳過驗收步驟。若你同時在評估 OpenClaw，請記住兩套產品的 CLI 與設定目錄互不通用，但「遠端 Mac + VNC 過權限」的部署節奏相近。官方文件入口：hermes-agent.nousresearch.com/docs/getting-started/installation；GitHub 倉庫 NousResearch/hermes-agent 可作版本核對來源，升級前建議先 git -C ~/.hermes/hermes-agent log -1 --oneline 留檔。
安裝門檻被低估：以為要自裝 Python 3.11、Node 22、ripgrep——官方腳本已打包。
大腦未設定：沒跑 hermes setup 或寫入 ~/.hermes/.env，CLI 能進但推論失敗。
Gateway 只前景執行：關掉終端機 Telegram 就失聯，未 gateway install 成 launchd / systemd 服務。
群組隱私模式：Bot 在群裡只回應 / 指令，需在 BotFather 關閉 Group Privacy 並重新入群。
官方安裝腳本會偵測系統並自動補齊依賴；下表幫你判斷「這台機器夠不夠跑」，以及是否該走雲端 API 而非本機模型。
| 項目 | 最低需求 | 建議配置 |
|---|---|---|
| 作業系統 | 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（僅 Gateway + 雲端 API） | 16 GB（本機 Ollama / 瀏覽器自動化） |
| 磁碟 | 約 1.5 GB（含 Skills 快取） | 20 GB SSD+（本機模型權重） |
| 網路 | 可存取 GitHub raw + LLM API | 穩定低延遲出口（Telegram 長連線） |
可引用結論：① 不必手動安裝 Python / Node / ripgrep / ffmpeg。② 無 GUI 的 Linux VPS 安裝時加 --skip-browser 略過瀏覽器自動化元件。③ Windows 原生支援仍屬 Beta，優先 WSL2 + Linux 安裝腳本。
在終端機執行官方安裝指令（以 NousResearch/hermes-agent 倉庫 main 分支腳本為準）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
腳本會自動完成：安裝 uv → Python 3.11 → Node.js 22 → ripgrep、ffmpeg → Clone 到 ~/.hermes/hermes-agent/ → 設定全域 hermes 指令 → 拉取預設 Skills 註冊表。成功標誌為終端機輸出 ✅ Hermes Agent installed at ~/.hermes。
執行 source ~/.zshrc（macOS）或 source ~/.bashrc（Linux）重新載入 PATH。
無 GUI 的伺服器：curl ... | bash -s -- --skip-browser。
執行 hermes doctor，確認 12 項健康檢查通過。
執行 hermes setup 設定 LLM（見第四節）。
在租用遠端 Mac上首次安裝時，用 VNC 處理可能出現的系統權限彈窗（螢幕錄製／輔助使用），純 SSH 可能無法點選「允許」。
Windows PowerShell：iex (irm .../install.ps1)，倉庫落在 %LOCALAPPDATA%\hermes\；Dashboard /chat 終端面板建議 WSL2。Termux 執行同一條 curl | bash，腳本會偵測環境切換流程。
若你已在 VNCMac 開通節點，建議流程為：VNC 登入 → 開啟「終端機」→ 執行安裝腳本 → hermes doctor 截圖留檔 → hermes setup 配 API → 再改以 SSH 日常維運。原因很實際：macOS 首次允許「終端機」存取檔案、磁碟或自動化時，在圖形工作階段點一次「允許」，比 SSH 盲猜 TCC 失敗省好幾小時。安裝目錄 ~/.hermes/ 包含 Skill、SQLite 工作階段庫與 .env，退租前用 tar czf hermes-backup.tgz ~/.hermes 打包即可遷移到下一台機器。
hermes doctor hermes --version hermes setup # 全向導，推薦新手 # 或單獨：hermes model
| 供應商 | 特點 | 設定方式 |
|---|---|---|
| Nous Portal | 零設定訂閱，300+ 模型 | hermes setup --portal OAuth |
| OpenRouter | 多模型實驗 | API Key → ~/.hermes/.env |
| Anthropic / OpenAI | Claude / GPT 系列 | API Key 或 OAuth |
| Ollama / vLLM | 本機推論 | Base URL + Key；需 16GB+ 記憶體 |
寫入 Key 範例：hermes config set OPENROUTER_API_KEY sk-or-xxxx 或 echo 'OPENROUTER_API_KEY=...' >> ~/.hermes/.env。設定完成後執行 hermes 進入互動 CLI，試一句「幫我整理今天 AI 新聞」驗證推論鏈路。若 API 回傳 429，多半是免費額度或速率限制，可暫時改 OpenRouter 上的較輕模型，或改用 Nous Portal 訂閱路由，避免 Gateway 常駐時因單次爆量把整條 Telegram 對話鏈路打掛。
在 Telegram 找 @BotFather，/newbot 建立 Bot，保存 Token。
向 @userinfobot 發訊息取得你的數字 User ID。
執行 hermes gateway setup，選 Telegram，貼上 Token 與 ID；或手動寫入 TELEGRAM_BOT_TOKEN、TELEGRAM_ALLOWED_USERS。
測試：hermes gateway 前景執行，手機傳訊給 Bot。
上線環境：hermes gateway install && hermes gateway start；macOS 用 launchd，Linux 可用 sudo hermes gateway install --system。
群組必讀：預設 Bot 有隱私模式，群內只回應 / 指令。需在 BotFather → Group Privacy → Turn off，並將 Bot 移出群組後重新邀請才會生效。
驗收清單（約 15 分鐘）：① 私訊 Bot 收到回覆；② hermes gateway status 顯示 running；③ 重開節點後服務自動拉起（驗證 launchd / systemd）；④ 日誌無連續 401 / 429（API 額度或 Key 錯誤）。Linux 生產機可用 journalctl -u hermes-gateway -f 追蹤；macOS 租用節點可在 VNC 開啟「主控台」篩選 hermes 相關項目。
| 指令 | 用途 |
|---|---|
| hermes | 互動對話 |
| hermes tools | 管理啟用工具 |
| hermes gateway status | 查看 Gateway 服務狀態 |
| hermes update | 更新至最新版 |
| hermes config check | 設定完整性檢查 |
Skill 機制：任務成功後 Hermes 將流程寫入 ~/.hermes/skills/，下次優先命中。前提是主機 7×24 在線——筆電合蓋、VPS 休眠都會打斷複利。MCP 可在 ~/.hermes/config.yaml 宣告 mcp_servers（如 GitHub Server），headless 環境用 hermes mcp login + SSH 隧道完成 OAuth。
若你計畫接 GitHub MCP，請為 Token 單獨建立唯讀或最小權限 PAT，不要把生產倉庫的 admin 權限交給實驗 Agent。瀏覽器自動化類 MCP（如 Camoufox）在 macOS 上路徑最完整；純 Linux VPS 可能缺少部分依賴，這與 Hermes 官方在 Apple Silicon 上測試最充分的現況一致——也是許多團隊最終把 Gateway 遷到 Mac Mini 的原因之一。
| 錯誤／現象 | 原因 | 處理 |
|---|---|---|
| hermes: command not found | PATH 未更新 | source ~/.zshrc 或新終端機 |
| API key not set | 未設定 LLM | hermes model / 編輯 .env |
| Missing config after update | 版本升級偏移 | hermes config migrate |
| ModuleNotFoundError: dotenv | 用了系統 Python | 確認使用 ~/.hermes/.../venv/bin/hermes |
| Telegram 群組無回應 | 隱私模式 | BotFather 關隱私 + 重新入群 |
| 平台 | 7×24 可用性 | Skill 複利 | 適合對象 |
|---|---|---|---|
| 個人 MacBook | ≈60%（合蓋斷線） | 易中斷 | 僅 POC |
| x86 VPS 4GB | ≈99.5% | 穩定，無 macOS 專屬 Skill | 純 Linux 使用者 |
| Mac Mini M4 月租 | 機房 SLA | launchd 守護 + UMA | 要 Telegram 常駐的生產使用者 |
自購 Mac Mini M4 16GB 約 NT$18,000 起（人民幣 ¥4,499 換算僅供參考），攤到 24 個月約每月 NT$750–900，但需自負電費、寬頻與機房級斷電風險。VNCMac 月租把 CapEx 轉成 OpEx：不確定 Hermes 能否每天替你省 2 小時時，先租 30 天跑通 Gateway + Skill 複利，再決定是否買斷。M4 統一記憶體在 Gateway 常駐約 4.2 GB、瀏覽器自動化與 SQLite WAL 同址尋址時，比 4GB x86 VPS 更不易 swap 抖動——對 Telegram 長連線與定時 Heartbeat 很關鍵。實務上許多團隊會把「開發機」留在筆電，把「常駐 Gateway + Skill 庫」放在租用 M4，兩邊用同一份 ~/.hermes 備份 tarball 同步，避免在 POC 與生產之間反覆重裝。
不需要。官方 install.sh 透過 uv 安裝 Python 3.11、Node 22 及 ripgrep、ffmpeg。
安裝與 Gateway 設定多數步驟可 SSH；首次 macOS 隱私授權、部分 OAuth 瀏覽器回呼建議開 VNC，與站內 OpenClaw 遠端 Mac 經驗一致。
入口仍為官方 install 腳本；升級用 hermes update，若設定遷移報錯執行 hermes config check && hermes config migrate。
主題 100講「為何 7×24 + 記憶架構 + 租用 TCO」；本文講「安裝設定實操」。先裝通再選型較順。
Hermes Agent 的安裝本身並不神秘：一條官方腳本、一次 hermes doctor、一套 .env、一個常駐 Gateway。真正拉開差距的是主機能否 7×24 在線——Skill 複利、Telegram 隨時可達、跨工作階段記憶寫入，都依賴程序與磁碟持續可用。
筆電合蓋、家用 Wi‑Fi 抖動，或 $5 VPS 在尖峰被限速，都會讓「越用越聰明」退化成「每次重裝的新同事」。自購 Mac Mini M4 適合已驗證全年常駐的使用者；仍在評估階段時，按月租用實體 M4 節點用 SSH 裝 Hermes、用 VNC 過權限驗收，退租前備份 ~/.hermes/ 即可遷移——比先花大筆買斷更省決策成本。
裝通 Hermes 只是第一步，讓它一直跑著才是價值所在。下方進入Mac Mini M4 月租套餐，為 Gateway 與 Skill 準備一台永不停歇的 macOS 主機。