2026 Hermes Agent インストール完全ガイド：
macOS / Linux 構築 + Telegram 7×24 常駐

2026 年に Nous Research オープンソースの Hermes Agent に目を付けた場合、本当の壁は「Prompt が書けるか」ではなく、インストールスクリプト、Python/Node 依存、LLM API Key、Telegram Bot と Gateway バックグラウンドサービスという一連の工程詳細であることが多いです。本稿は macOS / Linux / WSL2 上で Hermes を「動く」から「スマホからいつでも呼べ、マシンが 7×24 オンライン」まで進めたい開発者と小規模チーム向けです。まず六つのインストール誤解を分解し、環境対照表とホストマトリクスを示したうえで、再現可能な curl | bash、hermes doctor、hermes setup、Telegram Gateway 手順（八段階以上）を示します。記憶アーキテクチャと買い vs 借り TCO は站内 三層メモリ専文と 24 か月 TCO 文を参照してください。月額単価は NOVAKVM 価格ページ、注文は 注文ページです。以下のコマンドとバージョンは公式ドキュメントを正とし、リリース後にリンクを開き直して確認してください。

[ SECTION_01 ] // PAIN_MAP Hermes Agent インストールで最も多い六つの誤解（2026）

  • 「先に Python 3.11 と Node 22 を自分で入れる必要がある」：公式インストールスクリプトは uv でランタイムを揃えます。Git が使えれば十分です。システム Python を手動混在させると ModuleNotFoundError が起きやすくなります。
  • 「入れたらすぐ Telegram で話せる」：CLI 対話と Gateway は別経路です。チャネルは hermes gateway setup とデーモン起動を個別に行う必要があります。
  • 「hermes: command not found はインストール失敗」：多くは PATH 未反映です。新しいターミナルを開くか source ~/.zshrc で解消し、全体再インストールは不要です。
  • 「任意の Linux VPS は Mac と同等」：ドキュメントは macOS でパスが最も完全です。一部ブラウザ自動化と macOS 専用 Skill は純 Linux 上で挙動が異なります。本番前に公式プラットフォーム説明を照合してください。
  • 「グループで @Bot したのに返事がない」：Telegram のプライバシーモードではグループは / コマンドのみ応答します。BotFather で Group Privacy をオフにし、Bot を一度外して再招待してください。
  • 「ノート PC を閉じても本番 Gateway になる」：スリープでプロセスが止まります。Skill 複利とチャネルコールバックには監視付き常時起動ホストが必要で、「インストールできる」とは別問題です。

以下は Hermes 公式入口です。リリースのたびにインストーラ URL と引数を再確認してください。

Hermes Agent 公式インストールドキュメント（Nous Research）

NousResearch/hermes-agent（GitHub リポジトリ）

[ SECTION_02 ] // ENV_MATRIX Hermes Agent 環境要件：最低構成とデプロイ载体の選び方

下表はローカルインストールの実務下限です。Gateway がクラウド API のみの場合、メモリ負荷は「同機でローカル大モデル」より低くなります。金額と在庫は表に含めません。価格ページで確認してください。

Hermes Agent 環境要件（計画表、公式 SLA ではありません）
項目 最低 推奨（本番 Gateway）
OS macOS 12+、Ubuntu 20.04+、WSL2 macOS 14+（Apple Silicon）または Ubuntu 24.04 LTS
メモリ 4 GB（API + Gateway のみ） 16 GB。ローカル Ollama や大 Skill ツリーは 24–32 GB を検討
ディスク 約 1.5 GB（Skills キャッシュ含む） 20 GB+ SSD。~/.hermes/ 増分に余裕を確保
ネットワーク GitHub raw と LLM API に到達可能 安定した低遅延出口。Telegram コールバックに有利
前提依存 Git 2.30+ スクリプトが Python 3.11、Node 22、ripgrep、ffmpeg を自動導入
インストール後「どこで動かすか」：ノート PC / VPS / 月次 Mac mini M4
载体 インストール難度 7×24 Gateway 典型課題
個人 MacBook 低（curl のみ） フタ閉じで切断。POC 向き 私物データと Agent 記憶の混在
汎用 Linux VPS 中（--skip-browser 可） 稼働率は高いが RTT がツールループを遅くする macOS ネイティブブラウザ自動化パスが欠ける
NOVAKVM 月次 Mac mini M4 低（ドキュメント主経路と一致） 独占ベアメタル、launchd デーモン SSH と ~/.hermes/ バックアップの設計が必要

インストール検証だけならノート PC で十分です。Telegram + Skill 複利を数週間続けるなら、Gateway をスリープしない本番 Macに置いてください。

[ SECTION_03 ] // INSTALL Hermes Agent ワンラインインストール：curl スクリプト、PATH、hermes doctor

macOS、Linux、WSL2、Termux では、公式推奨の一行インストール（リポジトリは ~/.hermes/hermes-agent/、グローバル hermes コマンドを登録）を使います。

install.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc
hermes doctor
hermes --version

ヘッドレスサーバーでブラウザ自動化が不要なら、関連依存をスキップできます（引数は公式ドキュメントを正とします）。

install-headless.sh 
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser

