2026 Hermes Agent 保姆級安裝教學：一行命令到 Telegram 7×24 常駐（macOS / Linux / Mac 雲節點）

1. 這篇安裝教學寫給誰

若你已讀過站內 三層記憶與常駐必要性，知道 Hermes 為何需要 7×24；本篇專注怎麼裝。讀者畫像包括：已在筆電上試過 curl | bash 卻卡在 Gateway 的獨立開發者、要把個人 Agent 接到 Telegram 的中小團隊技術負責人，以及評估「先 VPS 後 Mac 雲」兩段式部署的運維。全文假設你能 SSH 登入目標主機並持有至少一個 LLM 提供商 API Key；不涉及 Hermes 內部 Skill 編寫，但會指出哪些步驟必須在 macOS 上完成。目標是從 Hermes Agent 官方倉庫的一行腳本，走到手機 Telegram 能穩定對話、Gateway 在凌晨仍線上。流程涵蓋：上游 install.sh、hermes doctor 清零告警、hermes setup / hermes model 配大腦、BotFather 拿 Token、hermes gateway setup 與 hermes gateway install。硬體可以是 macOS 本機、Linux VPS，或 SSH 登入的 Mac 雲節點——不必先買 Mac mini。硬體選型與 TCO 見 樹莓派 / VPS / Mac Mini 對比。

2. 跑 curl 之前的三個痛點

1. 裝得上，Gateway 不上線。 API Key 未寫入 ~/.hermes/.env、terminal.backend 選錯、或與其他 Agent 埠衝突，導致 hermes --version 正常但 Telegram 靜默。
2. Token 三十秒搞定，程序不能睡。 BotFather 發 Token 很快；長輪詢 / webhook 要求 Gateway 程序永不掛起——筆電合蓋、家用寬頻抖動、WSL2 隨 Windows 休眠都會斷連。
3. Linux VPS「能跑」但和 macOS 工作流錯位。 Hermes 在 Linux 上支援 20+ 通道與七種終端後端，但涉及 Keychain、Xcode、Camoufox 瀏覽器自動化的 Skill 仍傾向原生 macOS 或租用 Mac 節點。

3. 環境要求（最低 vs 推薦）

無頭伺服器可加 bash -s -- --skip-browser 跳過瀏覽器自動化依賴。Windows 原生尚未完整支援，建議 WSL2 後執行 Linux 安裝腳本。

4. 平台對比：MacBook / 樹莓派 / VPS / Mac Mini 月租

表用於決定在哪台機器上執行下文 Runbook，而非要不要裝 Hermes。生產級 Telegram 橋接多數落在「Linux VPS + systemd」或「租用 Mac mini M4」——兩者都能避免通勤本機背 Gateway uptime。

5. 可引用技術參數（2026）

• 社群規模： GitHub Stars 約 17 萬+（2026-06），MIT 協議，Nous Research 維護；穩定版 v0.14.x，候選 v0.15.0。
• 安裝器： 官方 install.sh 自動裝 uv、Python 3.11、Node 22、ripgrep、ffmpeg，倉庫落在 ~/.hermes/hermes-agent/，全域 hermes 命令寫入 PATH。
• 通道與模型： 單 Gateway 可掛 20+ IM 通道；OpenRouter 等支援 300+ 模型；社群實測同類任務 Skill 命中後 token 可降約 38%（需主機長期在線累積 Skill）。
• 終端後端： 文件記載七種模式（本機 shell、Docker、SSH、Singularity、Modal、Daytona、Vercel Sandbox）；多數 Telegram 使用者先用 local，需要沙箱化工具時再切換，避免一開始就把調度複雜度拉滿。

以上數字可在站內 硬體三方案文 裡與 TCO 表交叉引用，向團隊或財務說明「為何要常開機」時更有依據。

6. 七步安裝 Runbook

步驟 1 — 選宿主與基礎套件

macOS 執行 xcode-select --install；Ubuntu/Debian 裝 curl git build-essential。建議獨立 Unix 使用者 hermes，勿與生產簽名鑰匙串混用。確認可存取 GitHub raw 與 LLM API 出口。

步驟 2 — 官方一行安裝

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc   # 或 source ~/.bashrc
hermes --version

成功標誌：✅ Hermes Agent installed at ~/.hermes。Mac 雲節點上 SSH 執行與本地完全一致。

步驟 3 — doctor 與全量精靈

hermes doctor
hermes setup

hermes doctor 自檢 Python、Node、PATH、API Key、ffmpeg 等十餘項。新手推薦 hermes setup 一次配齊；老手可用 hermes model 單獨切提供商（OpenRouter / Anthropic / Nous Portal / Ollama）。金鑰寫入 ~/.hermes/.env，例如：hermes config set OPENROUTER_API_KEY sk-or-xxxx。

步驟 4 — 首次 CLI 對話

hermes

在互動式終端試一句：「統計目前目錄檔案數」或「搜尋今日 AI 新聞並總結」，確認工具鏈與模型路由正常。

步驟 5 — Telegram（BotFather）

Telegram 搜尋 @BotFather → /newbot → 複製 Token；用 @userinfobot 查自己的數字 ID。然後：

hermes gateway setup

選 Telegram，貼上 Token 與 TELEGRAM_ALLOWED_USERS。群聊需在 BotFather 關閉 Group Privacy，並將 Bot 踢出重拉入群。也可手動寫入 ~/.hermes/.env。

步驟 6 — 安裝 Gateway 常駐服務

hermes gateway install
hermes gateway start
hermes gateway status

macOS 寫入 launchd 使用者服務；Linux 可用 sudo hermes gateway install --system 做開機自啟，日誌 journalctl -u hermes-gateway -f。

