専用Mac miniでHermes Agentを24時間365日稼働させる方法

1. なぜMac miniでHermes Agentを実行するのか？

Hermes Agentは稼働し続けることを前提に設計されています。永続的なメモリを保持し、内蔵cronでスケジュールされたタスクを実行し、会話と会話の間に自らのスキルを改善します。スリープするノートPCや再起動される共有VPSでは、そのどれも機能しません。MyRemoteMacの専用Mac miniなら、Apple Silicon（HermesのTier 1）、SSHとVNCによる完全なroot権限、1 Gbps込み、定額の月額料金が手に入ります、さらに同じマシン上でローカルのOllamaモデルを実行し、推論コストをトークン単位でゼロにすることもできます。

2. 前提条件

公式インストーラーは意図的に軽量に作られています。Homebrew、Python、Node.jsは不要です。Hermesは固定バージョンのuvとPython 3.14を自前でダウンロードし、Node.jsはWhatsAppブリッジを有効にする場合にのみ後から必要になります。実際に必要なものは以下のとおりです。

• MyRemoteMac の専用Mac mini、M4は月額$85から、M6は月額$149から。どちらもApple Siliconで、HermesのTier 1に該当します。
• Mac miniへのSSHアクセス（MyRemoteMacのサブスクリプションに付属）
• Mac上のgitとcurl（加えてtarとSHA-256ツール。いずれもmacOSにプリインストール済みで、gitはXcode Command Line Tools経由）。インストーラーが致命的エラーで停止するのは、gitまたはcurlが見つからない場合のみです。
• LLMプロバイダー：APIキー（Anthropic、OpenRouter、OpenAIなど25以上）、Nous Portalのサブスクリプション、またはローカルのOllamaモデル。モデルは最低64,000トークンのコンテキストに対応し、ツール呼び出しをサポートしている必要があります。
• Telegram、Discord、またはWhatsAppのメッセージングアカウント（最も手早く設定できるのはTelegramです）

3. ステップ1：SSHで接続してインストーラーを実行する

MyRemoteMacダッシュボードの認証情報を使ってMac miniにSSH接続します。インストーラーに必要なのはgitとcurl（加えてtarとSHA-256ツール。いずれもmacOSにプリインストール済み）だけで、あとはすべて自動で行われます。ソースを ~/.hermes/hermes-agent にクローンし、固定バージョンでSHA-256検証済みのuvをダウンロードし、Python 3.14を用意し、依存関係をインストールし、~/.hermes/config.yaml と ~/.hermes/.env（chmod 600）を作成して、対話式セットアップを起動します。

SSHで接続して要件を確認する

# Connect to your Mac mini
ssh admin@your-server-ip

# Confirm Apple Silicon (Tier 1 platform for Hermes Agent)
uname -m
# arm64

# The installer requires only git and curl: both ship with macOS
git --version && curl --version

公式ワンライナーインストーラーを実行する

これは公式READMEとインストールページに掲載されているものと同じコマンドです。Homebrewは使用しないでください。brew install hermes-agent は公式ドキュメントでサポート外の方法として記載されています。SSH経由でインストールをスクリプト化する場合は、--non-interactive（エイリアス --skip-setup）を追加し、後で自分でウィザードを実行してください。

# Official one-line installer (Linux / macOS / WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# What it does:
# - clones the source into ~/.hermes/hermes-agent
# - downloads a pinned, sha256-verified uv and provisions Python 3.14
# - creates ~/.hermes/config.yaml and ~/.hermes/.env (chmod 600)
# - launches the interactive setup wizard

# Scripting over SSH? Skip the wizard and run it later with `hermes model`:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive

シェルを再読み込みして確認する

インストーラーは ~/.zshrc と ~/.zprofile のPATHに ~/.local/bin を追加します。シェルを再読み込み（または新しいSSHセッションを開始）してから、内蔵の診断コマンドを実行します。

# Reload the shell so ~/.local/bin/hermes is on PATH
source ~/.zshrc    # or open a new SSH session

# Verify the install
hermes --version

# Built-in diagnostics (add --fix to attempt automatic repairs)
hermes doctor

4. ステップ2：モデルプロバイダーを構成する（APIまたはローカルOllama）

