Hermes Agent 是 Nous Research 開發的開源 AI Agent 框架(MIT License),最大特色是自我進化:從經驗中自動建立技能、跨對話記住使用者、自動改善工作流程。v0.16.0 The Surface Release 新增原生桌面版(macOS / Linux / Windows)、Web Dashboard 管理台、遠端 Gateway 登入、多 Profile 並行、拖拉檔案、狀態列模型選擇、/undo、Quick Setup via Nous Portal、模糊模型搜尋與更精簡的預設技能集。本頁包含完整介紹、與 Claude Code + Telegram channel 和 OpenClaw 比較、一行 curl 指令安裝教學、hermes setup wizard、Telegram gateway 設定、桌面版與 Dashboard 使用定位、常見故障排除、Tony 第一手實測紀錄。
🧠 Nous Research 開源專案 · 一頁完整指南 · v0.16.0 The Surface Release

Hermes Agent
會自己進化的 AI 助手

唯一內建學習迴路的 AI Agent——現在不只在終端機,也有原生桌面版與 Web Dashboard。
本頁含完整介紹 + 桌面版新功能 + 一行 curl 指令安裝 + Telegram gateway 設定 + 808AI 第一手實測。

這是什麼?

一句話說完:自己會進化的 AI 員工

Hermes Agent 是 Nous Research 推出的開源 AI Agent 框架。跟其他 Agent 最大的差別是:它會從你的使用經驗中自動學習。做過一次的任務,下次會自動建立「技能」來處理。不需要你手動教它,它自己會變聰明。2026/06 的 v0.16.0 更把使用介面往外推:除了 CLI / Telegram,現在有真正的桌面 App 與瀏覽器管理台。

🔄 自我進化閉環

做事 → 記住 → 建立技能 → 改善技能 → 更好地做事

傳統 AI Agent:你教它做 A,它只會做 A。
Hermes Agent:你教它做 A,它學會 A,然後自己發現 B 也可以用類似方法,自動建立 B 的技能。

🆕 2026/06 更新:Hermes 不再只是 CLI

v0.16.0 The Surface Release,把 Agent 帶到桌面、瀏覽器與遠端 Gateway

🖥️

原生桌面版

macOS / Linux / Windows 都能用。不是終端機包一層殼,而是完整聊天視窗、Session 列表、拖拉檔案、剪貼簿圖片、Cmd+K 指令面板與狀態列模型選擇器。

🌍

遠端 Hermes Gateway

桌面 App 可以連到遠端 Hermes:家裡 Mac mini、雲端主機、團隊伺服器都可。支援 OAuth 或帳號密碼登入,筆電只當薄 GUI,重活讓遠端 Agent 跑。

📊

Web Dashboard 管理台

從瀏覽器設定 MCP、Messaging Channels、Credentials、Webhooks、Memory、Gateway 控制與 Debug Share。很多以前要 SSH 改 config 的事,現在可以點選完成。

👥

多 Profile / 多 Session

同一個桌面視窗可以跑多個 Profile 與多個 Session,支援跨 Profile @session 連結。適合把私人助理、工作助理、研究助理拆開管理。

💡 808AI 解讀

v0.13 以前的 Hermes 比較像「會學習的工程師工具」;v0.16 之後,它開始變成「可給一般團隊使用的 AI 工作桌面」。CLI 還在,但新手不一定要從黑畫面開始。

八大核心能力

不只是工具,是一個會成長、可管理、可跨平台使用的系統

🧠

自我學習

從經驗中自動建立 Skill,做過的任務下次更快更好。跨對話記住你的偏好和工作模式。

🌐

17+ 平台整合

Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS、iMessage、飛書、釘釘、WeCom、Matrix、Mattermost 等。一個 Agent 可以出現在多個工作入口。

🤖

多 Provider / 模型搜尋

