2026 年、Nous Research がオープンソース公開した Hermes Agent は、チャット UI ではなくあなたのマシン上で動く長期プロセスとして設計されています。セッション横断の記憶、Skill の自動蓄積、Telegram など二十以上のゲートウェイ経由の遠隔タスクが一つの体験です。多くの人が最初の日に躓くのは、依存関係の不整合、API キーの誤設定、Telegram Bot が返信しないといった典型的な失敗です。
本文は macOS / Linux / WSL2 でゼロから Hermes を通す開発者と小規模チーム向けです。インストール前の課題とホスト比較を整理したうえで、公式一行スクリプト → hermes doctor → hermes setup → 初回対話 → Telegram Gateway → launchd 常駐 までの六段チェックリストを示します。読み終えた時点で、~/.hermes/ をノート PC に置くべきか、7×24 オンラインの Mac mini に置くべきかを判断できるはずです。
01 Hermes Agent インストール前に知っておく課題：OpenClaw とは別ルートです
Hermes とコミュニティでよく比較される OpenClaw はどちらも Gateway を持ちますが、デフォルトの設計思想が異なります。OpenClaw はマルチチャネル制御面とプラグイン生態系に寄り、Hermes は三層メモリ + Skill 自己進化 + MCP を前面に出します。公式インストーラは Python 3.11、Node.js 22、ripgrep、ffmpeg などをまとめて ~/.hermes/hermes-agent/venv に入れるため、システム Python を手で組み立てる必要がありません。
- 依存チェーンが長い：手動 pip では「システム Python と venv の不一致」「dotenv 不足」などが起きやすく、公式は常にインストーラ経由を推奨しています。
- スリープで Gateway が切れる：MacBook での検証は可能ですが、Cron とメッセージングにはスリープしない専用 Mac が向いています。
- Linux VPS の隠れコスト：x86 VPS でも Gateway + クラウド API は動きますが、macOS 専用のブラウザ自動化パスは Linux では再現が難しい場合があります。
- Telegram グループのプライバシー：Bot のデフォルト設定では通常メッセージが見えません。Hermes の不具合ではなく BotFather のポリシーです。
- バージョン漂移：アップグレード後に
Missing config after updateが出たらhermes config checkと migrate で schema を揃えてください。
結論として、インストール自体は 15 分程度で完了できます。体験を決めるのはホストが 7×24 オンラインか、および
~/.hermes/のバックアップと移行可能性です。
コマンドと挙動は Nous Research 公式ドキュメントを正とします。リリースのたびに下記リンクで再確認してください。
02 Hermes Agent の要件とホスト比較：どのマシンに載せると楽か
公式インストーラは macOS 12+、Ubuntu 20.04+、WSL2、Termux をサポートしています。Windows ネイティブ PowerShell は早期 Beta のため、本番では WSL2 で Linux スクリプトを使う方が安全です。下表は選型用であり、公式 Prerequisites の代替ではありません。
| ホスト | 7×24 可用性 | 導入コスト | Skill / Gateway 複利 | 典型弱点 |
|---|---|---|---|---|
| MacBook ローカル | スリープで切断しやすい | 低（公式パスが最も成熟） | 検証向き、本番は弱い | 蓋閉じ・OS 更新の再起動 |
| Raspberry Pi 4B 8GB | 体感約 88% | 中（IO と ARM パッケージ） | 軽量 Gateway は可 | 長時間ジョブ・ブラウザ自動化のタイムアウト |
| x86 Linux VPS | 約 99.5% | 中（ヘッドレスは --skip-browser） | API モードは安定 | macOS 専用ツールチェーンなし |
| Mac mini M4 月額ベアメタル | データセンター SLA | 低（SSH はローカル同等） | launchd + UMA に適合 | リージョンと契約期間の選定 |
最低スペック（公式インストールページ）：Gateway + クラウド API のみなら 4 GB RAM から可能です。ローカルモデルやブラウザ自動化を使うなら 16 GB ユニファイドメモリ を推奨します。ディスクは 1.5 GB（Skills キャッシュ含む）を確保し、本番では 20 GB SSD の余裕があると安心です。リモートサーバーではネットワーク遅延とファイアウォールで Telegram 長時間接続が切れないかも確認してください。
03 Hermes Agent 一行インストールとヘルスチェック：macOS / Linux 共通
対象ホストのターミナルで実行します（公式 README と同一。リリース後は main ブランチのスクリプトパスを再確認してください）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
ヘッドレスサーバーはブラウザスタックを省略：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -s -- --skip-browser
source ~/.zshrc
hermes doctor
hermes --versionインストーラは典型的に uv の導入、Python 3.11 の取得、Node.js 22、ripgrep と ffmpeg のインストール、~/.hermes/hermes-agent/ へのクローン、hermes の PATH 登録を行います。成功時は installed at ~/.hermes に近いメッセージが出ます。
hermes doctor は Python、Node、ripgrep、ffmpeg、PATH、API Key などを自己診断します。失敗項目は hermes setup の前に直し、Gateway に問題を持ち込まないようにしてください。
Telegram チャネル設定は公式 Messaging ガイドを参照してください。
04 六段で実装：モデル設定、初回対話、Telegram、Gateway 7×24 常駐
- LLM を設定する：
hermes setupでウィザード全体を回すか、hermes modelでプロバイダだけ切り替えます。OpenRouter / Anthropic / OpenAI / Ollama などに対応し、キーは~/.hermes/.envに保存します。 - 初回 CLI 対話：
hermesを実行し、「現在ディレクトリのファイル数を数えて」など検証可能なタスクでツール呼び出しとログを確認します。 - Telegram Bot を作成する：Telegram で
@BotFatherに/newbotを送り Token を控え、@userinfobotで数値 User ID を取得します。 - Gateway を紐付ける：
hermes gateway setupで Telegram を選び Token と許可ユーザー ID を入力するか、TELEGRAM_BOT_TOKENとTELEGRAM_ALLOWED_USERSを手動設定します。 - フォアグラウンドでスモークテスト：
hermes gatewayを前景実行し、スマートフォンから Bot にメッセージを送って応答を確認します。グループでは BotFather で Group Privacy を無効にしてから Bot を再招待してください。 - バックグラウンド常駐：macOS では
hermes gateway installとhermes gateway start（launchd）。Linux ではsudo hermes gateway install --systemと systemd を併用します。月額 Mac ノードでも同じ手順で 7×24 到達が可能です。
hermes setup
hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway statusCALMVPS ベアメタル Mac に載せる場合は、料金ページで M4 のメモリとリージョンを選び、SSH 後にローカルと同じコマンドを実行してください。ホスト変更前は ~/.hermes/ ディレクトリごとアーカイブします。注文は クラウド注文ページから行えます。
05 引用仕様、よくあるエラー、CALMVPS でのまとめ
- インストーラ構成：uv + Python 3.11 + Node.js 22 + ripgrep + ffmpeg（公式 Installation ドキュメント。バージョンはリリースごとに変わるため
hermes --versionで確認）。 - 設定の永続化：中核は
~/.hermes/（.env、skills、memories、Gateway 状態）。移行時はチャット履歴だけでなくディレクトリ全体をバックアップしてください。 - 消費電力（M4 ホスト）：コミュニティとデータセンター実測ではアイドル約 4–6 W、典型的 Agent 負荷で 15–25 W 程度とされます（メーターと Apple 仕様で要検証）。
| 現象 | よくある原因 | 対処 |
|---|---|---|
| hermes: command not found | PATH 未反映 | source ~/.zshrc または新しいターミナル |
| API key not set | LLM 未設定 | hermes model または ~/.hermes/.env を編集 |
| グループで無応答 | Bot プライバシーモード | BotFather で Group Privacy をオフにして Bot を再招待 |
| Missing config after update | 設定 schema 変更 | hermes config check と migrate |
よく蓋を閉じるノート PCでは Gateway の連続性と Skill 複利が弱く、安価な海外 VPSでは macOS ツールチェーンと遅延が課題、Raspberry Piでは IO と長時間ジョブがボトルネックになります。Telegram 7×24、launchd ネイティブ常駐、メモリの迅速な増設が必要な本番では、CALMVPS ベアメタル Mac mini M4 月額が多くの場合に最適解です。SSH ですぐ使え、Apple Silicon を占有し、月単位で柔軟に契約できます。機種は CALMVPS 料金ページ、注文は クラウド注文からどうぞ。