Hermesはシークレットを ~/.hermes/.env に、それ以外のすべてを ~/.hermes/config.yaml に保持し、モデルを選ぶ公式な方法を3つ用意しています。どれを選んでも、モデルには最低64,000トークンのコンテキストが必要です。なお、Nous自身のHermes 4チャットモデルはエージェントループに適したものではありません、Nous Portalのドキュメントは代わりにフロンティアのツール呼び出し対応モデルを推奨しています。

オプションAまたはB：対話式ウィザードまたはNous Portal

ウィザードはプロバイダー、APIキー、OAuthログインを順に案内します。Nous Portalは、1回のOAuthログインでエージェントに300以上のモデルへのアクセスを与えるサブスクリプションです（料金はドキュメントではなくNous Portalのサイトに掲載されています）。

# Option A: interactive wizard (providers, API keys, OAuth logins)
hermes model

# Option B: Nous Portal subscription via OAuth (300+ models)
hermes setup --portal

オプションC：キーとモデルを非対話式で設定する

ANTHROPIC_API_KEY、OPENROUTER_API_KEY、OPENAI_API_KEY のようなUPPER_SNAKE形式のキーは .env に、ドット区切りまたは小文字のキーは config.yaml に振り分けられます。以下のモデルIDは公式クイックスタートで使われている例です、64k以上のコンテキストとツール呼び出しに対応した、お使いのプロバイダーの現行モデルを選んでください。

# Option C: non-interactive, UPPER_SNAKE keys go to ~/.hermes/.env
hermes config set ANTHROPIC_API_KEY sk-ant-YOUR_API_KEY_HERE

# Dotted / lowercase keys go to ~/.hermes/config.yaml
# (model id below is the example from the official quickstart)
hermes config set model anthropic/claude-opus-4.6

# Review the active configuration
hermes config show

任意：Ollamaで無料のローカルモデルを使う

Mac mini自体でモデルをホストすることもできます。公式のHermes Ollamaガイドは gemma4:31b（ディスク約20 GB、RAM 24 GB以上、ツール呼び出し対応）を使用しています、MyRemoteMacでは24 GB構成（Mac mini M4 24 GBが月額$129、M6 24 GBが月額$219）がこの文書化された最低要件を満たしますが、macOSと64kコンテキストウィンドウのための余裕はわずかです、24 GBのMac miniで余裕を持たせたい場合は、代わりにより小さなツール呼び出し対応モデルを選んでください。Ollamaのデフォルトのコンテキストウィンドウは、Hermesが要求する64kを大きく下回るため、ドキュメントでは num_ctx を引き上げるModelfileを作成する手順になっています。まず ollama.com/download からmacOS版Ollamaをインストールしてください。Ollamaは ollama launch hermes によるガイド付きの手順もドキュメント化しています。

# 1. Install Ollama for macOS from https://ollama.com/download

# 2. Pull a tool-calling model (~20 GB on disk, 24+ GB RAM)
ollama pull gemma4:31b

# 3. Hermes needs 64k context: build a Modelfile that raises num_ctx
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# 4. Point Hermes at the local OpenAI-compatible endpoint
hermes setup
# Choose "Custom Endpoint": base URL http://localhost:11434/v1, model gemma4-64k

# Alternative guided path documented by Ollama:
ollama launch hermes

他に何かを追加する前にスモークテストを行う

クイックスタートには明記されています：Hermesが通常のチャットを完了できない場合、ゲートウェイ、cron、スキルはまだ追加しないでください。まず1回、問題なく会話できることを確認します。

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. ステップ3：メッセージングチャネルを接続する

1つのHermesゲートウェイプロセスがすべてのプラットフォームに対応します。公式ドキュメントによれば、Telegram、Discord、Slack、WhatsApp、Signal、Google Chat、Microsoft Teams、Matrix、Mattermost、iMessageブリッジを含む20以上のプラットフォームを1つのゲートウェイで扱えます。以下は、専用のドキュメントページに照らして当社が検証した3つです。ゲートウェイはデフォルトで拒否（deny-by-default）です、あなたのユーザーIDを許可リストに登録するまで、ボットは誰にも応答しません。

Telegram（最初のチャネルとして推奨）