支援 OpenRouter、OpenAI、Anthropic、Gemini、DeepSeek、xAI、MiniMax、Qwen、Nous Portal、local / custom endpoints。模型挑選器支援模糊搜尋。

☁️

桌面 + Web + 遠端

CLI、TUI、桌面 App、Web Dashboard、Telegram Gateway 都能用;桌面版還能連遠端 Hermes Gateway。

排程自動化

內建 Cron 排程器。報表、備份、巡檢,用自然語言設定,時間到自動跑。

🔧

工具 + MCP + 技能 Hub

內建工具、MCP、Plugins、Skills Hub 與 curator。v0.16 預設技能更精簡,也可從 NVIDIA / OpenAI / Anthropic / HuggingFace 等 trusted taps 安裝。

📊

瀏覽器管理台

Dashboard 可管理 messaging channels、MCP catalog、credentials、webhooks、memory、system update 與 debug share。

↩️

/undo 與 Session 管理

送錯訊息或讓 Agent 走偏時,用 /undo [N] 回退最近 N 輪;Session 可搜尋、封存、跨 Profile 管理。

⚡ 跟其他工具比較

Hermes Agent vs OpenClaw vs Claude Code + Telegram

🧠 Hermes Agent 🦞 OpenClaw ⌨️ Claude Code + Telegram
自我學習 ✓ 自動建立 Skill △ 需手動設定 △ MEMORY.md + brain 系統
模型支援 200+(OpenRouter) 多家 Anthropic only
通訊平台 17+ 個(含 Email / SMS / iMessage / 飛書等) 4 個(含 LINE) ✓ Telegram channel(隨時遠端指揮)
部署方式 CLI / TUI / Desktop / Web / Gateway / Docker 本地 本地 CLI + Telegram relay
排程 ✓ 內建 Cron ✓ Cron + Heartbeat ✓ Remote Trigger / launchd
多 Agent ✓ Delegation + Kanban + 多 Profile ✓ 多 Agent 編排 ✓ Subagents / Skills
授權 MIT(完全開源) 商業授權 商業授權
學習曲線 中等 較陡 中等(會用 CLI + Telegram 設定)
生態成熟度 快速成長(v0.16 已有桌面版與管理台) 成熟 成熟(官方持續更新)

想看更完整比較?→ 三方比較專頁

📖 完整安裝與設定教學
  1. 安裝前準備(系統需求 / OpenRouter / Telegram bot)
  2. 一行指令安裝
  3. hermes setup wizard 首次設定
  4. 設定 LLM provider
  5. 接上 Telegram gateway
  6. 三種啟動模式
  7. 與 Claude Code / OpenClaw 並行
  8. 常見問題 / 故障排除
  9. Tony 第一手實測(2026/05/09)
  10. v0.16.0 — 2026/06 桌面版與 Surface Release

1. 安裝前準備

三樣東西,五分鐘可備齊

作業系統與硬體

安裝腳本會自動處理 uv、Python 3.11、Node.js、ripgrep、ffmpeg 等依賴——不需要你預先裝。

LLM provider key(擇一)

💡 808AI 建議

第一次裝直接用 OpenRouter——免綁定特定家、可以試免費模型(如 Llama 3.3、Gemini Flash)跑通流程,確定要長期用再考慮直接綁 Anthropic / OpenAI。

