AI Agent Hermes 2026.06.01

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 は不要です。

ホスト最低 vs 推奨(Gateway + クラウド API モード)
項目 最低 推奨
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 着信)
LLM プロバイダの選び方(インストール後 hermes setup / hermes model)
プロバイダ 向いている用途 設定の要点
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 のターミナルで公式スクリプトを実行します(インストールドキュメント と同一です)。

install.sh
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 と表示されます。

  1. curl インストール: Git が使えることを確認します。企業プロキシでは先に https_proxy を設定してください。
  2. シェル再読み込み: source ~/.zshrc または source ~/.bashrc。省略すると command not found になります。
  3. ヘルスチェック: hermes doctor が Python、Node、PATH、API Key など約 12 項目を確認します。
  4. バージョン確認: hermes --version は v0.14.x 以上を推奨。更新は hermes update です。
  5. モデル設定: hermes setup または hermes model~/.hermes/.env に書き込みます。
  6. スモーク対話: 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 設定、システムサービス登録の三つが必要です。

  1. Bot 作成: Telegram で @BotFather を検索し /newbot。ユーザー名は bot 終わり。Token を保存します。
  2. ユーザー ID 取得: @userinfobot にメッセージし、数値 ID をホワイトリストに使います。
  3. 対話設定(推奨): hermes gateway setup で Telegram を選び Token と ID を貼り付けます。
  4. または .env 手動: TELEGRAM_BOT_TOKEN=...TELEGRAM_ALLOWED_USERS=あなたのID
  5. 前景テスト: hermes gateway を実行し、スマホから Bot に送って応答を確認します。
  6. バックグラウンド常駐: 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 で同様です(公式メッセージングドキュメント)。

gateway.service
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 ユニファイドメモリを推奨します。
インストールと Gateway の頻出エラー
エラー / 現象 原因 対処
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.yamlmcp_servers で GitHub や DB など MCP を接続できます。GUI のないサーバーでは hermes mcp login と SSH トンネルで OAuth を完了します。

06 Hermes を載せる場所:プラットフォーム比較と JEXCLOUD まとめ

インストール先プラットフォーム比較(Gateway + Skill 複利)
プラットフォーム 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 の選定は 料金ページ、注文とリージョン遅延は 注文ページヘルプセンター をご覧ください。