hermes doctor は Python、Node、ripgrep、ffmpeg、PATH、API Key などを自己診断します。失敗項目が出たら指示に従って修正し、スキップしないでください。Windows ネイティブ PowerShell インストーラは早期 Beta です。本番では WSL2 + 上記 Linux コマンドがより安定します（公式 Installation 章を参照）。

[ SECTION_04 ] // RUNBOOK 八段階で Hermes を通す：モデル、CLI スモーク、Telegram と Gateway 常駐

  1. インストール完了と PATH 更新：~/.hermes ディレクトリを確認後 hermes doctor を実行し、ブロッキング項目がないことを確認します。
  2. LLM 設定：初めてなら hermes setup。既存 Key は hermes model または ~/.hermes/.env（OpenRouter、Anthropic、OpenAI、Ollama Base URL など）に書き込みます。
  3. CLI スモーク：hermes を実行し、実タスク（例：「現在ディレクトリのファイル種別分布を要約」）でツールチェーンと API 課金を確認します。
  4. Telegram Bot 作成：Telegram で @BotFather を開き /newbot で Token を取得。@userinfobot で自分の数値 ID を確認します。
  5. Gateway 設定：hermes gateway setup で Telegram を選ぶのが推奨。手動なら TELEGRAM_BOT_TOKEN と TELEGRAM_ALLOWED_USERS を設定します。
  6. Gateway 前景検証：hermes gateway を実行し、スマホの Bot 私聊でメッセージを送って応答を確認してからバックグラウンドへ移行します。
  7. デーモンインストール：macOS は hermes gateway install + hermes gateway start（launchd）。Linux は sudo hermes gateway install --system を選び、journalctl -u hermes-gateway -f でログを確認します。
  8. バックアップと移行規律：~/.hermes/ を定期アーカイブ。換機・解約前はディレクトリ単位で復元し、バイナリだけ再インストールして「記憶喪失」にしないでください。
gateway.env 
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status

Telegram グループ利用では、公式 Messaging ドキュメントのプライバシーモード説明を必ず読んでください。Group Privacy をオフにした後、Bot をグループから外して再招待する必要があります。

Hermes Agent Telegram 接続ドキュメント（GitHub）

[ SECTION_05 ] // TROUBLESHOOT Hermes Agent インストールと Gateway のよくあるエラー

インストールと Gateway エラー対照（コミュニティ高頻度、公式 SLA ではありません）
現象 よくある原因 対処方向
hermes: command not found PATH 未ロード source ~/.zshrc または新規ターミナル
API key not set プロバイダ未設定 hermes model または ~/.hermes/.env を編集
Missing config after update バージョンアップで設定ずれ hermes config check と hermes config migrate
ModuleNotFoundError: dotenv システム Python 誤使用 ~/.hermes/hermes-agent/venv 内バイナリを呼び出す
Telegram グループ無応答 プライバシーモード / 再招待未実施 BotFather で Group Privacy オフ後、外して再招待

リモート Mac で上記手順を実行する場合、接続とセッション安全の基線は ヘルプセンターを参照してください。独占 Apple Silicon と明確な解約消去が必要なら、個人ノート PC の長期占有より月次ベアメタルを優先検討してください。

[ SECTION_06 ] // HARD_FACTS 引用可能な技術情報と NOVAKVM まとめ

  • インストーラ動作：公式スクリプトは uv で Python 3.11、Node 22、ripgrep、ffmpeg を導入し、リポジトリを ~/.hermes/hermes-agent/ に配置します。（出典：Installation ドキュメント。リリース後に再確認。）
  • 設定ルート：環境変数と Gateway トークンは既定で ~/.hermes/.env。セッション横断記憶と Skill も同ツリーに永続化します。（出典：公式 Memory / Setup ドキュメント。）
  • モデル非依存：Hermes は Anthropic、OpenAI、OpenRouter、GitHub Copilot、Ollama などに接続可能。モデル ID と課金は各プロバイダページを正とします。
  • MCP 拡張：~/.hermes/config.yaml に mcp_servers を宣言し、hermes mcp login で OAuth 完了（headless では SSH トンネルと併用することが多い）。
  • バージョン確認：hermes --version と GitHub Releases を正とします。二次情報の Star 数や出典不明の性能順位は転載しないでください。

「インストール成功」を起点にしてください。個人ノート PC は週末 POC 向きですが、スリープ、OS 更新、私物データ混在で Gateway と Skill 複利が頻繁に途切れます。純 Linux VPS は API 経路を通せますが、ブラウザ自動化と macOS ツールチェーンで一段損失が出ることがあります。CLI で Hermes を長期利用する価値を確認したなら、より実務的な本番経路はまず月次独占 Mac mini M4で 2–4 週間 Gateway ログを取り、自前購入を判断することです。

NOVAKVM 価格ページで同時実行とディスクを選び、注文ページからノードを立て、本稿八段階でインストールと Telegram 常駐を完了してください。ネイティブ macOS インストール経路、7×24 launchd デーモン、予測可能な解約消去が必要な Hermes 本番環境では、NOVAKVM Mac mini クラウドベアメタルレンタルが主力ノート PC を 7×24 起動させるより意思決定コストが低いことが多いです。