Telegram bot token(選配但強推)

  1. 用 Telegram 搜尋 @BotFather,點 Start
  2. /newbot,依提示輸入 bot 名稱與 username(必須以 bot 結尾,例如 my_hermes_bot
  3. BotFather 回你一串 token,類似 1234567890:ABCdefGHIjklMNO...——複製保存
  4. /setprivacy → 選你的 bot → 選 Disable(讓 bot 能讀群組訊息,必要時可用)

不接 Telegram 也能用,但接上後就能用手機在任何地方下指令——這是 Hermes 跟 ChatGPT App 最大差異。

2. 一行指令安裝

官方 install.sh — 5 分鐘自動跑完

# macOS / Linux 通用
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

這條指令會做這些事:

  1. 檢查並安裝 uv(Python 套件管理器)
  2. 下載 Hermes Agent 源碼到 ~/.hermes/hermes-agent/
  3. 建立 Python 3.11 虛擬環境 + 安裝 ~80 個 Python 依賴
  4. 安裝系統工具:Node.js、ripgrep、ffmpeg(如果還沒裝)
  5. 下載並掛載預設技能集(v0.16 起預設更精簡,重型或利基技能改為需要時再安裝)
  6. 建立 config.yaml、cron 目錄、logs 目錄,並準備 Dashboard / Gateway 相關狀態檔
  7. hermes 指令加到 ~/.local/bin/(記得確認在 $PATH 裡)

📍 安裝後的目錄結構

所有東西都在 ~/.hermes/,跟你既有的 Claude Code(~/.claude/)或 OpenClaw(~/.openclaw/完全隔離——可以放心並行安裝。

~/.hermes/
├── hermes-agent/      # 源碼
├── config.yaml        # 設定檔(key、model、gateway 全在這)
├── audio_cache/       # 語音模式快取
├── image_cache/       # 圖像快取
├── cron/              # 排程 job 設定
├── hooks/             # 觸發事件腳本
├── sessions/          # 對話紀錄 / session store
└── logs/              # CLI / Gateway / Desktop 執行紀錄
⚠️ 安裝可能卡住的點

Python 版本:若你 macOS 系統 Python 不是 3.11,uv 會自動下載;無需手動切換。
網路:GitHub raw 內容若被擋(極少數企業內網),先用 VPN 或改下載 release ZIP 解壓再跑 install.sh
權限:腳本只寫到你的家目錄;不需要 sudo。如果跳出 sudo 詢問——立刻取消,回頭檢查腳本來源。

3. hermes setup wizard 首次設定

新手走 Quick Setup,進階者走完整 wizard

# 安裝完可走完整設定 wizard
hermes setup
# v0.16 起的新手快速路徑:Nous Portal
hermes portal

現在有兩條路:

完整 wizard 主要會問你三組問題:

選擇 LLM provider

列表會列出已偵測到的 provider(OpenRouter / OpenAI / Anthropic / Gemini / DeepSeek / xAI / Nous Portal / 本地或 custom endpoint 等)。選一個你準備好 key 或登入方式的。

貼上 API key

把上一步準備好的 key 貼進去;wizard 會寫入 Hermes 設定 / credential pool。若走 Nous Portal / OAuth provider,則依瀏覽器登入流程完成授權。不要把 key 貼到聊天紀錄或網頁表單。

選預設模型

從 provider 的 model list 挑一個當預設。不確定就選列表第一個——之後可以用 hermes model 隨時切換。

結束後 wizard 會跑一次自我測試(呼叫 model 一次驗證 key 可用),看到 ✓ Setup complete 就代表 OK。

4. 設定 LLM provider 細節

隨時換模型、加 provider、調參數

常用 model 指令

hermes model

列出所有可用模型 + 標記目前預設

hermes config

檢查目前 provider / model / gateway 設定(不要把 secret 貼出來)

hermes setup model

只重跑 model/provider 設定,不必重新設定全部

/model

在 TUI / Gateway session 內開模型選擇器;v0.16 模型搜尋支援 fuzzy search

model picking 三條原則

  1. 日常 chat / brainstorm:用便宜快的(GPT-4o-mini、Claude Haiku、Gemini Flash)
  2. 重要決策 / 長文寫作:用高階 reasoning 模型(如 Claude Opus / GPT 系列高階模型 / Gemini Pro)
  3. 大量資料 / 長 context:選長上下文模型(如 Gemini Pro、MiniMax 1M context、Claude 長上下文方案)

模型挑選器與 /fast

v0.16 的模型挑選器在 Desktop / Web / TUI / CLI 都支援 fuzzy search;聊天中也可以用 /fast 切到較快速的處理模式。若送錯方向,/undo [N] 可以回退最近 N 輪後重寫。

5. 接上 Telegram gateway

手機在任何地方都能跟 Hermes 對話

# 進 gateway 設定
hermes gateway setup

會跳出兩個問題:

  1. Bot token:貼上從 @BotFather 拿到的 token
  2. 允許的 chat_id:你自己的 Telegram user ID(傳 /start 給你的 bot,Hermes 會偵測並 prompt 你「是否信任這個 chat」)。強烈建議只開白名單給自己,避免被路人騷擾。

設定完跑:

# 前景啟動 gateway 測試
hermes gateway run
# 確認沒問題後安裝成背景服務
hermes gateway install

看到 gateway connected / polling 類訊息就成功——打開你的 Telegram bot 對話視窗,傳一句「Hi」,Hermes 應該幾秒內回覆。若要從瀏覽器設定 channel,v0.16 的 Web Dashboard 也提供 Channels 管理頁。

🌐 Messaging Gateway 一覽

Hermes 支援多個 messaging platform;實際可用項目以 hermes gateway setup / Dashboard Channels 頁為準:

Telegram · Discord · Slack · WhatsApp · Signal · Email · SMS · iMessage · 飛書 Lark · 釘釘 DingTalk · WeCom 企業微信 · WeChat · Microsoft Teams · Matrix · Mattermost · Twilio Voice · Google Meet(Twilio 橋接)

6. 三種啟動模式

挑一個,或一起跑;v0.16 之後桌面版也是主入口之一

模式 指令 用途
互動 TUI hermes 終端機直接對話,適合 debug / 嘗試新 skill / 寫長文
桌面 App hermes desktop / 官方 installer GUI 聊天、拖拉檔案、模型切換、Session 管理;可連本機或遠端 Gateway
Web Dashboard hermes dashboard 瀏覽器管理 sessions、MCP、channels、credentials、webhooks、memory、系統狀態
Gateway daemon hermes gateway run 背景跑,接 Telegram / Discord / Slack 訊息——手機指揮主力
Cron 排程 hermes cron list 定期觸發任務(每日簡報、週報、巡檢),不需互動

背景常駐:launchd(macOS) / systemd(Linux)

如果你要 Hermes 24/7 在 Mac mini 上跑,建議把 gateway 包成 launchd / systemd service:

# macOS / Linux — Hermes 內建安裝 gateway 背景服務
hermes gateway install

跑完後 Hermes 會依作業系統建立對應服務。macOS 通常走 launchd;Linux 通常走 systemd。要管理服務可用 hermes gateway statushermes gateway starthermes gateway stop

7. 與 Claude Code / OpenClaw 並行

三套完全可以共存,獨立 bot、獨立 process

Hermes 安裝在 ~/.hermes/,跟下面兩套完全隔離

共用的只有:

💡 808AI Tony 親身組合建議

戰略 + 寫 code → Claude Code(最穩,Subagents 拆任務最順)
自動化 daemon / cron → OpenClaw(多 agent 編排是強項)
想試語音 / Honcho 用戶建模 / 自我建立 Skill → Hermes
三個獨立 Telegram bot,手機收到不同訊息對應到不同 agent,分工清楚。

⚠️ 一個 Telegram polling 衝突陷阱

同一個 Telegram bot token 不能同時被兩個 process polling——會互踢。每套(Claude Code / OpenClaw / Hermes)必須用不同的 bot token。BotFather 開新 bot 完全免費。

8. 常見問題 / 故障排除

安裝後找不到 hermes 指令

~/.local/bin 加到 $PATH

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh(macOS 預設)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

API key 一直被拒

Telegram bot 沒反應

想完整移除

# 1. 停掉 service(若有裝)
hermes service uninstall
# 2. 刪掉整個目錄
trash ~/.hermes

建議用 trash 不是 rm -rf——萬一誤刪可從 macOS Trash 救回。

9. Tony 第一手實測

2026/05/09 在 Mac mini M4 32GB 上跑通的紀錄

🧪 5 分鐘從 0 到第一條訊息

安裝:一條 curl 命令搞定,~5 分鐘安裝完,自動處理 uv / Python 3.11 / Node.js / ripgrep / ffmpeg / 91 個 bundled skills。

位置:所有東西都在 ~/.hermes/,完全隔離不影響既有 Claude Code 或 OpenClaw。

啟動成本:只需一個 LLM provider key(OpenRouter 一個 key 通 200+ models 最方便)+ 獨立 Telegram bot token(BotFather 開新 bot)。

跑起來hermes(互動 TUI/CLI)/ hermes setuphermes portal(初次設定)/ hermes gateway run(啟 messaging gateway)。v0.16 之後也可用 Desktop 與 Web Dashboard 當日常入口。

實戰用法定位

適不適合你?

適合 先不要
新手 有 CLI 基礎、敢自己 debug 的人 完全沒摸過終端機——先從 Claude Code + Telegram 入門
已有 AI 工具 想加「第二意見」reviewer / 試新模型 主 agent 還沒用熟——先深耕一個
使用場景 單一強化 agent / 語音 / 多 messaging 平台 / 桌面 GUI / 遠端 Gateway 只想要最簡單的聊天 App,完全不想碰設定或 API key

10. v0.16.0 — 2026/06 桌面版與 Surface Release

重點不只是功能變多,而是 Hermes 開始有「一般人可使用的表面」:Desktop + Dashboard + Remote Gateway

🖥️

Hermes Desktop App

原生桌面版支援 macOS / Linux / Windows:聊天視窗、Session 搜尋與封存、拖拉檔案、剪貼簿圖片、Cmd+K 指令面板、狀態列模型選擇器、in-app self-update。

🔐

遠端 Gateway 登入

桌面 App 可連遠端 Hermes Gateway,支援 OAuth 或帳號密碼;每個 Profile 可以指向不同 host,適合 Mac mini / homelab / 雲端主機常駐。

📊

Dashboard 變管理台

瀏覽器內可管理 MCP catalog、messaging channels、credentials、webhooks、memory、gateway 控制、system update check 與 Debug Share。

Quick Setup via Nous Portal

第一次使用可走 hermes portal:登入、選模型、開始聊天。進階使用者仍可用完整 hermes setup 自訂 provider、tools、gateway。

🔎

Fuzzy Model Picker

Desktop、Web、TUI、CLI 的模型選擇器都能模糊搜尋;新模型 catalog 更快更新,切換 provider / model 不再像翻長清單。

↩️

/undo [N]

送錯訊息或讓 Agent 走歪時,可以回退最近 N 輪並重新編輯。CLI / TUI / Telegram / Discord 等 messaging platform 都可用。

🧩

技能集瘦身 + Trusted Taps

預設 skills 更精簡;重型技能改為需要時再裝。NVIDIA/skills 加入 trusted Skills Hub taps,和 OpenAI / Anthropic / HuggingFace 一樣可搜尋安裝。

🔒

安全與可靠性

v0.16 修補 Starlette CVE-2026-48710、強化 SSRF 檢查、子程序 credential stripping、Desktop / Gateway 多個 P0/P1 穩定性修正。

808AI 一句話結論

如果你之前覺得 Hermes 很強但太工程師,v0.16 是值得重新看的版本。它保留 CLI / Gateway / Cron 的強能力,同時補上 Desktop 與 Web Dashboard 這兩個「可被一般人使用與管理」的入口。

準備好了嗎?

三個方向,任你挑

🧠 前往 GitHub 倉庫 ⚡ 三方比較 ⌨️ Claude Code 教學