AI Agent Hermes 2026.06.01

2026 Hermes Agent 安裝教學： 一行指令到 Telegram 7×24 常駐

JEX
JEXCLOUD 工程團隊
· 2026年6月1日 · 約 14 分鐘閱讀

Hermes Agent 是 Nous Research 在 2026 年開源的 MIT 自進化 AI Agent 框架，GitHub 星標已突破 17 萬。與「關視窗就歸零」的聊天機器人不同，它透過 MEMORY.md、Skill 目錄與 Gateway 把任務沉澱為可複用能力——但前提是：你得先把它裝對、配好模型、再把 Telegram 閘道跑成 7×24。

本文面向「只想看一篇裝完」的讀者：① 說明 Hermes 與 OpenClaw、LangGraph 的差異及安裝前痛點；② 給出 curl 一鍵安裝 → hermes doctor → hermes setup → Telegram Gateway → launchd/systemd 常駐 的完整路徑；③ 提供 LLM 選型矩陣、六步驗收清單與常見報錯表。硬體選型與樹莓派實測見 三方案硬體對比，記憶架構見 持久記憶專題。

01 Hermes Agent 安裝前：2026 爆紅與三類真實痛點

Hermes Agent 在 2026 年 2 月首發後，憑藉「任務結束自動寫 Skill、下次同類任務 token 降約 38%」的社群觀測迅速出圈。與 OpenClaw 側重多 Agent 工作流編排、LangGraph 偏圖狀態機不同，Hermes 的差異化是：原生跨 Session 記憶 + 20+ 訊息平台 Gateway + MCP 即插即用。很多人在 Star 儲存庫後卡在三個環節：

  • 環境碎片化：以為要先裝 Python 3.11、Node 22、ripgrep、ffmpeg——其實官方腳本會透過 uv 自動補齊，但 PATH 未重新載入會導致 hermes: command not found。
  • 模型未配：安裝成功卻報 API key not set，CLI 能進卻無法推理。
  • 閘道未常駐：Telegram Bot 配好，筆電合蓋後 Bot「假死」，Skill 複利與跨週記憶中斷。

一句話定位：Hermes 裝得順不順，取決於你是否把「安裝 + 模型 + 常駐閘道」當成一條流水線，而不是三次獨立試錯。

目前穩定線已到 v0.15.1（2026.5.29），修復了 v0.15.0 在 loopback 模式下 Dashboard 無限重載等問題（見 官方 Release）。下文指令以 macOS / Linux / WSL2 為準；Windows 原生 PowerShell 可用官方 install.ps1，瀏覽器 Dashboard 聊天面板仍建議 WSL2。

02 Hermes Agent 環境需求與 LLM 提供商決策矩陣

官方安裝腳本唯一硬性前置是 Git（git --version 可用即可）。Python、Node、ripgrep、ffmpeg 均由腳本偵測並安裝，無需 sudo。

宿主環境最低 vs 建議（Gateway + 雲端 API 模式）
項目 最低 建議
作業系統 macOS 12+ / Ubuntu 20.04+ / WSL2 macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS
記憶體 4 GB（僅 Gateway + API） 16 GB+（本機 Ollama 8B）
硬碟 約 1.5 GB（含 Skills 快取） 20 GB SSD+（日誌與模型權重）
網路 可存取 GitHub raw 與 LLM API 穩定低延遲出口（Telegram 入站）
LLM 提供商怎麼選（安裝後 hermes setup / hermes model）
提供商 適合誰 設定要點
Nous Portal 想零設定快速試跑 hermes setup --portal OAuth
OpenRouter 多模型實驗、單 Key OPENROUTER_API_KEY 寫入 ~/.hermes/.env
Anthropic / OpenAI 正式環境 Claude / GPT API Key 或 OAuth（Max 方案）
Ollama / VLLM 本機推理、隱私敏感 Base URL + 模型名；記憶體建議 16GB+

無頭伺服器（無 GUI 瀏覽器自動化）安裝時加 --skip-browser，可避免拉取 Camoufox 相關依賴。設定統一落在 ~/.hermes/.env 與 ~/.hermes/config.yaml。

03 Hermes Agent 一鍵安裝：六步從 curl 到首次對話

在 macOS、Linux 或 WSL2 終端機執行官方腳本（與 安裝文件 一致）：

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

# 無頭 VPS 可選
# curl -fsSL ... | bash -s -- --skip-browser

source ~/.zshrc
hermes doctor
hermes --version
hermes setup
hermes

腳本會自動：安裝 uv → Python 3.11 → Node.js 22 → ripgrep / ffmpeg → 複製到 ~/.hermes/hermes-agent/ → 將 hermes 加入 PATH → 拉取預設 Skills 註冊表。成功標誌為終端機出現 Hermes Agent installed at ~/.hermes。

  1. 執行 curl 安裝：確保 Git 可用；企業代理環境需先設定 https_proxy。
  2. 重新載入 Shell：source ~/.zshrc 或 source ~/.bashrc，否則下一行會 command not found。
  3. 健康檢查：hermes doctor 自檢 Python、Node、PATH、API Key 等約 12 項。
  4. 確認版本：hermes --version 建議 ≥ v0.14.x；升級用 hermes update。
  5. 設定模型：hermes setup 或 hermes model 寫入 ~/.hermes/.env。
  6. 冒煙對話：執行 hermes，輸入「統計目前目錄檔案數」或「搜尋今日 AI 新聞並總結」驗證工具鏈。

