ガイド

Mac miniにHermes Agentをインストールする

Hermes Agentは、1つのスクリプトでApple silicon搭載Macにインストールできます。スクリプトが専用のPythonとツールを用意します。そのあと2つのコマンドで、モデルを選び、メッセージングのゲートウェイをlaunchdのサービスにします。公式の手順、当社のテストインストールでの出力、24時間動かし続ける方法を紹介します。

Hermes Agentとは

Hermes Agentは、Nous ResearchによるMITライセンスのオープンソースのエージェントです。セッションをまたいで記憶を保ち、あなたの作業を学びながら自分でスキルを書きます。ゲートウェイを通じて、Telegram、Discord、WhatsAppなどのチャットアプリとつながります(github.com/NousResearch/hermes-agent、2026年10月)。

ほかのコーディングエージェントのように、ターミナルのチャットとして使えます。あるいは、ゲートウェイを動かしたままにして、スマートフォンからメッセージを送れます。常時稼働のMacで動かしたいと考える人が多いのは、2つ目の使い方のためです。

必要なもの

  • Apple silicon。インストールのドキュメントによると、macOS用のインストーラーはApple silicon専用で、Intel Macには対応していません(2026年10月)。
  • Python 3.11〜3.14、git、curl。インストーラーが専用のPython、Node、ffmpeg、ripgrepを用意するので、まっさらなMacでも問題ありません。
  • モデル。Hermesは、Anthropic、OpenAI、OpenRouter、Nous Portalなど多くのプロバイダーに対応しています。プロバイダーのドキュメントには、APIキー、ブラウザでのサインイン、一部のサブスクリプションプランが挙がっています。Ollamaなど、OpenAI互換のローカルのエンドポイントも使えます。

インストールする

macOS向けにドキュメントに載っているコマンドです。実行後、シェルを再読み込みします。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.zshrc

スクリプトやリモートのシェルから使う場合、インストーラーには質問を飛ばすフラグがあります。オプションのブラウザツールとコンピュータ操作ツールを飛ばすフラグもあります。当社のテストではこれらを使いました。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive --skip-browser --skip-computer-use

2026年10月2日に、GitHubホスト型のmacOS 26マシンで2回実行しました。1回目は約2分、もう1回は6.5分かかり、時間の大半はダウンロードでした。バージョン確認の出力は次のとおりです。

$ hermes --version
Hermes Agent v0.21.5+5635.g5bba024 (2026.9.24) · upstream 5bba024d

何がどこに入ったかを知っておくと役立ちます。インストーラーは、ホームディレクトリのhermesフォルダにコードをクローンしました。その中のtoolsフォルダに、専用のPython 3.14.7、Node、ffmpeg、ripgrepを置きました。hermesコマンドは、ホームディレクトリのローカルのbinフォルダに入りました。また、58個の同梱スキルも追加されました。メモ、リマインダー、iMessage用のものも含まれます。これらは、LinuxマシンではなくMacでHermesを動かす理由になります。

次に、モデルを選んでセットアップウィザードを実行します。

hermes model
hermes setup
hermes doctor

OpenClawから移行する場合は、READMEにOpenClawの設定を取り込むコマンドがあります。

hermes claw migrate

ゲートウェイを24時間動かし続ける

まずチャットアプリを接続します。次に、ゲートウェイをサービスとしてインストールします。macOSでは、これはlaunchdのエージェントです。

hermes gateway setup
hermes gateway install
hermes gateway start
hermes gateway status
tail -f ~/.hermes/logs/gateway.log

チャットアプリをまだ設定していないテストマシンで、installコマンドを実行しました。ユーザー名はrunnerです。statusの確認で、launchdがゲートウェイを動かしていることが分かりました。

$ hermes gateway install
Installing launchd service to: /Users/runner/Library/LaunchAgents/ai.hermes.gateway.plist
✓ Service installed and loaded!
$ hermes gateway status
✓ Service definition matches the current Hermes install
✓ Gateway is supervised by launchd (PID 14390)
  Auto-start at login and auto-restart on crash are available.

サービスのファイルは読み込み時に実行する設定なので、ログインのたびに戻ってきます。ゲートウェイがエラーで終了した場合も再起動します。メッセージングのドキュメントに注意点が1つあります。あとで新しいツールをインストールしたら、installコマンドをもう一度実行してください。そうすれば、サービスが新しいPATHを読み込みます。

ほかのLaunchAgentと同じく、ログインしたユーザーが必要です。自動ログインをオンにし、スリープをオフにします。

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

接続が切れても残るターミナルのセッションが欲しいなら、対話型のエージェントをtmuxの中で動かします。手順はtmuxのガイドにあります。Hermesでも同じように使えます。

セキュリティについて

  • ゲートウェイは、許可するまで全員を拒否します。ユーザーIDの許可リストを設定するか、ペアリングコードで1人ずつ承認します。コードは1時間で期限が切れます。
  • 承認にはmanual、smart、offの3つのモードがあります。offはyoloフラグと同じです。設定を信頼できるようになるまでは、manualのままにしてください。
  • APIキーは、hermesフォルダ内のenvファイルに置き、自分だけが読めるようにします。決してコミットしないでください。
  • さらに隔離したい場合、セキュリティのドキュメントに、Mac本体ではなくDockerコンテナ内でコマンドを実行する方法があります。
# in ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789

# or approve one person by pairing code
hermes pairing approve telegram XKGH5N7P
chmod 600 ~/.hermes/.env

ドキュメントによると、yoloモードでも有効な保護がいくつかあります。固定のブロックリストが、ディスク全体の再帰的な削除のようなコマンドを止めます。ファイル操作のツールは、sshとawsのフォルダへの書き込みを拒否します。

MacRunのMacで動かす

当社のエージェントプランでは、スリープがオフの専用Mac miniを使えます。再起動後は、ログインセッションが自動で戻ります。Claude CodeとCodexはプリインストール済みです。Hermesは入っていません。管理者権限を使って、上のスクリプトでインストールしてください。Hermesでクラウドのモデルを使うなら、標準の16 GBのM6で十分です。

この用途でMacを借りるべきでない人もいます。HermesはLinuxでも動きます。Xcode、メモ、iMessageが必要ないなら、Linuxサーバーのほうが安く済みます。また、MacRunは開発作業のためのサービスです。コーディング、ビルド、リポジトリの雑務に使い、個人の生活アシスタントには使わないでください。

エージェントプランの内容は、エージェント用Macのページでご確認ください。

よくある質問

Hermes AgentはIntel Macで動きますか?

+

いいえ。2026年10月時点のHermes Agentのインストールのドキュメントによると、macOS用のインストーラーはApple siliconにしか対応していません。

macOSでHermes Agentをバックグラウンドで動かすには?

+

hermes gateway installを実行します。ログイン時に起動するlaunchdのエージェントが作られます。管理には、hermes gateway start、stop、statusを使います。

Hermes Agentはローカルモデルを使えますか?

+

はい。プロバイダーのドキュメントによると、OllamaやLM Studioを含む、OpenAI互換のどのエンドポイントでも使えます。hermes modelで選びます。

Hermes AgentはAPIキーをどこに保存しますか?

+

ホームディレクトリのhermesフォルダ内にあるenvファイルです。セキュリティのドキュメントでは、このファイルにchmod 600を設定し、決してコミットしないよう勧めています。

関連ガイド