2026 Hermes Agent インストール: 一行コマンドから Telegram 7×24 常駐へ
Hermes Agent は Nous Research が 2026 年に MIT ライセンスで公開した自己進化型 AI Agent フレームワークで、GitHub のスター数は 17 万を超えています。ウィンドウを閉じるとリセットされるチャットボットとは異なり、MEMORY.md、Skill ディレクトリ、Gateway でタスクを再利用可能な能力に蓄積しますが、その前提は 正しくインストールし、モデルを設定し、Telegram ゲートウェイを 7×24 で動かすこと です。
本記事は「この一篇で完了したい」読者向けです。① Hermes と OpenClaw・LangGraph の違いとインストール前の課題、② curl 一発 → hermes doctor → hermes setup → Telegram Gateway → launchd/systemd 常駐 の一連の手順、③ LLM 選定マトリクス・六段階検収・よくあるエラー表をまとめます。ハード選定と Raspberry Pi 実測は 三方式ハード比較、メモリ構成は 永続メモリガイド を参照してください。
01 Hermes Agent インストール前:2026 年の注目と三つの実課題
Hermes Agent は 2026 年 2 月の初版以降、「タスク終了時に Skill を自動生成し、次回同種タスクでトークンが約 38% 減る」というコミュニティ観測で注目を集めました。OpenClaw がマルチ Agent ワークフロー、LangGraph がグラフ状態機械に寄るのに対し、Hermes の差別化は ネイティブなセッション横断メモリ、20 以上のメッセージング Gateway、MCP の即時接続 です。リポジトリに Star したあと、次の三つで止まる方が多いです。
- 環境の断片化: Python 3.11、Node 22、ripgrep、ffmpeg を先に入れる必要があると思いがちですが、公式スクリプトは
uv経由で補完します。PATH を再読み込みしないとhermes: command not foundになります。 - モデル未設定: インストールは成功するのに
API key not set。CLI は開くが推論できません。 - ゲートウェイ非常駐: Telegram Bot は設定済みでもノート PC を閉じると Bot が応答せず、Skill 複利と週をまたぐ記憶が途切れます。
要約すると、「インストール + モデル + 常駐ゲートウェイ」を一つのパイプラインとして扱えるか が、Hermes をスムーズに使えるかの分かれ目です。
安定版は v0.15.1(2026.5.29) で、v0.15.0 の loopback 時 Dashboard 無限リロードなどを修正しています(公式 Release)。以下のコマンドは macOS / Linux / WSL2 向けです。Windows ネイティブ PowerShell では公式 install.ps1 が使えますが、Dashboard のチャットは WSL2 を推奨します。
02 Hermes Agent の要件と LLM プロバイダ選定マトリクス
公式インストールスクリプトの必須前提は Git のみです(git --version が通れば十分)。Python、Node、ripgrep、ffmpeg はスクリプトが検出してインストールし、sudo は不要です。
| 項目 | 最低 | 推奨 |
|---|---|---|
| OS | macOS 12+ / Ubuntu 20.04+ / WSL2 | macOS 14+(Apple Silicon)/ Ubuntu 24.04 LTS |
| メモリ | 4 GB(Gateway + API のみ) | 16 GB+(ローカル Ollama 8B) |
| ディスク | 約 1.5 GB(Skills キャッシュ含む) | 20 GB SSD+(ログとモデル重み) |
| ネットワーク | GitHub raw と LLM API に到達可能 | 安定した低遅延出口(Telegram 着信) |
| プロバイダ | 向いている用途 | 設定の要点 |
|---|---|---|
| Nous Portal | 設定なしで試したい | hermes setup --portal OAuth |
| OpenRouter | 複数モデル実験、単一 Key | OPENROUTER_API_KEY を ~/.hermes/.env へ |
| Anthropic / OpenAI | 本番 Claude / GPT | API Key または OAuth(Max プラン) |
| Ollama / VLLM | ローカル推論、プライバシー重視 | Base URL + モデル名、メモリ 16GB+ 推奨 |
ヘッドレスサーバー(GUI ブラウザ自動化なし)では --skip-browser を付け、Camoufox 関連を避けられます。設定は ~/.hermes/.env と ~/.hermes/config.yaml に集約されます。
03 Hermes Agent 一発インストール:curl から初回対話まで六段階
macOS、Linux、WSL2 のターミナルで公式スクリプトを実行します(インストールドキュメント と同一です)。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
# headless VPS optional
# curl -fsSL ... | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --version
hermes setup
hermes
スクリプトは uv → Python 3.11 → Node.js 22 → ripgrep / ffmpeg の順で入れ、~/.hermes/hermes-agent/ にクローンし、hermes を PATH に追加し、デフォルト Skills レジストリを取得します。成功時はターミナルに Hermes Agent installed at ~/.hermes と表示されます。
- curl インストール: Git が使えることを確認します。企業プロキシでは先に
https_proxyを設定してください。 - シェル再読み込み:
source ~/.zshrcまたはsource ~/.bashrc。省略すると command not found になります。 - ヘルスチェック:
hermes doctorが Python、Node、PATH、API Key など約 12 項目を確認します。 - バージョン確認:
hermes --versionは v0.14.x 以上を推奨。更新はhermes updateです。 - モデル設定:
hermes setupまたはhermes modelで~/.hermes/.envに書き込みます。 - スモーク対話:
hermesを起動し、カレントディレクトリのファイル数集計や当日の AI ニュース要約でツール連携を確認します。
短縮 URL curl -fsSL https://get.hermes-agent.org | bash も利用できます。Windows PowerShell は iex (irm .../install.ps1)、Android Termux は Linux スクリプトと同様で、公式に Termux 向け説明があります。
04 Hermes Agent の Telegram 接続と Gateway 7×24 常駐
スマートフォンから常時 Agent に届けるには、Bot 作成、Gateway 設定、システムサービス登録の三つが必要です。
- Bot 作成: Telegram で
@BotFatherを検索し/newbot。ユーザー名はbot終わり。Token を保存します。 - ユーザー ID 取得:
@userinfobotにメッセージし、数値 ID をホワイトリストに使います。 - 対話設定(推奨):
hermes gateway setupで Telegram を選び Token と ID を貼り付けます。 - または .env 手動:
TELEGRAM_BOT_TOKEN=...とTELEGRAM_ALLOWED_USERS=あなたのID。 - 前景テスト:
hermes gatewayを実行し、スマホから Bot に送って応答を確認します。 - バックグラウンド常駐: macOS は
hermes gateway install+hermes gateway start(launchd)。Linux はsudo hermes gateway install --system+ systemd、ログはjournalctl -u hermes-gateway -fです。
グループチャット: 既定のプライバシーモードでは / コマンドのみ応答します。グループ利用では BotFather で Group Privacy を無効にし、一度 Bot を外してから再招待してください。Discord / Slack も hermes gateway setup で同様です(公式メッセージングドキュメント)。
hermes gateway install
hermes gateway start
hermes gateway status
# Linux boot autostart (optional)
sudo hermes gateway install --system
sudo hermes gateway start --system
05 Hermes Agent 引用可能な数値とインストールエラー早見
- GitHub 規模(2026-06): 約 175,000 Stars、MIT、貢献者 295+ 規模(リポジトリ)。
- インストール容量: Skills キャッシュ込みで約 1.5 GB から。
~/.hermes/は三ヶ月運用で 200–600 MB 増えることが多いです。 - Skill 複利: 30 日で Skill 数 3 → 19 の観測で同種タスクのトークンが約 38% 減少。ホストの 7×24 稼働 が前提です。
- ゲートウェイメモリ(macOS まとめ): Gateway + SQLite のみで約 1.2–1.8 GB。Ollama 8B 併用時は 24 GB ユニファイドメモリを推奨します。
| エラー / 現象 | 原因 | 対処 |
|---|---|---|
hermes: command not found |
PATH 未更新 | source ~/.zshrc または新しいターミナル |
API key not set |
LLM 未設定 | hermes model または ~/.hermes/.env 編集 |
| アップグレード後設定消失 | バージョン移行 | hermes config check && hermes config migrate |
| グループで Bot が無応答 | プライバシーモード / 再招待なし | BotFather で Group Privacy をオフにして再招待 |
任意拡張として ~/.hermes/config.yaml の mcp_servers で GitHub や DB など MCP を接続できます。GUI のないサーバーでは hermes mcp login と SSH トンネルで OAuth を完了します。
06 Hermes を載せる場所:プラットフォーム比較と JEXCLOUD まとめ
| プラットフォーム | 7×24 可用性 | インストール成熟度 | 向く段階 |
|---|---|---|---|
| 個人 MacBook | 蓋を閉じると停止 | 公式 curl が最も容易 | POC / 週末デバッグ |
| Linux VPS | 高いが macOS ではない | --skip-browser が必要、一部 Skill パス差 |
DevOps チームあり |
| JEXCLOUD Mac Mini M4 | データセンター SLA、専用 IPv4 | ローカル Mac と同一コマンド列 | Telegram 本番 + ローカル 8B |
ノート PC とオーバーセル VPS の弱点は次のとおりです。① ゲートウェイ長接続が不安定(スリープ、NAT、隣接 IO)、② macOS 専用ブラウザ自動化 Skill は純 Linux で 1:1 再現不可、③ 専有メモリがないと並列サブ Agent で OOM し、hermes doctor は通っても本番が不安定です。
より堅実なのは JEXCLOUD のベアメタル Mac Mini M4 を月額で借り、SSH で本記事と同じコマンドを実行し、launchd KeepAlive で Gateway を常駐させ、~/.hermes を常にレンタルディスク上に置く 方法です。仮想化のオーバーセルなし、Telegram 着信が安定し、返却前に rsync で Skill と記憶をバックアップできます。M4.S / M4.M / M4.XL の選定は 料金ページ、注文とリージョン遅延は 注文ページ と ヘルプセンター をご覧ください。