Hermes Agent
自己進化するAIアシスタント

1. インストール前の準備

3つのものを5分で準備

OSとハードウェア

• 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. 1行コマンドでインストール

公式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は3つの質問をします：

結束後 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と会話

2つの質問が表示されます：

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

設定後に実行：

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

6. 3つの起動モード

1つ選ぶか、複数同時に実行

バックグラウンド常駐：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と並行利用

3つは完全に共存可能。botとprocessは独立

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

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

共有するのは以下だけ：

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

8. FAQ / トラブルシュート

安裝後找不到 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）