hermes doctor で環境確認；③ hermes setup で LLM 接続；④ hermes gateway install で 7×24 化。環境マトリクス、六ステップ Runbook、エラー表、ホスト選定まで一気通貫です。
2026 年に Hermes Agent を入れる理由：OpenClaw との違い
「オープンソース AI Agent チュートリアル」を探すと、Hermes Agent、OpenClaw、LangGraph、CrewAI の比較にたどり着きます。一言で言えば、Hermes は「自宅マシンに常駐する個人オペレーター」です。USER.md / MEMORY.md / Skill を ~/.hermes に置き、Gateway がチャネルを担当します。OpenClaw はマルチチャネル Gateway と ClawHub スキル生態系が中心。LangGraph / CrewAI はオーケストレーション寄りで、記憶とデプロイは自分で組み立てる必要があります。
自進化 Skill：同種タスクは ~/.hermes/skills/ を優先ロード。コミュニティ実測では 30 日で Skill が一桁から十数個に増えたケースで、同種タスクの token が約 38% 減った例もあります（品質指標ではなく参考値）。
モデル非依存：Anthropic、OpenAI、OpenRouter、GitHub Copilot、Ollama などに対応。鍵は ~/.hermes/.env に保存します。
MCP 拡張：Model Context Protocol に対応し、GitHub やブラウザ自動化などの Server をぶら下げられます。
Hermes Agent インストール要件：macOS、Linux、VPS の選び方
| 項目 | 最低要件 | 推奨（本番 Gateway） |
|---|---|---|
| OS | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）または Ubuntu 24.04 LTS |
| Python / Node | スクリプトが 3.11 / Node 18+ を自動導入 | デフォルト Node 22、sudo 不要 |
| メモリ | 4 GB（API + Gateway のみ） | 16 GB（ブラウザ自動化 + ローカル 7B フォールバック） |
| ディスク | 約 1.5 GB（Skills キャッシュ含む） | ≥ 20 GB SSD |
| ネットワーク | GitHub raw と LLM API へ到達可能 | 低遅延で安定した出口 |
| ホストシナリオ | 7×24 体感 | 向くフェーズ |
|---|---|---|
| ノート PC 蓋閉じ | ≈ 60%、Skill 複利が途切れやすい | POC のみ |
| x86 VPS 4GB | ≈ 99.5%、macOS 専用 Skill パスなし | Linux 専門ユーザー |
| Mac Mini M4 月額 | データセンター SLA、launchd ネイティブ | Telegram 本番、Camoufox 自動化 |
Hermes Agent 完全インストール：六ステップ Runbook（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
ヘッドレスサーバーではブラウザ依存を省略できます：bash -s -- --skip-browser。スクリプトは uv、Python 3.11、Node 22、ripgrep、ffmpeg を入れ、リポジトリを ~/.hermes/hermes-agent/ に配置し、グローバル hermes を PATH へ追加します。成功の目印：✅ Hermes Agent installed at ~/.hermes。
インストール実行：上記 curl。Windows は PowerShell 版 install.ps1 もありますが、本番は WSL2 + Linux スクリプト推奨です。
Shell 再読み込み：source ~/.zshrc または source ~/.bashrc。hermes: command not found の典型対処です。
ヘルスチェック：hermes doctor が Python、Node、ripgrep、ffmpeg、PATH、API Key など約 12 項目を検査。hermes --version で v0.14.x / v0.15 候補を確認します。
モデル設定：hermes setup のウィザード、または hermes model で OpenRouter / Anthropic / Ollama を選択。鍵は ~/.hermes/.env へ。例：hermes config set OPENROUTER_API_KEY sk-or-xxxx。
CLI スモーク：hermes を起動し「今日の AI ニュースを要約」「カレントのファイル数を数えて」などでツール呼び出しとルーティングを確認します。
更新と移行：日常は hermes update。アップグレード後に設定不足が出たら hermes config check && hermes config migrate を実行します。
Hermes Agent Telegram 接続：BotFather から gateway install まで
CLI だけでは「その PC 上の会話」に留まります。スマホからいつでも指示を出すには Gateway が必要です。Telegram で @BotFather → /newbot → Token 保存 → @userinfobot で自分の数字 ID を控えます。
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
対話ウィザードが TELEGRAM_BOT_TOKEN と TELEGRAM_ALLOWED_USERS を書き込みます。Linux 本番は sudo hermes gateway install --system と journalctl -u hermes-gateway -f でログ確認。macOS は launchd ユーザーサービスで十分です。
| エラー / 現象 | 原因 | 対処 |
|---|---|---|
hermes: command not found | PATH 未反映 | 端末再起動または rc を source |
API key not set | LLM 未設定 | hermes model |
| グループで無応答 | Bot プライバシー | BotFather で Group Privacy オフ、再招待 |
ModuleNotFoundError: dotenv | システム Python 誤使用 | ~/.hermes/hermes-agent/venv/bin/hermes を使う |
ヒント：よく使うのは hermes tools、hermes config check です。MCP は ~/.hermes/config.yaml の mcp_servers で宣言し、ヘッドレスでは hermes mcp login + SSH トンネルで OAuth を完了します。
インストール後：Skill 複利と Mac Mini M4 ホストの数値
Star 規模：2026 年 6 月時点で hermes-agent は約 174,720 Star。インストールと Telegram ドキュメントは macOS パスが最も成熟しています。
消費電力：M4 アイドル約 4–6W、Gateway + 自動化で典型 15–25W。常時稼働向きです。
統合メモリ：16GB UMA では Gateway 常駐が約 4GB 級。Camoufox、SQLite WAL と同一アドレス空間を共有し、x86 小 VPS より swap 揺れが少ない傾向です。
ノートの蓋閉じ、Raspberry Pi の I/O ボトルネック、Linux VPS だけでは macOS ブラウザ Skill が使えない——これらは「インストール失敗」ではなく、ホスト選定ミスによる Gateway SLA 不足です。Telegram で 7×24 受注し Skill を蓄積するなら、MESHLAUNCH の Mac Mini M4 クラウド裸機月額が現実的です。SSH から同じ curl 手順、launchd 常駐、解約前に ~/.hermes を丸ごと移行可能。レンタル料金で日単位試走、運用境界はヘルプセンターをご確認ください。
不要です。install.sh が uv で Python 3.11 と Node 22 を入れます。doctor が失敗する場合は、システム Python ではなく venv 内の hermes を使っているか確認してください。
BotFather で Group Privacy をオフにしたあと、Bot をグループから外して再招待する必要があります。TELEGRAM_ALLOWED_USERS も確認してください。Gateway 専用にM4 を日額レンタルして切り分け試験するのも有効です。
ディスク上の記憶は残りますが、Gateway オフライン中は Skill 複利と Cron が止まります。本番では hermes gateway install を 7×24 ホストで動かしてください。詳細は三層メモリ編を参照ください。