@BotFather でボットを作成し（/newbot でトークンが得られます）、@userinfobot で数値のユーザーIDを取得します、Telegramの許可リストは@ユーザー名ではなく数値IDを使います。次にゲートウェイウィザードを実行すると、値が ~/.hermes/.env に書き込まれます。デフォルトはロングポーリングなので、受信ポートやファイアウォールルールは不要です。

# 1. In Telegram, open @BotFather, send /newbot and copy the token
# 2. Open @userinfobot to get your numeric user ID

# 3. Run the gateway wizard (writes the values to ~/.hermes/.env)
hermes gateway setup

# Equivalent manual entries in ~/.hermes/.env:
# TELEGRAM_BOT_TOKEN=123456789:ABC...
# TELEGRAM_ALLOWED_USERS=123456789
# Optional: chat that receives scheduled-task results (or send /sethome in a chat)
# TELEGRAM_HOME_CHANNEL=123456789

Discord（任意）

Discord Developer Portalでアプリケーションを作成し、ボットトークンをコピーして、Privileged Gateway Intentsの下でMessage Content IntentとServer Members Intentの両方を有効にします、Message Content Intentがないと、ボットはテキストが空のイベントを受け取ります。権限整数 274878286912 でボットを招待し、あなたのユーザーIDを許可リストに登録します。

# In the Discord Developer Portal (https://discord.com/developers/applications):
# 1. New Application > Bot > copy the Bot Token
# 2. Privileged Gateway Intents: enable Message Content Intent + Server Members Intent
# 3. Invite the bot with permission integer 274878286912

hermes gateway setup   # choose Discord

# Equivalent manual entries in ~/.hermes/.env:
# DISCORD_BOT_TOKEN=...
# DISCORD_ALLOWED_USERS=284102345871466496
# DISCORD_REQUIRE_MENTION=true   (default)

WhatsApp（任意）

WhatsAppは非公式ブリッジ（Baileys）を使用し、Node.js v18以上と、QRコードでペアリングする専用の電話番号が必要です。公式ドキュメントは、アカウント制限のわずかなリスクがあること、そしてセッションディレクトリがアカウントへの完全なアクセスを与えることを警告しています、決して共有しないでください。

# Requires Node.js v18+ on the Mac mini (only needed for WhatsApp)
node --version

# Pair a dedicated phone number via QR code
hermes whatsapp

# ~/.hermes/.env:
# WHATSAPP_ENABLED=true
# WHATSAPP_MODE=bot
# WHATSAPP_ALLOWED_USERS=15551234567   (country code, no +)

# Session is stored in ~/.hermes/platforms/whatsapp/session: never share it
# Meta Business Cloud API alternative: hermes whatsapp-cloud

フォアグラウンドでゲートウェイをテストする

SSHセッションでゲートウェイを起動し、ボットにメッセージを送って返信があることを確認したら、Ctrl-Cを押します。hermes gateway status でサービスの状態が表示されます。ボットにメッセージを送ってエンドツーエンドで確認してください。

# Run the gateway in the foreground
hermes gateway

# Send your bot a message from Telegram / Discord: it should reply.
# Press Ctrl-C to stop (the persistent service is set up in Step 4)

6. ステップ4：launchdで24時間365日稼働、更新、移行

hermes gateway install は、ユーザーレベルのLaunchAgentを ~/Library/LaunchAgents/ai.hermes.gateway.plist（ラベル ai.hermes.gateway）に登録し、ゲートウェイがログイン時に起動（RunAtLoad）してmacOSに監視されるようにします。公式FAQにある重要な点：plistはインストール時のシェルの完全なPATHをスナップショットします。Node.js、ffmpeg、Ollamaはこのステップの前にインストールするか、あるいは後で hermes gateway install を再実行してください。

サービスをインストールして起動する

# Register the launchd LaunchAgent
# (writes ~/Library/LaunchAgents/ai.hermes.gateway.plist with your current PATH)
hermes gateway install

# Start it now
hermes gateway start

# Service status
hermes gateway status

# Live logs
tail -f ~/.hermes/logs/gateway.log

# Other commands: hermes gateway stop | restart | list
# Foreground run (no launchd): hermes gateway run

launchdが管理していることを確認する（再起動テストを1回行う）

