Hermes Agent
Asistente de IA que mejora solo

1. Preparación previa

Tres cosas listas en cinco minutos

Sistema operativo y hardware

• macOS（Intel 或 Apple Silicon 都可）或 Linux（Ubuntu / Debian 主流發行版）
• 記憶體 8 GB 起跳；想跑語音Modo或本地模型建議 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 並存，按任務切換）

Token de bot de Telegram (opcional pero muy recomendado)

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

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

2. Instalación de una línea

install.sh oficial — automático en unos 5 minutos

Este comando hará lo siguiente:

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 Comando加到 ~/.local/bin/（記得確認在 $PATH 裡）

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

3. Primera configuración con hermes setup wizard

Wizard interactivo, tres preguntas

El wizard pregunta tres grupos de cosas:

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

4. Configurar proveedor LLM 細節

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

Comandos model útiles

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 切到「深度思考」Modo，/fast default 切回「快速回應」——不必離開 session 重設模型。

5. Conectar Telegram gateway

Habla con Hermes desde el móvil en cualquier lugar

Aparecen dos preguntas:

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

Después de configurar, ejecuta:

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

6. Tres modos de ejecución

Elige uno o ejecuta varios

Servicio persistente：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. Usar junto con Claude Code / OpenClaw

Las tres herramientas pueden coexistir con bots y procesos separados

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

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

Solo comparten:

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

8. FAQ / Solución de problemas

安裝後找不到 hermes Comando

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

La API key sigue siendo rechazada

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

El bot de Telegram no responde

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

Eliminar por completo

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

9. Prueba real de Tony

2026/05/09 Registro probado en Mac mini M4 32GB

Posicionamiento práctico

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

¿Es para ti?

10. v0.13.0 — 2026/05 nuevas funciones總覽

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