2026 Hermes Agent インストール完全ガイド：macOS / Linux / VPS ワンクリック導入 + Telegram 24時間 Gateway

Hermes Agent は Nous Research が MIT ライセンスで公開する Agent 基盤です。ターミナル TUI と多チャネルゲートウェイの間に位置し、Telegram・Discord・Slack・WhatsApp・CLI などを同一メモリスタックで束ねます。セッション文脈、困難タスク後に蒸留される Skill 文書、永続ユーザーモデル Markdown、SQLite FTS5 によるエピソード検索が一体となって動作します。Tool Calling、サブ Agent、cron 風スケジュール、任意の MCP サーバ連携も、メモリストアを分岐させずに拡張できます。

インストール成功は第一関門に過ぎません。ユーザーはスマートフォンから Bot にメッセージを送り、前回の決定事項を踏まえた応答を期待します。そのためには state.db、Skill フォルダ、ゲートウェイ Webhook が再起動と OS アップデートを跨いで存続するホストが必要です。開発用 MacBook で以下の手順を試すのは問題ありませんが、Telegram 本番トラフィックをスリープするノート PC に載せるのは適切ではありません。学習ループの価値が証明された段階で、多くのチームは同一設定 tarball を専用クラウド Mac または常時オン VPS へ移行します。

本記事は、シェルアクセス、外向き HTTPS、API Key をディスクに保存する権限があることを前提とします。Hermes は OpenRouter、Nous Portal、OpenAI 互換エンドポイントなど200 以上のモデルに対応しています。インストール前に Provider を 1 つ決め、単一セッションで全経路を検証できるようにしてください。

サポートスレッドで多いのは壊れた curl パイプではなく、ホスト不一致、依存欠落、Key の置き場所の誤りです。下表は、Telegram ゲートウェイを常時稼働させるうえで各プラットフォームが満たすべき条件と、典型的な失敗パターンを対照したものです。

• Python / Node 隣接：公式インストーラがランタイム依存を取得します。最小 VPS イメージでは build-essential を入れ、curl・git・動作する python3 を先に確認してください。
• 専用 Unix ユーザー：root や共有ログインユーザーではなく、固定 Home を持つ非 root アカウントで Hermes を実行します。Token 権限とバックアップが複雑化するのを防ぎます。
• ディスク設計：state.db、Skill ツリー、ログ用に別領域を確保します。20GB root ボリュームは数週間のエピソード検索と Skill 蒸留で満杯になりやすいです。
• ネットワーク：Telegram は安定した外向き HTTPS が必要です。Webhook モードでは到達可能な HTTPS エンドポイント、または long-polling フォールバックが設定に含まれます。家庭 NAT や安価 VPS プールの CGNAT は「Mac では動くが VPS では死ぬ」典型パターンを生みます。
• シークレット管理：BotFather Token や LLM Key を git にコミットしないでください。mode 600 のファイルに置き、ゲートウェイ設定からパスのみ参照します。

インストール直後に hermes doctor を実行し、Telegram のせいにする前に依存関係の欠落を洗い出してください。環境ドリフトを先に直すほど、ゲートウェイログを掘る時間を短縮できます。

上流インストーラは macOS と Linux で同一です。VPS では SSH ログイン方法と Home 所有者だけが異なります。以下 6 ステップは、新規 NUKCLOUD インスタンスとクリーンな Ubuntu イメージの双方で検証済みの順序です。

1. 01
   ホスト準備：macOS では Xcode Command Line Tools を確認します。Ubuntu / Debian VPS では sudo apt update && sudo apt install -y curl git python3 python3-venv build-essential を実行します。hermes などの専用ユーザーを作成し、Home を tmpfs ではなく永続ディスク上に置きます。
2. 02
   公式インストーラ実行：そのユーザーで Nous Research の一行スクリプトを実行します。CLI が PATH に入り、既定の設定ディレクトリが初期化されるまで待ちます。本番ゲートウェイでは main を追跡せず、検証済みリリースを pin してください。
