Hermes Agent
會自己進化的 AI 助手

1. 安裝前準備

三樣東西，五分鐘可備齊

作業系統與硬體

• macOS（Intel 或 Apple Silicon 都可）或 Linux（Ubuntu / Debian 主流發行版）
• 記憶體 8 GB 起跳；想跑語音模式或本地模型建議 16 GB+
• 儲存空間 約 2-3 GB（含 91 個 bundled skills 與快取目錄）
• 網路：需要連 GitHub、OpenRouter / OpenAI、Telegram API

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

LLM provider key（擇一）

• OpenRouter（推薦）：openrouter.ai 註冊 → 開一支 API key → 一個 key 通 200+ 家模型（Claude / GPT / Gemini / Llama / DeepSeek 等）
• OpenAI：platform.openai.com 申請 API key
• Anthropic：console.anthropic.com 申請 API key
• 都可以混用（Hermes 支援多 provider 並存，按任務切換）

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 分鐘自動跑完

這條指令會做這些事：

1. 檢查並安裝 uv（Python 套件管理器）
2. 下載 Hermes Agent 源碼到 ~/.hermes/hermes-agent/
3. 建立 Python 3.11 虛擬環境 + 安裝 ~80 個 Python 依賴
4. 安裝系統工具：Node.js、ripgrep、ffmpeg（如果還沒裝）
5. 下載並掛載 91 個 bundled skills（humanizer、p5js、architecture-diagram、sketch、highlighter 等）
6. 建立空 config.yaml、cron 目錄、logs 目錄
7. 把 hermes 指令加到 ~/.local/bin/（記得確認在 $PATH 裡）

~/.hermes/
├── hermes-agent/      # 源碼
├── config.yaml        # 設定檔（key、model、gateway 全在這）
├── audio_cache/       # 語音模式快取
├── image_cache/       # 圖像快取
├── cron/              # 排程 job 設定
├── hooks/             # 觸發事件腳本
└── logs/              # 執行紀錄

3. hermes setup wizard 首次設定

互動式精靈，3 個問題搞定

Wizard 會問你三組問題：

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

4. 設定 LLM provider 細節

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

常用 model 指令

model picking 三條原則

1. 日常 chat / brainstorm：用便宜快的（GPT-4o-mini、Claude Haiku、Gemini Flash）
2. 重要決策 / 長文寫作：用最頂的（Claude Opus 4.7、GPT-5、Gemini 2.5 Pro）
3. 大量資料 / 長 context：選 1M context 的（Gemini 2.5 Pro、Claude 1M context）

/think 與 /fast 動態切換

v0.13.0 新增的功能：在聊天中直接打 /think default 切到「深度思考」模式，/fast default 切回「快速回應」——不必離開 session 重設模型。

5. 接上 Telegram gateway

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

會跳出兩個問題：

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

設定完跑：

看到 Listening for messages... 就成功——打開你 Telegram bot 對話視窗，傳一句「Hi」，Hermes 應該幾秒內回覆。

6. 三種啟動模式

挑一個，或一起跑

背景常駐：launchd（macOS） / systemd（Linux）

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

跑完會在 ~/Library/LaunchAgents/ 產生 com.nous.hermes.gateway.plist，並自動 load。要停掉用 hermes service uninstall。

7. 與 Claude Code / OpenClaw 並行

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

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

• Claude Code → ~/.claude/
• OpenClaw → ~/.openclaw/

共用的只有：

• 系統二進制：uv / Python / Node.js / ffmpeg / ripgrep（一份就夠）
• API keys（選用）：OpenRouter / OpenAI key 可以三套共享，省管理成本

8. 常見問題 / 故障排除

安裝後找不到 hermes 指令

把 ~/.local/bin 加到 $PATH：

API key 一直被拒

• 檢查 key 開頭有沒有多餘空白：跑 hermes model test 看 error
• OpenRouter key 必須以 sk-or- 開頭；OpenAI 是 sk-；Anthropic 是 sk-ant-
• OpenRouter 帳號要先充值 $5 美金以上才能用付費模型；免費模型仍可用

Telegram bot 沒反應

• 確認 hermes gateway 還在跑（看終端機有沒有 Listening for messages...）
• 有沒有把這個 bot token 同時給別人 / 別的 process 用
• 確認你的 chat_id 已加入白名單（hermes gateway allowlist）

想完整移除

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

9. Tony 第一手實測

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

實戰用法定位

• 跟 Claude Code、OpenClaw 三套完全可以並行——各自獨立 bot、獨立 process、共享 OpenAI / OpenRouter key
• Hermes 的 Active Memory + 自動 Skill 建立是真亮點，跟主 agent 互補（不是取代）
• 適合當「第二意見」reviewer——主 agent 寫東西，丟給 Hermes review，會抓到不同視角
• 對「想試 Claude 以外模型」的人——OpenRouter 一個 key 通 200+ 家，瞬間打開模型選擇

適不適合你？

10. v0.13.0 — 2026/05 新功能總覽

過去 1 個月 Hermes 重點往「語音 + realtime + 多平台」方向走（截至 2026/05/10）