2026 Hermes Agent 保姆級安裝部署指南:
一鍵安裝、Telegram 7×24 接入與 Mac Mini 常駐選型

2026 年 Hermes Agent(Nous Research,GitHub 約 17 萬星)成了開源圈最熱的自進化 AI Agent之一——能跨工作階段記憶、自動沉澱 Skill、並透過 Gateway 接入 Telegram 等 20+ 平台。若你卡在「裝不上、配不好 Key、Telegram 沒回執」,這篇就是寫給你的:一條命令完成環境,再用六步 Runbook 跑到 hermes gateway 7×24 常駐,並對比 MacBook / VPS / Mac Mini M4 月租 誰更適合當生產主機。

01

為什麼 2026 年都在裝 Hermes Agent?和 OpenClaw 差在哪

Hermes Agent 不是聊天殼,而是 MIT 協議下的常駐自主 Agent:完成一類任務後會自動產生可複用 Skill(社群實測同類任務 token 可降約 38%),並透過 SESSION → MEMORY.md → USER.md 三層記憶跨工作階段延續上下文。與偏「編排框架」的 LangGraph / CrewAI 或偏「渠道閘道」的 OpenClaw 相比,Hermes 的差異化在於原生 Skill 自進化 + 跨 Session 持久記憶 + 一條 curl 裝完全棧

本文不重複「為什麼要換 Mac」(見站內 VPS 遷移實測)或「記憶架構拆解」(見 三層記憶硬體文),而是專注安裝部署 Runbook:macOS / Linux / WSL2 一鍵腳本、hermes doctor、LLM 設定、首次對話、Telegram Bot 與 Gateway 守護程序。

  1. 01

    痛點:文件分散,新手不知道先裝依賴還是先配 API Key。

  2. 02

    痛點:裝完 hermes: command not found,其實是 PATH 未刷新。

  3. 03

    痛點:Telegram 能私聊、群聊沒反應——隱私模式與入群順序踩坑。

  4. 04

    痛點:筆電合蓋 Gateway 斷線,Skill 複利被打斷。

  5. 05

    痛點:無頭 VPS 缺 macOS 瀏覽器自動化路徑(Camoufox 等)。

  6. 06

    本文交付:從 curl 到 hermes gateway start 可驗收的六步清單。

02

環境要求:你不需要手動裝 Python 和 Node.js

官方 install.sh 會透過 uv 拉 Python 3.11、Node.js 22、ripgrep、ffmpeg,並把倉庫 clone 到 ~/.hermes/hermes-agent/。下表是規劃容量時的參考(資料整理自 Nous Research 安裝文件與社群部署經驗,2026-06)。

項目最低要求推薦(7×24 + Gateway)
系統macOS 12+ / Ubuntu 20.04+ / WSL2macOS 14+(Apple Silicon)或 Ubuntu 24.04 LTS
記憶體4 GB(僅 Gateway + 雲端 API)16 GB;本機推理建議 32 GB
硬碟約 1.5 GB(含 Skills 快取)20 GB SSD+
網路可存取 GitHub raw 與 LLM API穩定低延遲出口(Telegram 體驗更明顯)

「裝 Hermes 最難的一步,往往不是命令本身,而是選一台不會合蓋、不會半夜掉線的機器。」

03

六步落地:從一鍵安裝到 Telegram Gateway 常駐

bash
# 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   # 或 source ~/.bashrc
  1. 01

    安裝並刷新 PATH:看到 ✅ Hermes Agent installed at ~/.hermes 後執行 source ~/.zshrc,新開終端機再跑 hermes --version

  2. 02

    健康檢查:hermes doctor 自檢 Python、Node、ripgrep、ffmpeg、PATH 與 API Key 等約 12 項;報錯按提示補齊。

  3. 03

    設定 LLM:新手跑 hermes setup;或 hermes model 選 OpenRouter / Anthropic / OpenAI / Ollama 等,Key 寫入 ~/.hermes/.env(例:hermes config set OPENROUTER_API_KEY sk-or-xxxx)。

  4. 04

    首次對話:執行 hermes 進入 CLI,試任務如「總結今日 AI 新聞」或「統計目前目錄檔案數」,確認工具鏈正常。

  5. 05

    Telegram Bot:在 @BotFather /newbot 拿 Token;用 @userinfobot 查你的數字 ID;hermes gateway setup 選 Telegram 貼上,或寫入 TELEGRAM_BOT_TOKENTELEGRAM_ALLOWED_USERS

  6. 06

    7×24 守護:測試 hermes gateway 後執行 hermes gateway install && hermes gateway start;macOS 用 launchd,Linux 可用 sudo hermes gateway install --system + systemd。