3. 03
   バイナリとバージョン確認：hermes --version で CLI が応答することを確認します。見つからない場合はログアウト / ログインで profile の PATH 更新を反映するか、インストーラが出力する profile 断片を source します。
4. 04
   健全性診断：hermes doctor を実行し、モデル設定前に警告をすべて解消します。Python パッケージ、ディスク権限、ゲートウェイ前提がチェックされます。このステップを飛ばすと「入ったが常駐しない」Bot が最速で現れます。
5. 05
   対話 TUI 起動：擬似 TTY 付き SSH で hermes tui を一度起動します。UI が表示され、キー入力とネットワーク到達性が確認できれば、デーモン化前のコアランタイムは正常です。
6. 06
   ベースライン記録：macOS マイナーバージョンまたは /etc/os-release、タイムゾーン、インストールパス、設定・メモリフォルダの一覧を記録します。Telegram トラフィック前に tarball 化しておけば、悪アップグレードで FTS5 が壊れた際に復元できます。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
exec $SHELL -l
hermes --version
hermes doctor
hermes setup
hermes tui

新規 VPS では、プロバイダパネルで provision し、SSH Key を登録、sshd を harden してからインストーラを走らせてください。本番 SKU を決める段階では 注文ページ でディスクと RAM を先に選び、SQLite と Skill が OS スナップショットと同じ cramped な root ボリュームを共有しないようにします。NUKCLOUD コンソール Runbook に沿って SSH 接続する場合も、インストールコマンド自体は同一です。

モデルエンドポイントのない Hermes は空のゲートウェイです。設定は Hermes Home 配下の YAML と環境ファイルに置かれます。ファイル名はリリースで変わるため、pin したバージョンの上流ドキュメントを正とし、ブックマークを維持してください。

Provider 設定：API Key を mode 600 のファイル（例：~/.hermes/secrets/openrouter.env）に書き、Provider ブロックから参照します。OpenRouter は多モデルアクセスの定番です。Nous Portal や OpenAI 互換 base URL も既存契約向けに利用できます。予算とレイテンシに合う既定モデル slug を設定します。稼働中ゲートウェイで Provider を切り替える前に、state.db と Skill ディレクトリをバックアップしてください。

メモリパス：MEMORY.md、USER.md、Skill フォルダが永続ボリューム上にあることを確認します。Docker やエフェメラル VPS イメージでは、これらのパスを明示的に bind-mount しないと、コンテナ再作成で複利記憶がリセットされます。

CLI 検証：TUI または one-shot CLI から Tool 使用またはメモリ書き込みを要求するプロンプトを送り、新セッションで事実を想起できるか確認します。制御再起動後に想起が失敗する場合は、Telegram を人間に開放する前にディスク永続性を修正してください。

export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxx"
export HERMES_DEFAULT_MODEL="anthropic/claude-sonnet-4"

Provider 設定編集後も hermes doctor を再実行してください。Key がゲートウェイデーモンと同一ユーザーコンテキストから見えるか、Doctor 出力が最速の信号です。チームが OpenClaw + Ollama ローカル Agent も評価している場合、Hermes は多チャネルゲートウェイと Skill 閉ループが強みです。同機共存は可能ですが、ユーザーとポートを分け、11434 やゲートウェイ待受ポートの競合を避けてください。

Telegram は BotFather セットアップが速く、モバイルクライアントが普及しているため、最初のゲートウェイとして最も依頼が多いチャネルです。Token 取り扱いはデモ用ショートカットではなく、本番セキュリティ作業として扱ってください。

BotFather フロー：Telegram で @BotFather を開き、/newbot を実行します。表示名と bot で終わるユーザー名を選び、HTTP API Token をコピーします。Token は ~/.hermes/secrets/telegram.token など mode 600 ファイルに保存し、Hermes の Telegram ゲートウェイ設定ブロックからパスのみ参照します。シェル履歴や git 追跡 dotfile に Token を貼らないでください。

