2026 Hermes Agent 手把手安裝教學：
macOS 一鍵部署、Telegram 接入與 7×24 Gateway 常駐

2026 年 Nous Research 開源的 Hermes Agent 把「能聊天的模型」升級成住在你機器上的長期程式：跨工作階段記憶、自動沉澱 Skill、透過 Telegram 等二十餘個閘道隨時下達任務。許多讀者卡在第一步：相依套件裝不齊、模型 Key 配錯、Telegram Bot 建了卻收不到訊息。

本文面向想在 macOS / Linux / WSL2 上從零跑通 Hermes 的開發者與小團隊：先拆解安裝痛點與宿主對照，再給官方一鍵腳本 → hermes doctor → hermes setup → 首次對話 → Telegram Gateway → launchd 常駐 的六步清單。讀完應能獨立完成安裝驗收，並判斷該把 ~/.hermes/ 放在本機還是7×24 在線的 Mac Mini 上。

01 Hermes Agent 安裝前必須知道的痛點：和 OpenClaw 不是同一條路

Hermes 與社群裡常見的 OpenClaw 都帶 Gateway，但預設心智不同：OpenClaw 更偏「多通道控制面 + 外掛生態」；Hermes 強調三層記憶 + Skill 自進化 + MCP，安裝腳本會一次性拉起 Python 3.11、Node.js 22、ripgrep、ffmpeg 等執行環境，而不是讓你自己拼虛擬環境。

  • 相依鏈長：若用手動 pip 安裝，極易遇到「系統 Python 與 venv 不一致」「缺 dotenv」等錯誤；官方建議始終用安裝器寫入 ~/.hermes/hermes-agent/venv。
  • 合蓋即斷：在 MacBook 上試玩可以，但 Gateway 與定時任務需要主機睡眠策略配合；生產環境應使用不休眠的專用 Mac。
  • Linux VPS 的隱性成本：x86 VPS 能跑 Gateway + 雲端 API，但部分 macOS 專屬瀏覽器自動化路徑在 Linux 上不可用或需額外折騰。
  • 訊息通道鑑權：Telegram 群聊預設隱私模式會導致 Bot「看不見」一般訊息；這不是 Hermes 的 bug，而是 BotFather 策略。
  • 版本漂移：發版後若只複製舊設定，可能出現 Missing config after update，需用 hermes config check 與遷移命令對齊 schema。

結論先行：安裝本身可以 15 分鐘內完成；真正決定體驗的是宿主是否 7×24 在線，以及 ~/.hermes/ 是否可備份、可遷移。

行為與命令以 Nous Research 官方文件為準；發版後請再次開啟下列連結核對。

Installation | Hermes Agent

NousResearch/hermes-agent on GitHub

02 Hermes Agent 環境要求與部署平台對照：裝在哪台機器最省心

官方安裝器在 macOS 12+、Ubuntu 20.04+、WSL2、Termux 上均有維護路徑；Windows 原生 PowerShell 安裝為早期 Beta，生產環境更推薦 WSL2 跑 Linux 腳本。下表用於選型，不是替代官方 Prerequisites。

Hermes Agent 部署宿主對照（2026 實操向）
宿主 7×24 可用性 安裝摩擦 Skill / Gateway 複利 典型短板
MacBook 本機 合蓋/睡眠易斷 低（官方路徑最熟） 試用足夠，生產偏弱 辦公室干擾、系統更新重啟
樹莓派 4B 8GB 約 88%（社群體感） 中（IO 與 ARM 套件） 輕量 Gateway 可行 長任務、瀏覽器自動化易逾時
x86 Linux VPS 約 99.5% 中（無頭加 --skip-browser） API 模式穩定 缺 macOS 專屬工具鏈
Mac Mini M4 月租裸金屬 機房 SLA，目標 30 天在線 低（SSH 等同本機） launchd + UMA 適合常駐 需選擇可信機房與租期

最低資源（官方安裝頁口徑）：僅 Gateway + 雲端 API 時 4 GB RAM 可起步；若本地跑模型或開瀏覽器自動化，建議 16 GB 統一記憶體 檔位。磁碟預留 1.5 GB（含 Skills 快取），生產建議 20 GB SSD 餘量。遠端伺服器請確認網路延遲與出站策略，避免 Telegram 長連被防火牆中斷。

03 Hermes Agent 一鍵安裝與健康檢查：macOS / Linux 通用命令

