想在 2026 年跟做 Hermes Agent 安裝、卻卡在 PATH、API Key 或 Telegram 群組不響應的開發者,本文是一條可複製的保姆級路徑:從官方 curl 一行安裝hermes setup 配模型、hermes gateway 接 Telegram 並以 launchd/systemd 7×24 常駐,涵蓋 macOS、Linux 與雲 Mac。你將取得五大痛點拆解、四平台對照表、六步實操與常見報錯對照。可與 三層記憶架構30 天實測 交叉閱讀。
01

2026 年 Hermes Agent 是什麼?和 OpenClaw 差在哪?

Hermes AgentNous Research 在 2026 年發布的 MIT 開源自主 Agent:行程長期駐留、任務完成後把成功路徑寫成 ~/.hermes/skills/ 下的 Skill,下次同類任務 token 消耗可明顯下降。與一次性 ChatGPT 網頁對話不同,它更像住在你機器上的工程師——可從 Telegram 收指令,在背景跑 shell、檢索、改儲存庫。

OpenClaw 相比:OpenClaw 以訊息頻道 Gateway + workspace 檔案見長,生態圍繞 openclaw CLI;Hermes 強調 Closed Learning Loop(自進化 Skill)、三層記憶(工作階段 / MEMORY.md / USER.md)與 MCP 擴充。和 LangGraph、CrewAI 等多 Agent 編排框架相比,Hermes 更偏個人或小團隊的單機常駐助理,安裝入口就是一條官方腳本,而不是先搭 Python 圖狀態機。

本文不重複「為什麼要 7×24」(見記憶架構文),專注裝得上、配得通、Telegram 能回、服務能常駐。涵蓋 macOS 本機、Linux VPS/WSL2、以及 KVMNODE 雲 Mac 上的生產部署。

01

PATH 未重新載入:裝完直接敲 hermes 報 command not found,其實是 Shell 沒 reload。

02

API Key 空缺:沒跑 hermes setuphermes model,首條對話就報 API key not set。

03

筆電合蓋:Gateway 隨睡眠退出,Telegram 訊息堆積,Skill 檔在漲但複利曲線平。

04

群組隱私模式:Bot 預設只回應 / 指令,未在 BotFather 關 Group Privacy 就以為「壞了」。

05

無頭機缺依賴:Linux 伺服器未加 --skip-browser 或誤用系統 Python,ModuleNotFoundError 頻發。

下面先選部署平面,再跟六步指令。

02

Hermes Agent 裝在哪?MacBook、VPS 還是月租 Mac Mini?

Hermes 官方安裝腳本在 macOS 與 Linux 上測試最充分:自動裝 uv、Python 3.11、Node.js 22、ripgrep、ffmpeg,儲存庫落在 ~/.hermes/hermes-agent/。純 API + Gateway 模式 4GB 記憶體可跑;要本機模型或瀏覽器自動化 Skill,建議 16GB 起。

部署平面7×24 可用性官方路徑完整度Skill 複利月成本體感
個人 MacBook合蓋即斷(約60%)高(macOS)頻繁中斷硬體 NT$0 + 焦慮
樹莓派 4B 8GB約88%Linux,無 MetalI/O 瓶頸硬體一次性
x86 VPS 4GB約99.5%Linux,無 Camoufox 等 macOS Skill較穩按量計費
月租 Mac Mini M4機房 SLA,約100%最高(launchd + UMA)持續累積固定 OpEx,可退租

安裝教學解決「能跑起來」;平台選型解決「跑多久、Skill 能不能複利」——生產 Telegram 助理建議獨佔 macOS 節點。

03

Hermes Agent 一鍵安裝與環境自檢:curl、doctor、setup

官方推薦一行安裝(macOS / Linux / WSL2 / Termux):

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

腳本會:偵測並安裝 uv;用 uv 裝 Python 3.11(無需 sudo);裝 Node.js 22、ripgrep、ffmpeg;clone 到 ~/.hermes/hermes-agent/;把 hermes 加入 PATH;拉取預設 Skills 註冊表。成功標誌一般為 Hermes Agent installed at ~/.hermes

無頭伺服器略過瀏覽器堆疊:

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor 會自檢 Python、Node、ripgrep、ffmpeg、PATH、API Key 等十餘項。設定模型用精靈或分項指令:

shell
hermes setup
hermes model
hermes config set OPENROUTER_API_KEY sk-or-xxxx
hermes

Key 寫在 ~/.hermes/.env。支援 Nous Portal、OpenRouter、Anthropic、OpenAI、GitHub Copilot、Ollama 等。裝完可先本機 CLI 對話驗證,再開 Gateway。

提示:升級後若報 Missing config,執行 hermes config check && hermes config migrate。勿用系統 Python 直接跑,應使用 ~/.hermes/hermes-agent/venv/bin/hermes

04

六步把 Hermes Agent 接到 Telegram 並 7×24 常駐

01

建立 Bot:Telegram 找 @BotFather,/newbot,記下 Token;@userinfobot 查自己的數字 ID。

02

Gateway 精靈:hermes gateway setup,選 Telegram,貼上 Token 與 TELEGRAM_ALLOWED_USERS

03

前景試跑:hermes gateway,手機給 Bot 發訊息,確認能回。

04

安裝守護:macOS hermes gateway install && hermes gateway start;Linux 可用 sudo hermes gateway install --system

05

群組(可選):BotFather 關 Group Privacy,Bot 踢出再拉回群組;否則群組只回應 / 指令。

06

雲 Mac 下單:要 7×24 與 macOS Skill 路徑,在 雲端訂購 租獨佔 M4,SSH 執行同樣指令;退租前打包 ~/.hermes/

shell
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
journalctl -u hermes-gateway -f

遷雲時參考 30 天遷移清單:備份 skills、.env、config.yaml,新節點重裝後還原目錄即可。

05

環境參數、Skill 複利與常見報錯速查

三條可引用口徑:① 官方安裝腳本固定拉 Python 3.11 + Node 22,磁碟預留約 1.5GB(含 Skills 快取),本機模型建議 20GB SSD+。② 社群記錄同類任務 Skill 命中後 token 可降約 38%(前提:主機 7×24 在線,Skill 才能持續複利)。③ 2026 年 6 月穩定線多為 v0.14.x,v0.15 候選版升級後務必跑 hermes config migrate

報錯原因處理
command not foundPATHsource ~/.zshrc
API key not set未配模型hermes model
群組無響應隱私模式BotFather 關 Privacy,重拉 Bot
dotenv 模組缺失系統 Python用 venv 內 hermes

攤開替代方案:合蓋 MacBook 裝得上卻守不住 Gateway;低價 Linux VPS 能跑 Telegram 卻缺 macOS 瀏覽器自動化與 Metal 本機推理;樹莓派 I/O 與記憶體頂不住長工作階段 SQLite。在 KVMNODE 租賃獨佔 Mac Mini M4,用 launchd 守護、UMA 扛 Gateway + 可選本機模型,SSH 與本機無差別安裝,按月 OpEx 驗證 30 天再決定買斷——對要把 Hermes 當生產助理、又要 Skill 複利的團隊,通常比「湊合筆電 + 偶爾開機」更省心。方案見 租用價格,交付與網路見 雲端說明