hermes gateway status でサービスの状態が表示されます。ボットにメッセージを送ってエンドツーエンドで確認し、launchctlに直接問い合わせてlaunchdが実際にプロセスを所有していることを確認します。ユーザーレベルのLaunchAgentはユーザーセッションが存在して初めて読み込まれるため、再起動テストの前に管理者ユーザーの自動ログインが有効になっていることを確認してください（システム設定 > ユーザとグループ > 自動ログイン）、そうしないと、ヘッドレスのMac miniではゲートウェイが復帰しません。その後、1回再起動して（sudo reboot）、再びボットにメッセージを送ります。

# Confirm launchd owns the gateway (state, PID, last exit code)
launchctl print gui/$(id -u)/ai.hermes.gateway

# Check the PATH that was captured in the plist
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# LaunchAgents load at login: enable Automatic login first
# (System Settings > Users & Groups > Automatic login)
# Reboot-test once, then message the bot again
sudo reboot

Hermes Agentを更新する

hermes update は最新のコードを ~/.hermes/hermes-agent に取り込み、依存関係を再同期し、ドレインファーストでゲートウェイを再起動します。新しいターンを受け付けず、進行中のチャット、cron、APIの処理が終わるのを（デフォルトで最大30分）待ってから再起動します。出力は ~/.hermes/logs/update.log にも記録されます。--check でプレビュー、--backup で事前に ~/.hermes のスナップショットを取得、--no-gateway-restart で再起動を延期できます。

# Preview what would change
hermes update --check

# Update (snapshot ~/.hermes first, drain-first gateway restart)
hermes update --backup

# Adopt any new configuration options
hermes config check && hermes config migrate

# Confirm the running version
hermes --version

任意：同じMac上のOpenClawから移行する

当社のもう1つのガイドでOpenClawをすでに実行していますか？公式の移行コマンドは、~/.openclaw からSOUL.md、メモリ、ユーザープロファイル（~/.hermes/memories/ へ）、スキル（~/.hermes/skills/openclaw-imports/ へ）をインポートし、その前に ~/.hermes/backups/ に pre-migration-*.zip の復元ポイントを書き込みます。シークレットはデフォルトではインポートされません。APIキーとメッセージングトークン（Telegram、Discord、Slack、Signal、Matrix、Mattermost）を引き継ぐには、--migrate-secrets を明示的に追加してください。WhatsAppはトークン移行されず（許可リストのみマッピングされます）、hermes whatsapp で再ペアリングが必要です。必ずドライランから始めてください。

# Preview the migration from ~/.openclaw
hermes claw migrate --dry-run

# Migrate (writes a pre-migration-*.zip restore point in ~/.hermes/backups/ first)
# --migrate-secrets is required to carry over API keys and messaging tokens
hermes claw migrate --migrate-secrets

# Later, rename leftover OpenClaw directories to .pre-migration/
hermes claw cleanup

7. よくある問題のトラブルシューティング

# Reload the shell profile the installer edited
source ~/.zshrc

# Or call the binary directly
~/.local/bin/hermes --version

# Still broken? Run the diagnostics
~/.local/bin/hermes doctor --fix

# Allowlist resolution order (official security guide):
# per-platform allow-all -> DM-pairing list -> TELEGRAM_ALLOWED_USERS / DISCORD_ALLOWED_USERS
# -> GATEWAY_ALLOWED_USERS -> GATEWAY_ALLOW_ALL_USERS=true -> deny

# Check what is stored (Telegram IDs are numeric, from @userinfobot)
grep TELEGRAM_ALLOWED_USERS ~/.hermes/.env

# Fix it, then watch the gateway in the foreground while you message the bot
hermes config set TELEGRAM_ALLOWED_USERS 123456789
hermes gateway

# Discord only: confirm Message Content Intent is enabled in the Developer Portal

# See the PATH launchd is using
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# Re-capture your current shell PATH and reload the service
hermes gateway install
hermes gateway start

# Check the logs
tail -50 ~/.hermes/logs/gateway.log

# Rebuild the model with a 64k context window
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# Make sure Hermes targets the 64k variant on the local endpoint
hermes setup   # Custom Endpoint: http://localhost:11434/v1, model gemma4-64k

