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

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

3つのものを5分で準備

OSとハードウェア

• macOS（Intel / Apple Siliconどちらも可）またはLinux（Ubuntu / Debianなど主要ディストリビューション）
• メモリは8GB以上。音声モードやローカルモデルを使うなら16GB以上推奨
• ストレージは約2〜3GB（91個のbundled skillsとキャッシュディレクトリを含む）
• ネットワーク：GitHub、OpenRouter / OpenAI、Telegram APIに接続できること

インストールスクリプトがuv、Python 3.11、Node.js、ripgrep、ffmpegなどの依存関係を自動処理します。事前インストールは不要です。

LLM provider key（いずれか1つ）

• OpenRouter（おすすめ）：openrouter.ai 登録 → API keyを1つ作成 → 1つの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を入力（usernameはbotで終わる必要があります。例：my_hermes_bot）
3. BotFatherが1234567890:ABCdefGHIjklMNO...のようなtokenを返します。コピーして保存してください
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がセルフテストを1回実行します（modelを一度呼び出してkeyが有効か検証）。✓ Setup completeが表示されればOKです。

4. LLM provider設定の詳細

モデル変更、provider追加、パラメータ調整をいつでも実行

よく使うmodelコマンド

モデル選びの3原則

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が検出して「このchatを信頼するか」を確認します）。ホワイトリストは自分だけに限定することを強く推奨します。第三者からの迷惑利用を避けるためです。

設定後に実行：

Listening for messages...が表示されれば成功です。Telegram botのチャット画面を開き、「Hi」と送ると、Hermesが数秒以内に返信するはずです。

6. 3つの起動モード

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

バックグラウンド常駐：launchd（macOS） / systemd（Linux）

HermesをMac miniで24/7稼働させるなら、gatewayをlaunchd / systemd serviceとして包むのがおすすめです。

実行後、~/Library/LaunchAgents/にcom.nous.hermes.gateway.plistが生成され、自動でloadされます。停止するにはhermes service uninstallを使います。

7. Claude Code / OpenClawと並行利用

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

Hermesは~/.hermes/にインストールされ、以下の2つとは完全に分離されています：

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

共有するのは以下だけ：

• システムバイナリ：uv / Python / Node.js / ffmpeg / ripgrep（1セットで十分）
• API keys（任意）：OpenRouter / OpenAI keyは3環境で共有でき、管理コストを抑えられます

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）

完全に削除したい

rm -rfではなくtrashを使うことをおすすめします。誤削除してもmacOS Trashから復元できるためです。

9. Tony実測メモ

2026/05/09 Mac mini M4 32GBで動作確認した記録

実戦での位置づけ

• Claude Code、OpenClawと合わせて3環境を完全に並行運用可能です。各自が独立したbot・独立したprocessを持ち、OpenAI / OpenRouter keyを共有できます
• HermesのActive Memory + Skill自動作成は本当の見どころで、メインagentを補完します（置き換えではありません）
• 「セカンドオピニオン」reviewerとして向いています。メインagentが書いたものをHermesにreviewさせると、別視点の指摘を拾えます
• 「Claude以外のモデルを試したい」人にも向いています。OpenRouterなら1つのkeyで200以上に接続でき、モデル選択肢が一気に広がります

あなたに合う？

10. v0.13.0 — 2026/05 新機能まとめ

この1か月、Hermesは「音声 + realtime + マルチプラットフォーム」方面に重点を置いています（2026/05/10時点）