步驟 7 — 驗收冒煙

Telegram 發訊息應在一次模型 RTT 內回覆；重啟主機後再測；可選 hermes cron 做心跳。升級前加密備份整個 ~/.hermes/ 目錄。

補充：模型分層與費用控制

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

實務上建議「便宜模型做意圖分類與短答、強模型做多步 Skill」。Telegram 群裡若常觸發長工具鏈，預設路由過強會拉高帳單；在 hermes model 裡為 cron 與互動會話分開預設值，比事後限流更穩。本地 Ollama 路由在 16GB Apple Silicon 上可扛 8B–13B 輔助任務，但 Gateway 與推理同機時請預留至少 4GB 給系統與緩衝。

補充：Webhook 與長輪詢

個人 Bot 多數用長輪詢即可，無需公網 HTTPS；企業內網或固定域名環境可改 webhook 以降低延遲。無論哪種模式，進程必須 7×24——這與「是否買域名」無關。若家用 NAT 後面跑 webhook，還要額外維護反向代理與憑證輪換，維運成本常高於把 Gateway 遷到 VPS 或 Mac 雲節點。

6b. 密鑰、權限與與 OpenClaw 共存

不要把 Bot Token 與雲端 API Key 提交到公開 Git 倉庫。優先用環境變數或 macOS Keychain 可讀的部署腳本注入；Linux VPS 則限制 ~/.hermes 目錄為 700，服務帳號僅 hermes 可讀。若同一台機器還跑 OpenClaw，記住兩套 Gateway 埠不可衝突（OpenClaw 常見 18789）；Hermes 與 OpenClaw 可並存，但應在 hermes doctor 裡確認埠與 terminal.backend 未互相覆寫。生產環境建議 Telegram 只允許自己的 user id（TELEGRAM_ALLOWED_USERS），避免 Bot 被掃到後遭濫用燒額度。

遠端 Mac 雲節點上，用獨立 Unix 使用者跑 Gateway，SSH 金鑰與 Apple ID 分離；退租前執行平台提供的擦除流程並自行刪除 ~/.hermes 備份中的 Token。若你從筆電遷移到機房，先把舊機器的 launchd 服務 unload，否則兩個 Gateway 同 Token 搶更新會造成「偶發不回」的幽靈故障。

7. launchd 與 systemd 常駐

macOS（launchd）： hermes gateway install 通常寫入 ~/Library/LaunchAgents/，並帶 KeepAlive。改完通道或模型後：

hermes gateway restart
launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

日誌建議落到 ~/Library/Logs/hermes/，並用 log rotate 或平台腳本避免單檔撐滿磁碟。Screen Sharing 除錯時不要長期關閉防火牆規則——只開 SSH 與必要出站即可。

Linux（systemd）： 為使用者 hermes 開啟 linger（loginctl enable-linger hermes），再 systemctl --user enable --now hermes-gateway.service。用 systemctl --user status hermes-gateway 確認 active；SSH 斷線後也應保持運行。systemd 適合 VPS，但若 Skill 依賴 Keychain、Xcode 或 Apple 通知，仍應保留 macOS 節點處理該類任務，Linux 專心跑 Gateway 與 API 推理即可。

8. 常見報錯對照表

9. FAQ

WSL2 能裝嗎？ 可以實驗；Windows 休眠仍會讓 7×24 Telegram 不可靠，Gateway 最好跑在其他常開主機。重啟會丟 Skill 嗎？ 磁碟上 Skill 與使用者畫像仍在，僅程序內會話上下文清空——遷移前備份 ~/.hermes。必須 Telegram 嗎？ 否，hermes gateway setup 也支援 Discord、Slack 等；Telegram 因 BotFather 最快，適合作為安裝驗收通道。

9b. 從筆電遷移到機房的最小檢查清單

若你已在 MacBook 上跑通 CLI，遷移時按順序做可少踩坑：（1）在新主機重跑 install.sh 或 rsync 整個 ~/.hermes 後執行 hermes doctor；（2）BotFather Token 可沿用，但舊機 launchd 必須停用；（3）hermes gateway install 後用陌生帳號或第二支手機發測試訊息，確認不是本機殘留 session 在回覆；（4）記錄 hermes gateway status 的服務名與日誌路徑，寫進 runbook 方便值班；（5）第一次重啟後等七分鐘再測 cron，排除時區與 NTP 偏差。完成後把平台對比表裡的「24 個月成本」與實際月租帳單對一下，避免「裝得起、養不起」。

10. 結論

MacBook 一下午能跑完步驟 1–5，但合蓋與家用寬頻讓 Telegram 主機不合格。樹莓派省錢卻易 OOM；五美元 Docker VPS 在線率高卻缺 macOS 原生棧；WSL2 繼承桌面休眠策略。當你已經 curl | bash、hermes doctor 全綠、BotFather 配對成功， durable 做法只有一個：把 hermes gateway install 放在永不睡眠的硬體上——對多數讀者即 Mac mini M4 級 macOS（自購或月租）。

日常筆電、廉價 VPS、WSL2 都能完成「安裝教學」裡的命令，卻分別在合蓋斷連、無 macOS 工具鏈、桌面休眠上輸掉 7×24。租賃 VPSMAC Apple Silicon Mac 雲主機 用固定月費換機房 SLA、SSH 交付與退租擦除，安裝命令與桌面 Mac mini 相同，只是 shell 跑在機房——這是從一行 curl 到凌晨三點 Telegram 仍線上、又不必綁死通勤本的最短路徑。若你下一步要讓 Skill 越疊越厚，請回到三層記憶文做硬體決策，再用本文把 Gateway 釘死在永不睡眠的節點上。