Hermes Agent macOS セットアップ：インストール、ゲートウェイ、launchd（2026）

Hermes Agent は Nous Research による MIT ライセンスの Agent で、自己改善ループを備えます。経験から Skill を作成し、定期的な nudge でメモリを永続化し、FTS5 で過去セッションを検索し、Honcho でユーザーコンテキストをモデル化します。macOS ではネイティブ CLI としてインストールされ、オプションのメッセージング gateway—Telegram、Discord、Slack、WhatsApp、Signal、Email—を単一の hermes gateway プロセスから利用できます。

本ガイドでは Apple Silicon または Intel 上の macOS セットアップ—インストール、初回構成、gateway 接続、launchd による gateway の常時稼働—を順を追って説明します。macOS 15+ で、ご自身が管理するマシン（MacBook、Mac mini、Mac Studio、または SSH 接続するリモート Mac）を想定しています。クラウドで Agent を運用している場合は、ヘッドレスホスト向けの別途 Hermes Mac mini M4 チュートリアル を参照してください。以下のコマンドはどの Mac でも同じです。

インストール前に必要なもの

インストーラは不足時に uv、Python 3.11、Node.js、ripgrep、ffmpeg を取得します。完了後 hermes doctor で確認してください。

macOS 上の Hermes の構成

インストール後、状態は ~/.hermes/ に保存されます：

~/.hermes/
├── config.toml          # プロバイダ、ツール、ターミナルバックエンド、ゲートウェイ設定
├── skills/              # ユーザー作成および自動作成 Skill
│   └── openclaw-imports/   # hermes claw migrate 後
├── memory/              # キュレーション済みメモリファイル
└── logs/                # ゲートウェイと CLI ログ（パスは上流ドキュメント参照）

hermes バイナリは ~/.local/bin/hermes へシンボリックリンクされます。日常使用で重要な 3 つのインターフェース：

1. CLI（hermes） — 対話型 TUI。スラッシュコマンド（/model、/skills、/compress、/new）。
2. Gateway（hermes gateway） — メッセージングプラットフォームを同一 Agent ループにブリッジ。
3. ターミナル backend — shell/ファイルツールの実行先：local（macOS デフォルト）、Docker、SSH、Singularity、Modal、Daytona。

モデルルーティングはプロバイダ非依存：hermes model で Nous Portal、OpenRouter（200+ モデル）、OpenAI、Anthropic、BYO エンドポイントをコード変更なしで切り替え。

macOS セットアップ手順

1. Hermes をインストール

シェルにパイプする前に、組織内でインストールスクリプトを確認してください。上流のワンライナー：

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

hermes doctor は uv、Python 3.11、Node、ripgrep、ffmpeg の チェックが通るはずです。フラグ付き依存関係を修正して再実行してください。

2. 初回セットアップを実行

フルウィザードまたは Portal OAuth：

hermes setup              # 対話式：プロバイダ、ツール、ゲートウェイのヒント
# または
hermes setup --portal     # Nous Portal OAuth + Tool Gateway（検索、画像、ブラウザ、TTS）

ウィザードは ~/.openclaw を検出し移行を提案します—新規インストールならスキップしてください。

3. モデルとツールを選択

hermes model              # provider:model を選択（例 openrouter:anthropic/claude-sonnet-4）
hermes tools              # ツールセットの有効/無効（上流 40+ ツール）
hermes config set KEY VALUE   # 細かい上書き

短い CLI セッションで確認：

hermes
# TUI 内：質問、/usage、Ctrl+D または /quit で終了

4. OpenClaw から移行（任意）

既存の OpenClaw ワークスペースがある場合：

hermes claw migrate --dry-run
hermes claw migrate

通常、SOUL.md ペルソナ、MEMORY.md / USER.md エントリ、ユーザー Skill、コマンド許可リスト、メッセージ設定、許可済み API キーを ~/.hermes/ にインポートします。プリセットは hermes claw migrate --help を参照。

5. メッセージング gateway を構成

hermes gateway setup      # プラットフォーム token、DM ペアリング、許可ユーザー
hermes gateway start      # フォアグラウンドテスト

Telegram（または利用プラットフォーム）からテスト：/new を送信し、続けてプロンプト。ボットがオンラインだが無言の場合はメッセージ側で /status—多くはペアリングまたは許可リストの問題（上流 Security ドキュメント）。

6. launchd で gateway を永続化