# Note: the model must also support tool calling (gemma4:31b does, per the official guide)

# Is the LaunchAgent registered and running?
launchctl print gui/$(id -u)/ai.hermes.gateway

# Not listed? Re-register and start it (and check Automatic login is on)
hermes gateway install
hermes gateway start
hermes gateway status

# Then reboot-test again
sudo reboot

8. クラウドVPSとのコスト比較

Hermes Agent自体は無料（MIT）です。費用がかかるのはホストとLLMの利用分です。以下のホスト比較は、当社のOpenClawガイドのクラウドVPSの数値を再利用しています。LLM APIの利用料はどちらの列でもプロバイダーから別途請求され、ホストに関係なく同額です、ただし、Mac mini上でローカルのOllamaモデルを実行する場合は、推論コストは$0になります。

前提：VPSの価格は、GPU対応のAIプランインスタンスについて当社のガイド全体で使用している価格帯と同じで、特定のプロバイダーの見積もりではありません。MyRemoteMacの価格は現在の月額料金（USD、1 Gbps込み）です。Nous Portalのサブスクリプション料金はHermesのドキュメントで公開されていないため、含めていません。

9. Hermes Agent vs. OpenClaw

どちらもオープンソース（MIT）で、セルフホスト型、常時稼働のパーソナルAIエージェントであり、メッセージングアプリから操作します。どちらもワンライナーのcurlコマンドでインストールし、長時間稼働するゲートウェイを実行し、それぞれ独自のlaunchd LaunchAgent（ai.hermes.gateway と ai.openclaw.gateway）を登録します。違いはスタックと売りにあります。OpenClawはNode.js（26.1以上、またはHomebrew経由で24.16以上）上のTypeScriptで、npmでインストールし、独自の openclaw gateway install サービスコマンドを持ちます。Hermesは固定バージョンのuvでブートストラップされるPythonで、完全に ~/.hermes 内に収まり、必要なのはgitとcurlだけ（Node.jsはWhatsAppブリッジにのみ必要）で、hermes gateway install を使います。Hermesの売りは自己改善です：エージェントが作成するスキル、永続的なメモリとSOUL.md、内蔵cron、そして7つのターミナルバックエンド（ローカル、Docker、SSH、Modal、Daytona、Vercel Sandbox、Singularity）。OpenClawの売りは幅広さとより大きなコミュニティです、2026年9月28日時点で、GitHubのスター数はOpenClawが約39.1万、Hermesが約25万でした。

すでにOpenClawを実行しているなら、移行は正式にサポートされています：hermes claw migrate（ステップ4を参照）は、まず ~/.hermes/backups/ に pre-migration-*.zip の復元ポイントを書き込む前方移行です。ゼロから始めるなら、当社のMac mini向けOpenClawガイドも読んで、好みのワークフローのハーネスを選んでください、Mac mini、launchdサービス、ローカルOllamaのオプションはどちらでも同じです。

10. FAQ

11. 出典と参考資料

本ガイドのすべてのコマンドと要件は、2026年9月28日に公式のHermes Agentドキュメントとリポジトリ（最新リリース v2026.9.24）に照らして確認しました。Hermesは日付タグ付きのリリースを頻繁に公開しているため、現在のフラグ一覧は以下のページで確認してください。

• Hermes Agent GitHubリポジトリ（NousResearch/hermes-agent）
• 公式インストールガイド
• クイックスタート（プロバイダー、64kコンテキスト要件、スモークテスト）
• プラットフォームサポート（Tier 1 macOS Apple Silicon、サポート外の方法）
• Hermes Agentの更新
• 設定リファレンス（config.yaml、.env、優先順位）
• セキュリティガイド（許可リスト、承認、Dockerバックエンド）
• メッセージング概要（プラットフォーム一覧、gateway install/start/stop）
• Telegramのセットアップ
• Discordのセットアップ
• WhatsAppのセットアップ
• CLIコマンドリファレンス
• FAQ（macOS launchdのPATH、gateway.log）
• ローカルOllamaセットアップガイド（gemma4:31b、num_ctx 64000）
• OpenClawからの移行
• Nous Portal連携
• Ollama連携ページ（ollama launch hermes）

関連ガイド