2026 Hermes Agent インストール完全ガイド：curl 一行から Telegram 24/7 Gateway（macOS / Linux / Mac クラウド）

1. このガイドの読者

すでに 3層メモリと常時ホスト を読み、Hermes が 24/7 を要する理由は分かっている方へ——ここでは手順に絞ります。Hermes Agent 公式の一行スクリプトから、スマホ Telegram で安定応答し、深夜も Gateway が生きている状態まで。上流 install.sh、hermes doctor で警告ゼロ、hermes setup / hermes model、BotFather、hermes gateway setup と hermes gateway install を網羅。macOS 実機・Linux VPS・SSH の Mac クラウドのいずれでも可——Mac mini 所有は前提にしません。ハード選定と TCO は ラズパイ / VPS / Mac mini 比較 を参照。

2. curl 前の三つの痛点

1. 入るが Gateway が上がらない。 API Key が ~/.hermes/.env に無い、terminal.backend 誤り、他 Agent とのポート競合で hermes --version だけ成功し Telegram は無音。
2. Token は30秒、プロセスは眠れない。 BotFather は速いが、long-polling / webhook は Gateway の常時稼働が必要——ノートのスリープ、家庭回線の揺れ、WSL2 の Windows 休眠が毎日切断する。
3. Linux VPS は「動く」が macOS ワークフローとズレる。 Linux でも 20+ チャネルと七つのターミナルバックエンドを使える一方、Keychain・Xcode・Camoufox 系 Skill はネイティブ macOS かレンタル Mac 向き。

3. 環境要件（最低 vs 推奨）

ヘッドレスでは bash -s -- --skip-browser でブラウザ自動化をスキップ可能。Windows ネイティブは未成熟のため WSL2 後に Linux 手順を推奨。

4. 平台比較：MacBook / ラズパイ / VPS / Mac mini レンタル

表はどこで下の Runbook を走らせるかの判断用。本番 Telegram ブリッジは「Linux VPS + systemd」か「Mac mini M4 レンタル」に収束しやすく、通勤用ノートに Gateway を背負わせない。

5. 引用可能スペック（2026）

• コミュニティ： GitHub Stars 約 17 万+（2026-06）、MIT、Nous Research 保守；安定 v0.14.x、候補 v0.15.0。
• インストーラ： 公式 install.sh が uv、Python 3.11、Node 22、ripgrep、ffmpeg を入れ、~/.hermes/hermes-agent/ に展開、hermes を PATH へ。
• チャネルとモデル： 単一 Gateway で 20+ IM；OpenRouter 等 300+ モデル；Skill ヒット後 token 約 38% 削減 の実測報告あり（常時オンライン前提）。

6. 七ステップ Runbook

ステップ 1 — ホストと基本パッケージ

macOS は xcode-select --install；Ubuntu/Debian は curl git build-essential。Unix ユーザー hermes を分離し、本番署名鍵と混ぜない。GitHub raw と LLM API への HTTPS 出口を確認。

ステップ 2 — 公式一行インストール

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc   # または source ~/.bashrc
hermes --version

成功目安：✅ Hermes Agent installed at ~/.hermes。Mac クラウドでも SSH から同一コマンド。

ステップ 3 — doctor とセットアップ

hermes doctor
hermes setup

hermes doctor は Python・Node・PATH・API Key・ffmpeg など十数項目。hermes setup で一括設定；上級者は hermes model で OpenRouter / Anthropic / Ollama を切替。鍵は ~/.hermes/.env へ、例：hermes config set OPENROUTER_API_KEY sk-or-xxxx。

ステップ 4 — 初回 CLI 会話

hermes

対話シェルで「このディレクトリのファイル数を数えて」等を試し、ツールチェーンとルーティングを確認。

ステップ 5 — Telegram（BotFather）

Telegram で @BotFather → /newbot → Token コピー；@userinfobot で自分の数値 ID。

hermes gateway setup

Telegram を選び Token と TELEGRAM_ALLOWED_USERS を入力。グループは Group Privacy をオフにし Bot を一度外して再招待。手動なら ~/.hermes/.env へ。

ステップ 6 — Gateway 常駐サービス

hermes gateway install
hermes gateway start
hermes gateway status

macOS は launchd ユーザーサービス；Linux は sudo hermes gateway install --system で起動登録、ログは journalctl -u hermes-gateway -f。

ステップ 7 — 受け入れスモーク

Telegram 送信は 1 RTT 以内に応答；ホスト再起動後も再テスト；hermes cron でハートビート可。OS アップグレード前に ~/.hermes/ を暗号化バックアップ。

補足：モデル階層とコスト

hermes model list
hermes model set default openrouter/anthropic/claude-sonnet-4
hermes config set inference.ollama.base_url http://127.0.0.1:11434