フォアグラウンドの hermes gateway start はログアウトで停止します。常時電源オンの Mac（デスク Mac mini、スタジオマシン、リモートホスト）ではユーザー LaunchAgent を作成。plist の骨格例—which hermes の後にパスを調整：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>com.hermes.gateway</string>
  <key>ProgramArguments</key>
  <array>
    <string>/Users/YOU/.local/bin/hermes</string>
    <string>gateway</string>
    <string>start</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>KeepAlive</key><true/>
  <key>StandardOutPath</key><string>/Users/YOU/.hermes/logs/gateway.stdout.log</string>
  <key>StandardErrorPath</key><string>/Users/YOU/.hermes/logs/gateway.stderr.log</string>
</dict>
</plist>

読み込み：

mkdir -p ~/.hermes/logs
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hermes.gateway.plist
launchctl kickstart -k gui/$(id -u)/com.hermes.gateway

Telegram/Discord トークンは plist の EnvironmentVariables 辞書または起動時に参照する env ファイルに保存—SSH セッションの export のみにしないでください。

7. cron 式自動化を有効化（任意）

Hermes にはメッセージングプラットフォームへ配信する組み込み cron スケジューラがあります。CLI または構成で自然言語のジョブを定義（上流 cron ドキュメント参照）。macOS では cron ジョブに gateway（または CLI）プロセスの常時稼働が必要—スリープしない Mac で launchd を使うもう一つの理由です。

8. ~/.hermes/ をバックアップ

tar -czf hermes-backup-$(date +%Y%m%d).tar.gz -C ~ .hermes

Skill とメモリはチャットログより再生成が困難です。大きなアップグレード前にスナップショット：

hermes update
hermes doctor

トラブルシューティング

hermes doctor が Python または uv で失敗

症状：Doctor が uv 不足または Python バージョン不一致を報告。

対処：インストールスクリプトを再実行。Hermes は uv 経由で Python 3.11 を想定。macOS で Homebrew なら brew install ripgrep ffmpeg node も可。その後 hermes doctor を再実行。

gateway は起動するがボットが応答しない

症状：hermes gateway start のログは running。DM は応答なくチャットにエラーなし。

対処：hermes gateway setup で DM ペアリング と許可リストを完了。トークン変更後は gateway を再起動。launchd 利用時は env が plist に残ったか確認—launchctl print gui/$(id -u)/com.hermes.gateway で環境を表示。

CLI ツールが権限エラー

症状：ファイルまたは shell ツールがワークスペース外の macOS パスでエラー。

対処：構成のコマンド承認設定を確認（上流 Security）。フルディスクパスでは macOS TCC がファイル/フォルダアクセスを要求することがあります—local backend が動くマシンで許可してください。

常時稼働 Mac を使うタイミング

スリープする MacBook は gateway 配信と cron を一時停止します。Telegram で会話し Agent が別ホストで動くチームは、小型の常時稼働 Mac—デスク Mac mini やホスト型 macOS—を用意し、launchd で hermes gateway を管理することが多いです。本ガイドの手順は変わりません。スリープ方針とネットワーク到達性のみが異なります。SSH backend ワークフロー（ノート PC で CLI、リモート Mac でツール）では、上流 Tools ドキュメントに従い config.toml でターミナル backend をそのホストに向けます。

インストール後は Hermes サブエージェント委任ガイド で delegate_task による3並列ワーカーを試せます。

ゲートウェイ導入後は Hermes マルチデバイス Gateway ガイド を参照。

FAQ

Hermes は OpenClaw や OpenHuman を置き換えますか？

いいえ—設計が異なります。Hermes は Skill + メモリ nudge + 組み込み cron を重視；OpenClaw は gateway 優先の自動化；OpenHuman は OAuth 自動取得付きデスクトップメモリ。hermes claw migrate で OpenClaw データを Hermes に移行できます。比較ランブックは Hermes Mac mini M4 チュートリアル と OpenClaw macOS インストールガイド にあります。

Nous Portal は必須ですか？

いいえ。Portal（hermes setup --portal）は 1 回の OAuth でモデルと Tool Gateway をまとめます。OpenRouter、OpenAI、Anthropic キーを直接指定し、ツールを個別に有効化できます。

macOS では設定はどこに保存されますか？

主ツリー：~/.hermes/ に config.toml、Skill、メモリ、ログ。hermes バイナリは ~/.local/bin/hermes。盲目編集せず hermes config サブコマンドを使用—ウィザード値はドキュメント化されたキーに対応。

Apple Silicon Mac mini で Hermes は動きますか？

はい—インストールスクリプトは Apple Silicon 上の macOS をサポート。gateway と local backend はネイティブ実行。uv がインストールする Python スタックに Rosetta は不要。

Hermes を更新するには？

hermes update
hermes doctor

更新後、launchd 管理の gateway を再起動：launchctl kickstart -k gui/$(id -u)/com.hermes.gateway。

Related reading

• GPT-5.6 予測：Codex オープンソースで Agent 開発効率を上げる