在目標主機終端機執行（與官方 README 一致；發版後請核對倉庫 main 分支腳本路徑）：

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
無頭伺服器可略過瀏覽器棧：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version

安裝器典型動作包括：安裝 uv、拉取 Python 3.11、安裝 Node.js 22、安裝 ripgrep 與 ffmpeg、將倉庫克隆到 ~/.hermes/hermes-agent/，並把 hermes 寫入 PATH。成功時終端機會出現類似 installed at ~/.hermes 的提示。

hermes doctor 會自檢 Python、Node、ripgrep、ffmpeg、PATH 與 API Key 等項；任一項失敗應先修復再繼續 hermes setup，避免把問題帶到 Gateway。

Telegram 通道設定說明見官方 Messaging 文件。

Telegram | Hermes Agent User Guide

04 六步落地：模型設定、首次對話、Telegram 與 Gateway 7×24 常駐

  1. 設定 LLM（裝大腦）：執行 hermes setup 全精靈，或 hermes model 單獨切換提供商。OpenRouter / Anthropic / OpenAI / Ollama 等均支援；Key 寫入 ~/.hermes/.env，也可用 hermes config set OPENROUTER_API_KEY sk-or-xxxx。
  2. 首次 CLI 對話：執行 hermes，用一句可驗證任務測試（例如「列出目前目錄檔案數」），確認工具呼叫與日誌無錯誤。
  3. 建立 Telegram Bot：在 Telegram 搜尋 @BotFather，傳送 /newbot，記錄 Token；向 @userinfobot 取得你的數字 User ID。
  4. 綁定 Gateway：執行 hermes gateway setup 選 Telegram 並貼上 Token 與允許使用者 ID；或手動寫入 TELEGRAM_BOT_TOKEN 與 TELEGRAM_ALLOWED_USERS。
  5. 前景冒煙：hermes gateway 前景執行，在手機給 Bot 發訊息，確認 Hermes 能回覆；群聊需依官方文件關閉 Bot 隱私模式並重新拉 Bot 入群。
  6. 背景常駐：macOS 執行 hermes gateway install 與 hermes gateway start（launchd）；Linux 可用 sudo hermes gateway install --system 配合 systemd。遠端 Mac 月租節點上完成同樣步驟即可 7×24 觸達。
gateway.env 
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

若計畫在 CALMVPS 裸金屬 Mac 上部署：先在 定價頁 選定 M4 記憶體與區域，SSH 登入後執行與本機相同的安裝命令；退租前打包備份整個 ~/.hermes/ 目錄。下單與交付見 雲端訂購頁。

05 可引用參數、常見錯誤與 CALMVPS 場景收束

  • 安裝器元件：uv + Python 3.11 + Node.js 22 + ripgrep + ffmpeg（來源：官方 Installation 文件；版本號隨發版變化，請以 hermes --version 為準）。
  • 設定落盤：核心目錄 ~/.hermes/（.env、skills、memories、Gateway 狀態）；遷移宿主務必目錄級備份，而非只複製聊天記錄。
  • 功耗參考（M4 宿主）：社群與機房實測中，閒置約 4–6 W、Agent 典型負載約 15–25 W；適合長期 Gateway 常駐（具體以機房電表與 Apple 規格為準）。
Hermes Agent 常見安裝與 Gateway 錯誤
現象 常見原因 處理
hermes: command not found PATH 未刷新 source ~/.zshrc 或新開終端機
API key not set 未設定 LLM hermes model 或編輯 ~/.hermes/.env
群聊無回應 Bot 隱私模式 BotFather 關閉 Group Privacy 後重拉 Bot
Missing config after update 設定 schema 變更 hermes config check 與 migrate

把 Hermes 裝在經常合蓋的筆電上，短板是 Gateway 連續性與 Skill 複利節奏；裝在廉價跨境 VPS上，短板是 macOS 工具鏈缺失與跨境延遲；裝在樹莓派上，短板是 IO 與長任務逾時。對需要手把手安裝路徑最熟、Telegram 7×24 觸達、launchd 原生守護、且可快速升配記憶體的生產環境，CALMVPS 裸金屬 Mac Mini M4 月租 通常是更優解：SSH 交付即用，獨占 Apple Silicon，按月彈性下單。機型與租期見 CALMVPS 定價頁，立即下單見 雲端訂購。