適合誰：已在 GitHub 上看到 Hermes Agent 逼近 17 萬 Stars，卻卡在「裝完找不到指令 / Telegram 不回訊息 / 升級後設定遺失」的開發者，要在 macOS、Linux 或 WSL2 上當天跑通 v0.15.x 並接上 Telegram 7×24。你會得到：可複製的一鍵安裝、hermes doctor 驗收、模型與 Gateway 設定、常見報錯對照，以及常駐主機選型。結構：安裝痛點 → 環境表 → 八步 Runbook → 硬數據 → 平台對照 → 收束與 FAQ。概念與硬體可先看 三層記憶體架構文，首月體驗見 30 天實測文。
2026 年 5 月底，Nous Research 將 Hermes 推到 v0.15.2，並同步提供 pip install hermes-agent 與經典 curl | bash 雙軌。社群熱度高，但安裝文常略過下列「真實卡點」：
hermes 寫入 ~/.zshrc，未 source 就報 command not found——最常見，也最容易誤判為「安裝失敗」。python3 -m hermes 可能缺 dotenv；正確進入點是 ~/.hermes/hermes-agent/venv/bin/hermes。API key not set，因跳過 hermes setup / hermes model。hermes gateway 長時間程序；只跑 hermes 對話，手機端永遠收不到回覆。/ 指令；未在 BotFather 關 Group Privacy 就以為「Bot 壞了」。hermes config check && hermes config migrate，否則出現 Missing config after update。與 OpenClaw 的一句話差異：OpenClaw 強在多通道 Gateway 與 npm/Compose 維運生態；Hermes 強在跨工作階段 MEMORY.md / USER.md、任務後自動沉澱 Skill 與 MCP 擴充。本篇只解決「裝得上、連得上、守得住」；架構與 TCO 請讀上文兩篇 Hermes 系列文。
若你為團隊評估 Agent，請先拆開三個問題：能否在我們的作業系統基線上安裝？能否接上資安核准的 LLM？能否讓 Gateway 在週末與夜間仍存活？本 Runbook 前兩項可在一個下午內驗證；第三項正是 MACCOME 同時發布主機對照表的原因。
官方安裝腳本會自動處理 Python 3.11（via uv）、Node.js 22、ripgrep、ffmpeg；你只需確保 git 可用，且能連線 GitHub raw 與所選 LLM API。無需瀏覽器自動化的無頭伺服器可加 --skip-browser，略過 Camoufox 相關依賴以節省磁碟與記憶體。
遠端 Mac 節點與本機操作相同：SSH 登入後貼上相同指令，驗證通過再以 launchd 或 systemd 常駐 Gateway。對雲端路由模型而言，到 API 區域的延遲比 CPU 品牌更重要；多個 Gateway 與瀏覽器 Skill 並行時，統一記憶體架構較順。
WSL2 需特別注意：請把 Hermes 目錄放在 WSL 內的 ext4，不要放在 /mnt/c，否則檔案監聽與 SQLite WAL 在 DrvFS 下容易異常。驗證 Gateway 過夜時請關閉 Windows 睡眠，許多「Linux Gateway 壞了」其實是主機讓 WSL 休眠。超出此限制後，可把整包 ~/.hermes 搬到原生 Linux VPS 或租賃 Mac，無需重裝只要權限正確。
| 項目 | 最低 | 建議（生產 Gateway） |
|---|---|---|
| 系統 | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS |
| 記憶體 | 4 GB（僅雲端 API + Gateway） | 16 GB（瀏覽器自動化 + 多 Skill 快取） |
| 磁碟 | 約 1.5 GB（含 Skills） | 20 GB SSD（日誌 + SQLite WAL） |
| 網路 | 可存取 GitHub raw | 穩定、低延遲的 LLM API 出口 |
| Windows | PowerShell 原生腳本（Early Beta） | WSL2 + Linux 一鍵腳本（官方最穩路徑） |
無頭伺服器：不需要瀏覽器自動化時，安裝腳本加上 --skip-browser 可節省磁碟與記憶體。
以下步驟在 macOS / Linux / WSL2 通用；請逐步驗收，跳過 hermes doctor 往往比執行它更耗時。
~/.hermes。source ~/.zshrc（或 source ~/.bashrc），或開新分頁。hermes doctor 自檢約 12 項；hermes --version 應為 v0.15.x。hermes setup；已有 Key 用 hermes model 或寫入 ~/.hermes/.env。hermes，請它列出目前目錄檔案，確認工具鏈可呼叫。@BotFather → /newbot → 保存 Token；用 @userinfobot 取得數字 ID。hermes gateway setup 選 Telegram；或手動設定 TELEGRAM_BOT_TOKEN 與 TELEGRAM_ALLOWED_USERS。hermes gateway；生產用 hermes gateway install && hermes gateway start。第八步是「已安裝」變「已上線」。前景 Gateway 在 SSH 斷線後會結束，除非用 tmux；macOS 使用者層級服務在正確安裝後可撐過登出。啟動後請先對 Bot 發私訊再測群組，可避開群組隱私與 allow-list 兩個變因。
日常工具呼叫與多模型實驗：OpenRouter 仍最省事；企業 Claude 走 Anthropic API/OAuth；零設定可試 Nous Portal（hermes setup --portal）。本機隱私場景對接 Ollama 時在 hermes model 填 Base URL。v0.15 另支援 Grok 與 x_search——在 hermes tools 只啟用任務需要的工具以控制 context。
Telegram 補充：Token 勿提交 git；TELEGRAM_ALLOWED_USERS 必須是純數字 ID，不是 @帳號。多環境請用不同 Bot，避免 staging 寫入 production 的 ~/.hermes。
# 官方一鍵安裝（macOS / Linux / WSL2） curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # 無頭伺服器可選 # curl -fsSL .../install.sh | bash -s -- --skip-browser source ~/.zshrc hermes doctor hermes setup # Telegram Gateway（互動精靈） hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
# Linux 系統層級 Gateway（開機自啟，需 root） sudo hermes gateway install --system sudo hermes gateway start --system journalctl -u hermes-gateway -f
Stars 代表關注度，不代表你的 Gateway 已穩定。對管理層簡報時，請把 38% 重複任務節省與Gateway 可用率、Telegram 回應延遲並列，而非只秀 trending。內部可連結 30 天實測文 與 架構文 說明為何常駐後 MEMORY.md 與 SQLite 才會同時發揮作用。
首週支援可先查下表；對不上時請先擷取 hermes doctor 與 Gateway 日誌再開 Issue。
| 報錯 / 現象 | 原因 | 處理 |
|---|---|---|
hermes: command not found |
PATH 未載入 | source ~/.zshrc 或新終端機；確認 which hermes |
API key not set |
未設定 LLM | hermes model / 寫入 ~/.hermes/.env |
Missing config after update |
升級遷移未完成 | hermes config check && hermes config migrate |
No module named 'dotenv' |
誤用系統 Python | 使用 venv 內 hermes 執行檔 |
| Telegram 群組無回應 | 隱私模式 / 未重邀入群 | BotFather 關 Group Privacy，踢出再拉入 |
| Gateway 啟動即退出 | Token 或使用者 ID 錯誤 | TELEGRAM_ALLOWED_USERS 為純數字 ID |
| 連線 LLM 被拒 | Proxy 或區域封鎖 | 用 curl 測 API；暫時繞過公司 Proxy 診斷 |
| Skills 權限錯誤 | sudo 安裝後擁有者不對 | chown -R $USER ~/.hermes |
| 瀏覽器工具卡住 | 無頭機缺 Camoufox | 重裝勿加 --skip-browser 或關閉瀏覽器工具 |
| venv 衝突 | pip 與 curl 混裝 | 二選一安裝路徑，刪除另一棵目錄樹 |
| WSL2 夜間 Gateway 斷 | Windows 睡眠 | 關閉主機睡眠；改專用 Linux 或 Mac 節點 |
| SQLite WAL 磁碟暴漲 | 長期工作階段累積 | 備份後依文件清理舊 sessions |
裝通 Hermes 只解決「能跑」；Telegram 生產與 Skill 複利解決「能一直跑」。桌上 MacBook 適合本文前五步；第八步要撐過差旅與合蓋就不適合。VPS 解決可用性，但可能缺少 macOS 原生安裝路徑與 Camoufox 瀏覽器 Skill。樹莓派可跑 Gateway，長任務常因 I/O 逾時。MACCOME 的 Mac Mini M4 租賃 鎖定交集：真實 macOS、機房電力、與本文一致的 launchd 模式。
財務比較租賃與自購時，請把電費、冷卻、固定 IP、實體風險與你親自 on-call 更新 macOS 的工時算進 TCO，而非只看硬體牌價。試點成功後仍可自購；許多團隊讓生產 Gateway 留在租賃節點，筆電只當 SSH 用戶端。
| 平台 | 7×24 可用性 | Skill 複利 | 適合 |
|---|---|---|---|
| 個人 MacBook | 合蓋即斷（約 60%） | 頻繁中斷 | POC、當日除錯 |
| x86 VPS 4GB | 約 99.5% | 穩定但缺 macOS 原生路徑 | 純 Linux、無 Camoufox 需求 |
| 樹莓派 4B 8GB | 約 88% | I/O 瓶頸、長任務易逾時 | 玩票，不建議生產 Gateway |
| 租賃 Mac Mini M4 | 機房 30 天在線目標 | launchd + 統一記憶體 | Telegram 生產 + macOS Skill 路徑 |
依本文八步，多數讀者可在 30–60 分鐘 內完成 Hermes CLI 與 Telegram Gateway 首通（前提是 API Key 已獲核准）。之後的失敗多半不是「又裝壞了」，而是營運問題：筆電睡眠、輪替 Token 未重啟 Gateway、或瀏覽器 Skill 載入時記憶體不足。
三條替代路徑的短板也很明確：(a) 筆電無法可靠 7×24；(b) 低配 x86 VPS 缺少 macOS 上最省心的安裝與 Camoufox 路徑；(c) 自購 Mac Mini 把 Capex、家用寬頻與實體維運全壓在自己身上。
若 Hermes 已替你省下重複勞動，又希望 固定月費、十分鐘 SSH 上崗、退租前可打包 ~/.hermes/，MACCOME 獨占 Mac Mini M4 雲端節點通常是更優的生產形態。請續讀 架構決策文、30 天實測文，並在 租賃價格頁 依區域下單。
常見問題
Hermes Agent 和 OpenClaw 能裝在同一台 Mac 上嗎？
可以，但設定目錄分離（~/.hermes vs ~/.openclaw），注意記憶體與磁碟。若要 7×24 Hermes Gateway，建議專用主機或 租賃節點，不要與每日合蓋的筆電共用。
v0.15 可以用 pip 安裝嗎？
可以：pip install hermes-agent && hermes。仍建議首次跑 hermes doctor。git 安裝腳本與 pip 二選一，避免混用兩套 venv。
Gateway 日誌在哪裡看？
前景模式看終端機；systemd 用 journalctl -u hermes-gateway -f；macOS 用 hermes gateway status。更多維運見 協助中心。
退租前如何遷移 Hermes 資料？
打包整個 ~/.hermes/（含 skills/、memories/、sessions SQLite）即可在新機還原。MACCOME 退租前支援自助清機；遷移步驟見協助中心。