也可用短鏈 curl -fsSL https://get.hermes-agent.org | bash（與社群文件一致）。Windows PowerShell：iex (irm .../install.ps1)；Android Termux 同 Linux 腳本，官方提供 Termux 適配說明。

04 Hermes Agent Telegram 接入與 Gateway 7×24 常駐

要讓手機隨時找到 Agent，需完成 Bot 建立 + Gateway 設定 + 系統服務託管三步。

  1. 建立 Bot：Telegram 搜尋 @BotFather，/newbot 取名，使用者名稱須以 bot 結尾，儲存 Token。
  2. 取得使用者 ID：向 @userinfobot 發訊息得到數字 ID，用於白名單。
  3. 互動設定（建議）：hermes gateway setup，選 Telegram，貼上 Token 與 ID。
  4. 或手動寫入 .env：TELEGRAM_BOT_TOKEN=... 與 TELEGRAM_ALLOWED_USERS=你的ID。
  5. 前景試跑：hermes gateway，手機給 Bot 發訊息確認回覆。
  6. 背景常駐：macOS 執行 hermes gateway install + hermes gateway start（launchd）；Linux 可用 sudo hermes gateway install --system + systemd，日誌 journalctl -u hermes-gateway -f。

群聊必讀：Bot 預設隱私模式僅回應 / 指令。群組使用需在 BotFather 關閉 Group Privacy，並將 Bot 踢出群後重新邀請。Discord / Slack 等管道同樣走 hermes gateway setup，詳見 官方訊息平台文件。

gateway.service 
hermes gateway install
hermes gateway start
hermes gateway status

# Linux 開機自啟（可選）
sudo hermes gateway install --system
sudo hermes gateway start --system

05 Hermes Agent 可引用規格與常見安裝報錯速查

  • GitHub 規模（2026-06）：約 175,000 Stars，MIT 協議，295+ 貢獻者量級（儲存庫）。
  • 安裝體積：含 Skills 快取約 1.5 GB 起；~/.hermes/ 運行三個月後常見 200–600 MB 成長（視 Skill 與日誌而定）。
  • Skill 複利前提：社群觀測 30 天內 Skill 數 3 → 19 時，同類任務 token 約降 38%——需主機 7×24 上線，否則複利中斷。
  • 閘道記憶體（macOS 實測歸納）：僅 Gateway + SQLite 約 1.2–1.8 GB；疊加 Ollama 8B 建議 24 GB 統一記憶體。
安裝與 Gateway 高頻報錯
報錯 / 現象 原因 處理
hermes: command not found PATH 未重新載入 source ~/.zshrc 或新開終端機
API key not set 未設定 LLM hermes model 或編輯 ~/.hermes/.env
升級後設定遺失 版本遷移 hermes config check && hermes config migrate
群聊 Bot 不回覆 隱私模式 / 未重入群 BotFather 關 Group Privacy 後重邀 Bot

可選擴充：在 ~/.hermes/config.yaml 宣告 mcp_servers 接入 GitHub、資料庫等 MCP；無 GUI 伺服器用 hermes mcp login + SSH 隧道完成 OAuth。

06 Hermes 裝在哪台機器：平台對比與 JEXCLOUD 收束

安裝落地平台對比（Gateway + Skill 複利場景）
平台 7×24 可用性 安裝路徑成熟度 適合階段
個人 MacBook 合蓋即斷 官方 curl 最順 POC / 週末除錯
Linux VPS 高，非 macOS 需 --skip-browser，部分 Skill 路徑不同 已有 DevOps 團隊
JEXCLOUD Mac Mini M4 機房 SLA，獨立 IPv4 與本機 Mac 相同指令鏈 Telegram 正式環境 + 本機 8B

筆電與超賣 VPS 的常見短板：① 閘道長連線不穩定（睡眠、NAT、鄰居 IO）；② macOS 專屬瀏覽器自動化 Skill 在純 Linux 上無法 1:1 複現；③ 無獨享記憶體時並行子 Agent 易觸發 OOM，hermes doctor 通過但正式環境仍抖。

更穩妥的路徑：在 JEXCLOUD 裸金屬 Mac Mini M4 上按月開通，SSH 執行與本文相同的安裝指令，Gateway 用 launchd KeepAlive，~/.hermes 始終落在你的租用磁碟——無虛擬化超賣、Telegram 入站穩定、退租前可 rsync 備份技能與記憶。規格與 M4.S / M4.M / M4.XL 選型見 定價頁；下單與區域延遲見 訂單頁 與 說明中心。

返回部落格列表
標籤： Hermes Agent 安裝教學 Telegram Mac Mini M4 Gateway