ゲートウェイ起動：Provider 環境読み込み後、ドキュメント記載の Hermes ゲートウェイサブコマンド（例：hermes gateway setup → hermes gateway start）で起動します。グループチャットに追加する前に、Bot への DM でテストしてください。グループでは BotFather 側のプライバシー設定により、全メッセージ読取が必要かどうかが変わります。

macOS — launchd：シークレット env ファイルを読み込む LaunchAgent plist を作成します。WorkingDirectory を Hermes Home に設定し、ゲートウェイバイナリを KeepAlive true で実行します。専用ユーザーで launchctl bootstrap し、再起動後 launchctl print で状態を確認します。NUKCLOUD クラウド Mac も自宅 Mini も手順は同一です。

Linux VPS — systemd：シークレットを指す EnvironmentFile、Restart=on-failure、WantedBy=multi-user.target（または user lingering）を持つ user systemd unit を作成します。SSH ログアウト後もゲートウェイを維持するため、Hermes ユーザーで lingering を有効化します：loginctl enable-linger hermes。

1. 01
   @BotFather で Bot を作成し Token をコピー。git には載せず、chmod 600 のローカル env に保存します。
2. 02
   hermes gateway setup で Telegram を選び Token を貼り、Webhook または polling を完了します。
3. 03
   フォアグラウンドで hermes gateway start を実行し、スマートフォンから /start を送って往復と Tool ログを確認します。
4. 04
   launchd plist または systemd unit を書き込みます。管理 TUI はSSH ポートフォワードのみで到達し、管理ポートを公網に晒しません。
5. 05
   意図的にプロセスを kill し、30 秒以内の自動再起動と state.db・Skill ディレクトリの存続を確認します。
6. 06
   ログローテーションとディスクアラートを設定します。Telegram チャネルが 72 時間安定してからチームをグループに招待してください。

[Unit]
Description=Hermes Telegram Gateway
After=network-online.target

[Service]
EnvironmentFile=%h/.hermes/secrets/openrouter.env
EnvironmentFile=%h/.hermes/secrets/telegram.env
ExecStart=%h/.local/bin/hermes gateway telegram
Restart=on-failure
RestartSec=10

[Install]
WantedBy=default.target

運用メモ：SSH ポートフォワードで TUI に到達し、管理ポートをインターネットに公開しないでください。最初の 1 週間はログ増加、ゲートウェイ再起動回数、Telegram Webhook / long-poll エラーを毎日確認します。7 日間安定稼働後は state.db と Skill ツリーの週次 tarball バックアップをスケジュールしてください。day-two 用コマンド：hermes --version（ドリフト確認）、アップグレード後の hermes doctor、対話デバッグの hermes tui、Linux では journalctl --user -u hermes-telegram.service、macOS では log show --predicate フィルタです。

インストーラは意図的にクロスプラットフォームです。ホスティング選択が、Telegram ユーザーが応答の空白を感じるかどうかを決めます。共有 VPS プールは月額数百円台に見えますが、帯域ジッター、CPU オーバーサブスクライブ、long-polling セッション切断は、ユーザーモデルが「賢くなり始めた」タイミングで表面化しやすいです。自宅 Mac mini は電源と ISP をコントロールできる場合に有効です。エンタープライズチームは、文書化されたテナント境界を持つクラウド Mac または harden 済み VPS を選ぶことが多いです。

ハード購入前に Hermes 記憶の複利を検証したいチームには、NUKCLOUD の従量制クラウド Mac がキャッシュフローを保ちつつ、想起品質とサポート負荷を測れます。汎用分課金 macOS VPS は CPU オーバーセルで要約ジョブ中にゲートウェイが落ちやすいです。Telegram が本番向けの場合、月十ドル節約より、安定ディスク・予測可能な外向きネットワーク・再起動耐性の方が重要になります。