実運用では「安価モデルで意図分類・短文、強モデルで多段 Skill」が定石です。Telegram グループで長いツールチェーンが頻発するなら、デフォルトを強モデルにしすぎると課金が跳ねます。cron と対話セッションで別デフォルトを切る方が事後レート制限より安定。ローカル Ollama は 16GB Apple Silicon で 8B–13B の補助向きですが、Gateway と同居時は OS 用に 4GB 以上を空けてください。

補足：Webhook と long-polling

個人 Bot は long-polling で十分なことが多く、公開 HTTPS は不要です。固定ドメイン環境では webhook で遅延を下げられますが、プロセスの 24/7 はどちらも同じです。家庭 NAT 裏で webhook を張ると逆プロキシと証明書更新が増え、VPS や Mac クラウドへ移す方が安いケースも多いです。

6b. 鍵・権限と OpenClaw 共存

Bot Token とクラウド API キーを公開 Git に載せない。環境変数か macOS Keychain 経由のデプロイスクリプトを推奨；Linux では ~/.hermes を 700 にし、サービスユーザー hermes のみ読取。同一ホストで OpenClaw も動かす場合、ポート競合に注意（OpenClaw は 18789 が一般的）。Hermes と共存可だが hermes doctor でポートと terminal.backend の上書きを確認。本番 Telegram は TELEGRAM_ALLOWED_USERS で自分の user id のみに絞り、スキャンされた Bot の課金暴走を防ぎます。

リモート Mac クラウドでは Unix ユーザーを分離し、SSH 鍵と Apple ID を混ぜない。返却前にプラットフォームの消去手順と ~/.hermes バックアップ内 Token の削除を。ノートから DC へ移すとき、旧機の launchd を unload しないと同一 Token で二重 Gateway が「たまに無応答」を起こします。

7. launchd と systemd

macOS（launchd）： hermes gateway install は ~/Library/LaunchAgents/ に書き込み KeepAlive 付き。チャネルやモデル変更後：

hermes gateway restart
launchctl kickstart -k gui/$(id -u)/com.nousresearch.hermes.gateway
launchctl print gui/$(id -u)/com.nousresearch.hermes.gateway | grep state

ログは ~/Library/Logs/hermes/ へ。Screen Sharing デバッグ時も SSH 以外の不要な開放は避けます。

Linux（systemd）： loginctl enable-linger hermes の後 systemctl --user enable --now hermes-gateway.service。systemctl --user status hermes-gateway で active を確認。SSH 切断後も動くこと。VPS 向きだが Keychain・Xcode・Apple 通知 Skill は macOS ノードに残し、Linux は Gateway と API 推論に専念する構成が現実的です。

8. エラー対照表

9. FAQ

WSL2 は？ 実験可；Windows 休眠で 24/7 Telegram は不安定——Gateway は別の常時ホストへ。再起動で Skill は消える？ ディスク上の Skill とユーザーモデルは残り、プロセス内コンテキストのみ消える——移行前に ~/.hermes をバックアップ。Telegram 必須？ いいえ、Discord / Slack 等も hermes gateway setup で可；検収は BotFather が最速。

9b. ノートから DC へ移す最小チェックリスト

MacBook で CLI が通っているなら、移行は次の順が安全です。（1）新ホストで install.sh 再実行、または ~/.hermes を rsync して hermes doctor；（2）BotFather Token は再利用可だが旧 launchd は必ず停止；（3）hermes gateway install 後、別アカウントや第二端末からテストし、ローカル残骸セッションの応答と混同しない；（4）hermes gateway status のサービス名とログパスを Runbook に記録；（5）初回再起動後は cron 検証まで 7 分待ち、TZ/NTP ずれを除外。最後にプラットフォーム比較表の 24 か月コスト感と実際の月額請求を突き合わせ、「入るが維持できない」を防ぐ。

10. 結論

MacBook なら午後にステップ 1–5 まで進められるが、スリープと家庭回線で長期 Telegram ホストには不向き。ラズパイは安いが OOM；$5 VPS は稼働率良いが macOS ツール欠如；WSL2 はデスクトップ休眠を継承。 curl | bash、hermes doctor 緑、BotFather 成功後の durable 解は 眠らないハード への hermes gateway install——多くの読者にとって Mac mini M4 級 macOS（購入か月次レンタル）。

通勤ノート・廉価 VPS・WSL2 でもコマンドは同じだが、蓋・macOS 欠如・休眠で 24/7 に負ける。VPSMAC Apple Silicon Mac クラウド は月額固定で DC SLA・SSH・返却時消去を得られ、手順はデスクの Mac mini と同一——シェルだけがデータセンター。一行 curl から午前3時の Telegram まで、通勤機に縛られない最短ルートです。