Hermes Agent Mac 導入：インストール・ゲートウェイ（2026）
Hermes Agent は Nous Research の OSS 自己改善型 AI エージェント（github.com/NousResearch/hermes-agent、MIT）です。単発チャットではなく、学習ループ（メモリ、スキル、FTS5 検索、cron、Telegram 等のゲートウェイ）を回します。本ガイドは Mac（MacBook またはヘッドレス Mac mini）でのセットアップ手順です。クラウド必須ではありません。
Mac で Hermes を動かす理由
- 公式インストーラ —
install.shが macOS をサポート。 - Apple Silicon —
uvで Python 3.11、Node、ffmpeg/ripgrep。 - ゲートウェイ —
hermes gatewayを常駐させ Telegram から操作；スリープすると切断されます。 - OpenClaw — 既に OpenClaw on Mac を使っている場合は
hermes claw migrateで移行。
プロセス層は Obra Superpowers、実行層は Hermes — 併用が一般的です。
東京リージョンの常時 Mac は、SSH バックエンドで遠隔実行する場合にのみ帯域・レイテンシの選択肢として有用です。
macOS アーキテクチャ
| 要素 | パス/コマンド | 役割 |
|---|---|---|
| CLI | ~/.local/bin/hermes | TUI・スラッシュコマンド |
| 設定 | ~/.hermes/ | キー・ツール・ゲートウェイ |
| ゲートウェイ | hermes gateway start | 各種メッセージ連携 |
| エージェント | uv の Python 3.11 | ツール・サブエージェント |
公式ドキュメント、Mac mini 仕様（RAM 計画用）。
Mac セットアップ 8 ステップ
- 前提 — macOS 13+、Docker 併用時は 16 GB RAM、
xcode-select --install。 - インストール — 公式
curl … install.sh | bash、source ~/.zshrc。 - 検証 —
hermes doctor、hermes --version。 - セットアップ —
hermes setup（--portal可）。 - モデル/ツール —
hermes model、hermes tools。 - TUI テスト —
hermesで/usage等を確認。 - ゲートウェイ（任意） —
hermes gateway setup/start。 - OpenClaw 移行（任意） —
hermes claw migrate。
ターミナルバックエンド
| Backend | 用途 | Mac の役割 |
|---|---|---|
local | 日常開発 | ノート上で実行 |
docker | サンドボックス | Docker Desktop |
ssh | ゲートウェイと実行の分離 | Mac mini / VPS を遠隔操作 |
modal/daytona | アイドルコスト削減 | 最小常駐 |
トラブルシューティング
command not found
~/.local/bin を PATH に追加。
Python/uv エラー
uv を入れて hermes update。
ゲートウェイ無応答
トークン・許可リスト・ログを確認し再起動。
Docker バックエンド利用時は Desktop を最新に保ち、初回ツール呼び出しの遅延を防ぎます。ゲートウェイと cron は同一 ~/.hermes/ にまとめると運用が楽です。
TUI の /usage でトークンを記録してからブラウザツールを有効化すると、Telegram 経由の課金サプライズを減らせます。
ゲートウェイ用に専用 macOS ユーザーを作り、iCloud デスクトップ同期を無効にすると ~/.hermes/ の FTS5 が安全です。8 ステップ完了後は Telegram で 1 通テストし、問題なければ Discord 等を追加してください。
東京リージョンの常時 Mac に SSH バックエンドを向けると、ノートがスリープ中も応答を維持でき、API キーを分散させません。
複数エージェントを同居させる場合は hermes 専用の API キーとログディレクトリを分離し、OpenClaw など他ツールの環境変数と衝突しないようにしてください。
FAQ
hermes claw migrate で橋渡しできます。hermes gateway が必要なときだけ、スリープしない Mac mini や小さな VPS を検討します。hermes update のあと hermes doctor で確認してください。