2026 年、Hermes Agent（Nous Research、GitHub 約 17 万スター）は、セッションをまたぐ記憶、Skill の自動蓄積、Gateway 経由の Telegram 等 20+ プラットフォーム接続を備えた自己進化型 AI Agentとして注目されています。「インストールできない」「API Key が通らない」「Telegram が無反応」で止まっている方へ：1 コマンドで環境を整え、6 ステップの Runbook で hermes gateway を 7×24 常駐させ、MacBook / VPS / Mac Mini M4 月額レンタルのどれが本番ホストに向くかまで整理します。
Hermes Agent はチャット UI ではなく、MIT ライセンスの常駐自律 Agentです。同種タスク完了後に再利用 Skill を自動生成し（コミュニティ実測で同類タスクの token 約 38% 削減）、SESSION → MEMORY.md → USER.md の三層記憶でコンテキストを跨ぎます。LangGraph / CrewAI のような「オーケストレーション」や OpenClaw のような「チャネル Gateway」と比べ、Hermes の差別化はネイティブ Skill 進化 + 跨 Session 永続記憶 + curl 1 本のフルスタック導入です。
本記事は「なぜ Mac に替えるか」（VPS 移行実測）や「記憶アーキテクチャ」（三層記憶ハードウェア解説）を繰り返さず、インストール Runbook に集中します：macOS / Linux / WSL2 ワンクリック、hermes doctor、LLM 設定、初回対話、Telegram Bot、Gateway デーモンです。
痛点：ドキュメントが分散し、依存関係と API Key のどちらを先にすべきか分からない。
痛点：インストール後 hermes: command not found — PATH 未更新が原因のことが多い。
痛点：Telegram DM は動くがグループ無反応 — プライバシーモードと再招待順序の落とし穴。
痛点：ノート PC 合蓋で Gateway 切断、Skill 複利が途切れる。
痛点：ヘッドレス VPS では Camoufox 等の macOS ブラウザ自動化パスが欠ける。
本記事の成果物：curl から hermes gateway start まで検収可能な 6 ステップチェックリスト。
公式 install.sh は uv 経由で Python 3.11、Node.js 22、ripgrep、ffmpeg を取得し、リポジトリを ~/.hermes/hermes-agent/ に clone します。下表は容量計画の参考です（Nous Research インストールドキュメントとコミュニティ運用知見、2026-06 整理）。
| 項目 | 最低要件 | 推奨（7×24 + Gateway） |
|---|---|---|
| OS | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+（Apple Silicon）または Ubuntu 24.04 LTS |
| メモリ | 4 GB（Gateway + クラウド API のみ） | 16 GB；ローカル推論は 32 GB 推奨 |
| ディスク | 約 1.5 GB（Skill キャッシュ含む） | 20 GB SSD 以上 |
| ネットワーク | GitHub raw と LLM API へ到達可能 | 安定した低レイテンシ出口（Telegram 体感に効く） |
「Hermes 導入で最も難しいのはコマンドそのものではなく、合蓋も深夜落ちもしないマシンを選ぶこと」
# macOS / Linux / WSL2 公式ワンクリック curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash # ヘッドレスサーバーはブラウザ自動化をスキップ可能 # curl -fsSL .../install.sh | bash -s -- --skip-browser source ~/.zshrc # または source ~/.bashrc
インストールと PATH 更新：✅ Hermes Agent installed at ~/.hermes 表示後に source ~/.zshrc、新ターミナルで hermes --version を確認します。
ヘルスチェック：hermes doctor が Python、Node、ripgrep、ffmpeg、PATH、API Key 等約 12 項目を診断します。エラーは指示に従って解消します。
LLM 設定：初めてなら hermes setup；または hermes model で OpenRouter / Anthropic / OpenAI / Ollama 等を選択し、Key を ~/.hermes/.env へ（例：hermes config set OPENROUTER_API_KEY sk-or-xxxx）。
初回対話：hermes で CLI に入り、「今日の AI ニュース要約」「現在ディレクトリのファイル数」等でツールチェーンを確認します。
Telegram Bot：@BotFather で /newbot し Token 取得；@userinfobot で数字 ID 確認；hermes gateway setup で Telegram を選ぶか、TELEGRAM_BOT_TOKEN と TELEGRAM_ALLOWED_USERS を設定します。
7×24 デーモン：hermes gateway でテスト後、hermes gateway install && hermes gateway start；macOS は launchd、Linux は sudo hermes gateway install --system + systemd が利用できます。
既定では Bot はグループ内で / コマンドのみ応答します。グループで @ メンションに反応させるには、BotFather で Group Privacy をオフにし、Bot を一度退出させてから再招待してください — 本番で最頻の「入れたのに無言」原因です。
よくあるエラー：API key not set → hermes model を再実行；ModuleNotFoundError: dotenv → システム Python ではなく ~/.hermes/hermes-agent/venv/bin/hermes を使用；アップグレード後の設定ずれ → hermes config check && hermes config migrate。
Hermes の Skill 複利はホストの長期オンラインに依存します。下表は迅速な意思決定用です（可用性は運用体感の数量級、SLA ではありません）：
| プラットフォーム | 7×24 可用性 | Skill 複利 | 向く用途 |
|---|---|---|---|
| 個人 MacBook | 合蓋で切断（約 60%） | 頻繁に中断 | POC のみ |
| Raspberry Pi 4B 8GB | 約 88% | I/O ボトルネック、長タスクタイムアウト | 実験 |
| x86 VPS 4GB | 約 99.5% | 安定だが macOS ツールチェーン欠如 | Linux のみユーザー |
| Mac Mini M4 月額 | データセンター 30 日オンライン | UMA + launchd ネイティブ常駐 | Telegram 7×24 + macOS Skill パス |
ヒント：M4 ユニファイドメモリは Gateway、ブラウザ自動化、SQLite WAL が高帯域プールを共有します。コミュニティ監視では Gateway 常駐が約 4 GB 級でも 16 GB 機種に余裕があります。リモートレンタル後は SSH で同じ install コマンドを実行できます。
~/.hermes/hermes-agent/、グローバル hermes は install スクリプトが PATH に追加。hermes update。~/.hermes/skills/ へ；ホスト落ちで複利中断 — 「7×24 必須」と直結。週末の試作ならノート PC + クラウド API で十分です。Hermes を「毎日仕事を受ける同僚」にするなら、合蓋スリープ、VPS の macOS 断絶、グループプライバシーの落とし穴が同時に効きます。自前 Mac Mini も可能ですが、まず 30 日の月額でワークフローを検証してから購入判断するのがコスト最小 — 機種詳細は レンタル料金 を参照してください。
家庭 Wi-Fi 断、VPS 過剰割当、Raspberry Pi のディスク I/O 逼迫は、Gateway を重要な瞬間に落とします — Telegram ユーザーからは「Bot がまた死んだ」と見えます。安定 7×24 の Hermes と macOS ネイティブ install・launchd 常駐が必要な本番では、NodeMini の Mac Mini M4 クラウドレンタルは「妥協ノート + 手動再起動」より省エネです。Agent の複利に集中し、深夜の hermes gateway status 修復から解放されます。
不要です。公式スクリプトが uv 経由で Python 3.11 と Node.js 22 を導入します。完了後は source ~/.zshrc と hermes doctor で検収してください。
NodeMini は独占 Mac Mini M4 の月額/四半期レンタルを提供します。最新価格は レンタル料金 を参照。Hermes が使う LLM API（OpenRouter 等）は各プロバイダへ別途お支払いです。
PowerShell 用 install スクリプト（早期 Beta）がありますが、Dashboard ターミナルは WSL2 + Linux パスを推奨します。接続と SSH の詳細は ヘルプセンター を参照してください。