curl ワンクリック · hermes doctor · モデルと Gateway · プラットフォーム比較 · 6ステップ Runbook
2026 年に Nous Research Hermes Agent（GitHub 約 17.4 万 Star）を動かしたいのに PATH、API Key、Telegram 無応答で止まっていませんか。本記事は完全インストール手順を示します：公式 curl | bash で Python 3.11 / Node 22 を自動導入、hermes doctor の 12 項目チェック、hermes setup でモデルと Gateway を設定し、Telegram 7×24 まで到達します。環境要件、ホスト比較、6 ステップ Runbook、よくあるエラー表を含み、本番常駐には Mac Mini M4 月額レンタルを推奨する理由も説明します。
Hermes Agent（Nous Research、MIT）は 2026 年 GitHub で最も注目されるオープンソース 自己進化 AI エージェントの一つです。一種類のタスクを完了すると再利用可能な Skill を自動生成し、コミュニティ報告では同種タスクの token が約 38% 削減されます。Gateway 経由で Telegram / Discord / Slack など 20+ プラットフォームに接続し、MCP と Claude / OpenRouter / Ollama など複数バックエンドをサポートします。OpenClaw や LangGraph との違いは セッション跨ぎ永続メモリ（SESSION → MEMORY.md → USER.md）とネイティブ Skill 自動作成にあり、公式スクリプトは $5 級 VPS や Mac でも動きます——ただし本番 7×24 と macOS ブラウザ系 Skill はホスト選定が重要です。
本記事は概念論ではなく、インストール期の 5 大痛点を解決します：hermes: command not found、API Key 未設定、アップグレード後の設定ドリフト、Telegram グループ無応答、「ローカル PC を閉じると Gateway が止まる」常駐問題。インストール済みでメモリ設計を深掘りする場合は三層メモリと 7×24 実測を参照してください。
| 環境項目 | 最低要件 | 推奨（本番 Gateway） |
|---|---|---|
| OS | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+（Apple Silicon）または Ubuntu 24.04 LTS |
| Python / Node | スクリプトが 3.11 / 22 を自動導入 | 手動不要。hermes doctor を基準に |
| メモリ | 4 GB（Gateway + クラウド API のみ） | 16 GB+；ローカルモデルは 32 GB UMA 推奨 |
| ディスク | 約 1.5 GB（Skills キャッシュ含む） | 20 GB SSD+、FTS5 とログ増分を確保 |
| ネットワーク | GitHub raw + LLM API に到達可能 | 低遅延で安定、IM webhook に有利 |
Python/Node を先に入れる必要があると思い込む：公式 install.sh が uv で Python 3.11、Node 22、ripgrep、ffmpeg を導入。sudo 不要です。
インストール後に Shell を source しない：PATH 未更新で command not found。source ~/.zshrc または新しいターミナルを開きます。
hermes doctor をスキップ：12 項目チェックで API Key、ffmpeg、PATH を事前検出。盲実行より 1 時間節約できます。
ヘッドレスでブラウザ依存を有効のまま：VPS では --skip-browser を付け、Camoufox 系依存で失敗しないようにします。
ローカル POC を本番扱い：MacBook スリープで Gateway が止まり Skill 複利が途切れます。7×24 には専用ホストが必要です。
同じ curl | bash でも、ホスト次第でuptime、IO、macOS ネイティブ経路が変わります。インストール成功 ≠ Gateway と Skill 複利の 7×24 運用——下表は「Hermes 導入後」の本番体感をまとめたものです（コミュニティとデータセンター実測レンジ）。
| プラットフォーム | 7×24 可用性 | Skill 複利 | 月額コスト感 | 向く用途 |
|---|---|---|---|---|
| 個人 MacBook | ≈ 60%（蓋を閉じると停止） | 頻繁に中断 | ¥0 ハード + 高ストレス | POC / ローカル CLI のみ |
| ラズパイ 4B 8GB | ≈ 88% | I/O ボトルネック、長タスクタイムアウト | ハード初期費用 | 趣味程度、本番 Gateway 非推奨 |
| x86 VPS 4GB | ≈ 99.5% | 安定、macOS Skill なし | 従量課金 | 純 API + Telegram、ブラウザ自動化不要 |
| Mac Mini M4 月額 | DC SLA、30 日級 100% | UMA + launchd 常駐、Skill 蓄積 | 固定月額 | Telegram 7×24 + Camoufox / ローカル Ollama |
インストールは 10 分；7×24 ホストを選ぶことで Skill が複利になるか、毎回ゼロからになるかが決まります。
M4 統一メモリは Gateway（コミュニティ報告で常駐約 4.2 GB）、ブラウザ自動化、SQLite WAL が同一アドレス空間を共有します。launchd は macOS で公式テスト経路に近く、Linux systemd より適合します。短期検証なら 1 か月レンタルで Telegram と Skill 曲線を確認してから購入判断——30 日体験記を参照。
以下は macOS / Linux / WSL2 共通です。ヘッドレス VPS はステップ 1 に --skip-browser を追加します。データと設定は既定で ~/.hermes/ に保存されます。アップグレード前にバックアップしてください。
ワンクリックインストール：公式スクリプトを実行し ✅ Hermes Agent installed at ~/.hermes を待ち、source ~/.zshrc（Linux は ~/.bashrc）。
ヘルスチェック：hermes doctor で Python、Node、ripgrep、ffmpeg、PATH を確認。hermes --version で v0.14+。
モデル設定：hermes setup または hermes model。OpenRouter / Anthropic / Nous Portal 等を ~/.hermes/.env に。
CLI スモーク：hermes で対話し、ツール呼び出し付きタスク（例：「現在ディレクトリのファイル数を数える」）で API 疎通を確認。
Telegram：BotFather で Bot 作成 → hermes gateway setup で Telegram を選択、Token と TELEGRAM_ALLOWED_USERS を設定。グループはプライバシーオフ後に Bot を再招待。
7×24 常駐：hermes gateway install && hermes gateway start。Linux は sudo hermes gateway install --system、macOS は launchd ユーザーサービス。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc hermes doctor hermes setup hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
API Key は手動でも：hermes config set OPENROUTER_API_KEY sk-or-xxxx または ~/.hermes/.env に追記。アップグレード後に設定不足なら hermes config check && hermes config migrate を実行します。
次の症状は「スクリプト成功後にサービスが使えない」段階で多いです——表に沿って順に排除し、モデル変更・ディレクトリ移行・Gateway 再インストールを同時に行わないでください。
| エラー / 現象 | よくある原因 | 対処 |
|---|---|---|
| hermes: command not found | PATH 未更新 | source ~/.zshrc または新ターミナル |
| API key not set | LLM 未設定 | hermes model または ~/.hermes/.env |
| Missing config after update | バージョンアップ後の設定ドリフト | hermes config check && hermes config migrate |
| ModuleNotFoundError: dotenv | システム Python を誤使用 | ~/.hermes/hermes-agent/venv/bin/hermes を使用 |
| Telegram グループ無応答 | Bot プライバシーモード | BotFather で Group Privacy をオフ、再招待 |
Hermes は任意の MCP Server（GitHub、DB、ブラウザ等）を ~/.hermes/config.yaml の mcp_servers で宣言できます。ヘッドレス OAuth は hermes mcp login + SSH トンネル。本番は単一チャネル安定後に MCP を重ね、ログ二分で切り分けやすくします。
ヒント：Windows でも PowerShell インストールスクリプトがありますが、Dashboard /chat のターミナルは WSL2 依存です。WSL2 + Linux 手順を推奨し、本 Runbook と一致させます。
~/.hermes/hermes-agent/、グローバルコマンドは PATH に追加。hermes doctor は約 12 項目（Python 3.11、Node 22、ripgrep、ffmpeg、API Key 等）。ノート PC や家庭 NAS でもインストール検証はできますが、スリープ、VPS IO、macOS ブラウザ Skill 不足で Telegram 7×24 体験は落ちます。ラズパイはローカル 8B と長タスクに弱いです。Hermes を「常駐同僚」にするチームには、Mac Mini M4 月額レンタルが uptime、UMA、launchd を予測可能 OpEx にまとめ、再インストールループより時間を節約します。
本 Runbook 完了後に本番 7×24 ノードが必要なら、VpsMesh の Mac Mini M4 クラウドレンタル：SSH 納品、リソースパネル、解約前に ~/.hermes/ 全体をバックアップ可能です。プランは Mac Mini M4 レンタル料金、デプロイは ヘルプセンター、注文は 注文ページ。
注意：週末にホスト変更、Hermes メジャーアップ、Telegram ホワイトリスト変更を同時に行わないでください——切り分け不能になります。先に hermes gateway status を 24h 安定させ、モデルや MCP はその後に。
不要です。公式 install.sh が uv で Python 3.11、Node.js 22、ripgrep、ffmpeg を導入し、~/.hermes/hermes-agent/ に配置します。source ~/.zshrc 後 hermes doctor で 12 項目を確認してください。
デフォルトプライバシーモードではグループは / コマンドのみ。BotFather → Bot Settings → Group Privacy で Turn off、Bot を一度外して再招待。TELEGRAM_ALLOWED_USERS に数字 ID を含め、hermes gateway status が稼働中であることを確認します。