群聊必讀:Telegram 隱私模式

預設 Bot 在群裡只回應 / 命令。若要在群聊 @ 機器人工作,需在 BotFather 關閉 Group Privacy,並把 Bot 踢出群後重新邀請——這是生產環境最高頻的「裝好了但不說話」原因。

warning

常見報錯:API key not set → 重新 hermes modelModuleNotFoundError: dotenv → 確認用的是 ~/.hermes/hermes-agent/venv/bin/hermes 而非系統 Python;升級後設定漂移 → hermes config check && hermes config migrate

04

部署平台怎麼選?MacBook、樹莓派、VPS 與 Mac Mini 月租

Hermes 的 Skill 複利依賴主機長期在線。下表用於快速拍板(可用性為維運體感量級,非 SLA 承諾):

平台7×24 可用性Skill 複利適合場景
個人 MacBook合蓋即斷(約 60%)頻繁中斷僅 POC
樹莓派 4B 8GB約 88%I/O 瓶頸、長任務易逾時玩票
x86 VPS 4GB約 99.5%穩定但缺 macOS 工具鏈純 Linux 使用者
Mac Mini M4 月租機房託管 30 天在線UMA + launchd 原生守護要 Telegram 7×24 + macOS Skill 路徑
info

提示:M4 統一記憶體讓 Gateway、瀏覽器自動化與 SQLite WAL 共享高頻寬記憶體池;社群監控 Gateway 常駐約 4 GB 量級仍有多餘(16 GB 機型)。遠端租機後 SSH 登入執行安裝命令,與本地操作一致。

05

可引用參數與結論:裝完 Hermes 後主機怎麼選?

  • 安裝路徑:預設 ~/.hermes/hermes-agent/,全域命令 hermes 由安裝腳本寫入 PATH。
  • 穩定版本:v0.14.x 為目前常用穩定線(2026-06 文件口徑);升級用 hermes update
  • 渠道規模:Gateway 支援 Telegram、Discord、Slack、WhatsApp 等 20+ 平台;生產建議獨立獨佔主機。
  • Skill 儲存:自動寫入 ~/.hermes/skills/;主機掉線則複利中斷——與「必須 7×24」直接相關。

若你只是週末試玩,筆電 + 雲端 API 足夠;一旦要把 Hermes 當成「每天會接單的同事」,合蓋休眠、VPS 上的 macOS 斷層和群聊隱私模式坑會一起放大。自購 Mac Mini 可行,但先月租驗證 30 天工作流再決定是否買斷,決策成本最低——具體機型見 租賃價格說明

家用 Wi-Fi 斷網、鄰居 VPS 超售、樹莓派磁碟 I/O 吃緊,都會讓 Gateway 在關鍵時刻掉線——而 Telegram 使用者只會覺得「Bot 又死了」。對需要穩定 7×24 跑 Hermes、並保留 macOS 原生安裝與 launchd 守護的生產環境,NodeMini 的 Mac Mini M4 雲端租賃通常比「將就的筆電 + 手動重啟」更省心:你專注 Agent 複利,而不是半夜修 hermes gateway status

FAQ

常見問題

不需要。官方腳本會透過 uv 安裝 Python 3.11 與 Node.js 22。裝完後務必 source ~/.zshrc 並執行 hermes doctor 驗收。

NodeMini 提供獨佔 Mac Mini M4 按月/按季租賃,即時價格見 租賃價格說明。Hermes 使用的 LLM API(OpenRouter 等)仍由你自行向提供商付費。

可用 PowerShell 安裝腳本(早期 Beta),但 Dashboard 終端機面板建議 WSL2 + Linux 安裝路徑。更多接入與 SSH 問題見 說明中心