macOS / Linux ワンライナー · hermes doctor · LLM 設定 · Gateway 7×24 · リモート Mac 検収
こんな状態ではありませんか。2026年6月時点で GitHub スター約17万の Nous Research Hermes Agent を入れたいのに、CLI・LLM・Telegram のどこかで止まっている——PATH が通らない、API Key が未設定、Gateway は online なのにグループで無言。結論：公式 curl | bash → hermes doctor → ~/.hermes/.env で LLM → hermes gateway install で 7×24 常駐。本番は7×24 Mac が要る理由とセットで、Mac mini M4 月額レンタルを検討してください。構成：要件 → インストール → doctor/LLM → Telegram → Skill → エラー表 → プラットフォーム → FAQ。
Hermes Agent は Nous Research が MIT ライセンスで公開する「自己進化型 AI Agent」です。タスクが成功すると実行パスを Skill として ~/.hermes/skills/ に保存し、同種タスクのトークン消費はコミュニティ実測で約 38% 低下（30日運用で Skill 3→19 の例）と報告されています。Gateway が Telegram・Discord・Slack・WhatsApp など20超のチャネルに接続し、MCP Server でツールを拡張できます。
当サイトでよく扱う OpenClaw は IM 連携の実例が豊富です。CrewAI / LangGraph は自分で組み立てるオーケストレーション層。Hermes は CLI・doctor・チャネルアダプタ・記憶ファイル（SESSION → MEMORY.md → USER.md）まで揃った製品です。三層メモリと Mac mini レンタルを読んだ方は、本稿をインストール・検証・常駐化の実務編として使ってください。
2026年6月時点のサポートでは、①インストーラが Python/Node を本当に入れるか、② Gateway が launchd/systemd で再起動後も生きるか、③ Telegram のグループプライバシーで通常メッセージが無視されるか——の三つが大半です。README の貼り付けではなく、実際のチケット順に整理します。公式：hermes-agent.nousresearch.com/docs/getting-started/installation、バージョン確認：github.com/NousResearch/hermes-agent。
前提の過大評価：Python 3.11・Node 22・ripgrep を手動インストールする必要はなく、公式スクリプトが担います。
LLM 未設定：hermes setup や ~/.hermes/.env を飛ばすと CLI は動くが推論が失敗します。
Gateway が前景のみ：SSH を切ると Telegram が死ぬ。hermes gateway install 未実行が典型です。
グループプライバシー：グループでは / コマンドだけ見える状態。BotFather でオフ＋再招待が必要です。
インストーラが OS を検知して依存を補います。下表で「このマシンで回るか」「クラウド API だけかローカルモデルか」を判断してください。
| 項目 | 最低 | 推奨 |
|---|---|---|
| OS | macOS 12+、Ubuntu 20.04+、WSL2 | macOS 14+（Apple Silicon）/ Ubuntu 24.04 LTS |
| Python / Node | スクリプトが 3.11 / Node 18+ を提供 | デフォルト Node 22、sudo 不要 |
| メモリ | 4 GB（Gateway + クラウド API のみ） | 16 GB（Ollama・ブラウザ自動化） |
| ディスク | 約 1.5 GB（Skill キャッシュ含む） | 20 GB+ SSD（ローカル重み） |
| ネットワーク | GitHub raw + LLM API 到達 | Telegram 長接続向け低遅延出口 |
覚えておく三つ：① Python/Node/ripgrep/ffmpeg の手動導入は不要。② GUI のない Linux VPS は --skip-browser。③ Windows ネイティブは Beta——WSL2 + Linux スクリプトが現実的です。
日本の個人開発者が MacBook だけで試す場合、夜間のスリープで Gateway が止まり Skill の複利が切れる点に注意してください。評価期は自宅 Mac より、VNCMac の物理 Mac mini M4 月額の方が Telegram 本番に向きます。電気代・停電・回線品質を自前で背負わず、launchd で常駐を切らさない運用が目的なら、先にリモートノードを借りてから Hermes を入れる順序がトラブルが少ないです。
ターミナルで公式スクリプト（本番前に Nous ドキュメントで URL を再確認）：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
スクリプトの流れ：uv → Python 3.11 → Node.js 22 → ripgrep・ffmpeg → ~/.hermes/hermes-agent/ に clone → グローバル hermes → デフォルト Skill レジストリ。成功時は ✅ Hermes Agent installed at ~/.hermes。
source ~/.zshrc（macOS）または source ~/.bashrc（Linux）で PATH 更新。
ヘッドレス：curl -fsSL .../install.sh | bash -s -- --skip-browser。
hermes doctor でヘルスチェック合格。
hermes setup で LLM（第4節）。
リモート Mac レンタル初回は VNC で画面収録・ユニバーサルアクセスの TCC を許可——SSH だけでは「許可」クリック不可。
Windows：iex (irm .../install.ps1)、配置は %LOCALAPPDATA%\hermes\。ダッシュボードの Unix シェル要件は WSL2。Termux も同じ curl | bash で環境検知します。
VNC ログイン → ターミナルでインストール → hermes doctor をスクショ → hermes setup → 日常運用は SSH。~/.hermes/ に Skill・SQLite・.env。退租前 tar czf hermes-backup.tgz ~/.hermes で次ノードへ移行できます。日本から接続する場合は東京・シンガポールなど近いリージョンを選ぶと Telegram の体感遅延が下がります。
hermes doctor hermes --version hermes setup # 初回はウィザード推奨 # または: hermes model
hermes doctor は本番前のゲートです。venv・CLI シム・設定・ブラウザスタック・チャネル前提を確認します。Telegram トラフィックを向ける前に、CI でスキップしないパイプラインと同じ気持ちで通してください。
| プロバイダ | 特徴 | 設定 |
|---|---|---|
| Nous Portal | サブスク、300+ モデル | hermes setup --portal（OAuth） |
| OpenRouter | 多モデル実験 | ~/.hermes/.env に API Key |
| Anthropic / OpenAI | Claude / GPT 系 | API Key または OAuth |
| Ollama / vLLM | ローカル推論 | Base URL + Key、16 GB+ RAM 推奨 |
明示設定：hermes config set OPENROUTER_API_KEY sk-or-xxxx または ~/.hermes/.env へ追記。対話 hermes で「今日の AI ニュースを要約」などを試し、401 が出ないことを確認。
8 GB Mac で Ollama を回すと Skill 検索と同時に swap が出やすいです。メモリ記事の16 GB 下限 / 24 GB 快適に合わせて RAM を選んでください。
Telegram で @BotFather、/newbot、トークンを安全に保管。
@userinfobot 等で数字の User ID を取得。
hermes gateway setup で Telegram を選びトークンと ID を入力——または TELEGRAM_BOT_TOKEN / TELEGRAM_ALLOWED_USERS を .env に。
前景 hermes gateway でスマホから DM テスト。
本番：hermes gateway install && hermes gateway start。macOS は launchd、Linux は sudo hermes gateway install --system。
グループ：デフォルトはプライバシーモードでスラッシュコマンドのみ。BotFather で Group Privacy をオフ → Bot を一度外す → 再招待。
15分検収：① DM 返信 ② hermes gateway status が running ③ 再起動後も自動起動 ④ ログに 401/429 が連続しない。Linux は journalctl -u hermes-gateway -f、レンタル Mac は VNC でコンソールを hermes でフィルタ。
| コマンド | 用途 |
|---|---|
| hermes | 対話 CLI |
| hermes tools | ツールの有効/無効 |
| hermes gateway status | デーモン状態 |
| hermes update | 最新版へ更新 |
| hermes config check | アップグレード後の設定検証 |
Skill はホストがオンラインのときだけ複利します。成功 Run を ~/.hermes/skills/ に Markdown 化し、次回は安く速く。毎晩 MacBook をスリープさせると、ディスクにファイルがあってもフライホイールは止まります。
~/.hermes/config.yaml の mcp_servers で GitHub 等を追加。トークンは最小権限。ブラウザ系 MCP は macOS が最も揃っており、ヘッドレス Linux は依存欠けがち——POC 後に Gateway を Mac mini へ移すチームが多い理由です。
| 症状 | 原因 | 対処 |
|---|---|---|
| hermes: command not found | PATH 未更新 | source ~/.zshrc または新ターミナル |
| API key not set | LLM 未設定 | hermes model / .env |
| Missing config after update | スキーマ差分 | hermes config migrate |
| ModuleNotFoundError: dotenv | システム Python 使用 | ~/.hermes/.../venv/bin/hermes |
| Telegram グループ無言 | プライバシーモード | BotFather オフ + 再招待 |
| プラットフォーム | 7×24 | Skill 複利 | 向く用途 |
|---|---|---|---|
| 個人 MacBook | 約60%（スリープ） | 中断しやすい | 週末 POC のみ |
| x86 VPS 4GB | 約99.5% | 安定、macOS 専用 Skill なし | Linux のみ運用 |
| Mac mini M4 月額 | データセンター SLA | launchd + UMA | Telegram 本番 |
Mac mini M4 16GB は 2026年6月時点で国内約12〜15万円帯（要確認）。24ヶ月償却で月5千円前後＋電気・回線・停電リスクは自前。VNCMac 月額は CapEx を OpEx にし、Hermes が本当に1日2時間削れるか30日で検証できます。Gateway 典型約4.2GB＋ブラウザ CDP＋SQLite WAL を UMA で載せると、4GB x86 VPS の swap より Telegram 長接続が安定しやすいです。
社内スライド用： GitHub スター約17万（2026年6月）、Skill ベンチで反復タスク約38%トークン削減、doctor 12項目超、Telegram 検収15分。
不要です。公式 install.sh が uv で Python 3.11、Node 22、ripgrep、ffmpeg を入れます。
インストールと Gateway の多くは SSH で可。初回の macOS プライバシー許可と一部 OAuthは VNC が安全——OpenClaw リモート Mac 記事と同じパターンです。
入口は公式 install のまま。更新は hermes update、設定ずれは hermes config check && hermes config migrate。
三層メモリ記事は「なぜ 7×24」。本稿は「どう入れるか」。先に装通してからホスト選定が順序として自然です。
Hermes のインストール自体は単純です：公式スクリプト、hermes doctor、.env、Gateway サービス。デモと本番の差は稼働時間——Skill・Telegram・記憶ファイルはプロセスとディスクが動いている間だけ価値が乗ります。
自宅 Wi‑Fi の瞬断や $5 VPS のピーク制限は、「使うほど賢い」を「毎週新入り」に戻します。年間負荷が測れたら購入、まだなら物理 M4 を月額で SSH 導入・VNC 検収・~/.hermes/ を tarball 移行が合理的です。
入れただけでは製品にならない。動かし続けることが価値です。 Mac mini M4 月額プランで Gateway と Skill に休まない macOS を用意してください。