OpenClaw を Mac mini にインストール・デプロイする完全ガイド 2026:ゼロから本番環境まで
OpenClaw はデーモンプロセスとして継続稼働する AI コーディングエージェントです——質問に答えるだけでなく、コードの記述、テストの実行、ファイル管理、外部 API 呼び出しなど多段階のワークフローを自律的に実行します。Finder なしで SSH のみのレンタル mini では、インストーラを流す前に SSH 初回ブートチェックリスト(2026-05-13) でディスク余裕・PATH 整合・plist のスモークを済ませると launchd 起因の後戻りを防げます。Mac mini M4 は最適なホストマシンです:24時間稼働、macOS をネイティブ実行、Apple Silicon の高パフォーマンス、そしてデスクトップを常時電源オンにするコストより大幅に安価。本記事では、ProxyMac クラウド Mac mini ノードへの OpenClaw のインストール、設定、本番デプロイの完全手順を解説します。
OpenClaw とは何か、なぜ専用 Mac が必要なのか
OpenClaw は自律的な AI エージェントフレームワークです——Claude や GPT が駆動する、実際の macOS 環境で複雑なタスクを実行するアシスタントと考えてください。ブラウザベースの AI ツールとは異なり、OpenClaw の特徴は:
- ローカルデーモンプロセスとして実行され、セッション間で永続化、ターミナル切断に影響されない
- ネイティブファイルシステムアクセス——サンドボックスの制限なしにファイルを読み書き実行
- 並行タスク実行のサポート——同一マシン上で複数のエージェントが同時稼働
- AppleScript 経由のスクリーンショット、クリップボードアクセス、GUI 自動化など macOS システム API との統合
デーモンモデルこそが専用 Mac が必要な理由です。クラウド Mac mini 上の OpenClaw は、あなたがオフラインの間も夜通しの調査タスク、継続的 CI 監視、数時間のデータパイプラインを処理し続けます。
| デプロイシナリオ | ローカルノート PC | Linux VPS | Mac mini(ProxyMac) |
|---|---|---|---|
| 24時間デーモン稼働 | ✗(スリープ/蓋閉め) | ✓ | ✓✓ |
| ネイティブ macOS API | ✓ | ✗ | ✓✓ |
| Xcode / iOS シミュレータ | ✓ | ✗ | ✓✓ |
| Apple Silicon パフォーマンス | ✓(Apple Silicon の場合) | ✗ | ✓✓ |
| ハードウェア投資不要 | ✗ | ✓ | ✓✓ |
| マルチリージョンデプロイ | ✗ | ✓ | ✓✓(HK/JP/KR/SG/US) |
前提条件:インストール前に確認すること
Node.js バージョン要件
OpenClaw は Node.js 22.0.0 以上が必要です。現在のバージョンを確認:
node --version
v22.0.0 未満の場合、nvm で最新 LTS をインストール:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.zshrc
nvm install 22
nvm use 22
nvm alias default 22
システム要件
- macOS 12(Monterey)以降——macOS 14 Sonoma または macOS 15 Sequoia を推奨
- 最低 8 GB RAM——並行エージェントタスクには 16 GB または 24 GB を推奨
- OpenClaw の状態ディレクトリ、モデルコンテキスト、タスク成果物用に 10 GB の空きディスク容量
- 安定したインターネット接続——すべてのエージェントアクションに AI プロバイダー API の呼び出しが必要
Mac mini への OpenClaw インストール:完全手順
ステップ 1:状態ディレクトリを設定する
インストール前に、OpenClaw の状態ディレクトリをローカルパスに設定してください。iCloud Drive、OneDrive、Dropbox パスを使用すると、クラウド同期の競合によりセッション状態が破損します:
echo 'export OPENCLAW_STATE_DIR=~/.openclaw' >> ~/.zshrc
source ~/.zshrc
mkdir -p ~/.openclaw
ステップ 2:npm で OpenClaw をインストール
npm install -g openclaw@latest
インストールの確認:
openclaw --version
openclaw/1.x.x darwin-arm64 node-v22.x.x のような出力が表示されるはずです。darwin-arm64 はネイティブ Apple Silicon ビルドで実行中であることを確認します。
ステップ 3:オンボーディングウィザードを実行
openclaw onboard --install-daemon
ウィザードは以下を確認します:
- AI プロバイダーと API キー(macOS キーチェーンに保存、平文ファイルではない)
- ワークスペースディレクトリ(デフォルト:
~/openclaw-workspace) - ファイルシステムアクセスと画面収録の権限付与(macOS セキュリティとプライバシーダイアログ)
ステップ 4:デーモンの状態を確認
openclaw status
期待される出力には daemon: running、プロセス PID、メモリ使用量が含まれます。stopped が表示された場合は手動で起動:
openclaw daemon start
ステップ 5:最初のエージェントタスクを実行
インストールを確認するためのシンプルなタスク:
openclaw run "~/openclaw-workspace のすべてのファイルをリストアップし、プロジェクト構造を説明する README.md を作成してください"
本番環境の設定
同時実行数とリソース制限
~/.openclaw/config.json を編集し、16 GB RAM の Mac mini M4 に適した設定を行います:
{
"daemon": {
"maxConcurrentTasks": 3,
"taskTimeoutMs": 1800000,
"memoryLimitMb": 4096
},
"agent": {
"defaultModel": "claude-sonnet-4-5",
"maxTokensPerTask": 200000,
"retryOnRateLimit": true,
"retryDelayMs": 5000
}
}
ログローテーション
openclaw config set logging.retainDays 14
openclaw config set logging.maxSizeMb 500
SSH 経由のリモート制御
長時間実行タスクには --detach フラグを使用:
openclaw run --detach "完全なテストスイートを実行して結果をメールで送信してください"
openclaw jobs list
openclaw jobs logs <ジョブID>
よくあるエラーと対処法
| エラーメッセージ | 根本原因 | 対処法 |
|---|---|---|
ERR_UNSUPPORTED_ESM_URL_SCHEME | Node.js が 22 未満 | nvm use 22 を実行して再インストール |
ENOENT: .openclaw/state/sessions | 状態ディレクトリ未設定または誤ったパス | $OPENCLAW_STATE_DIR を確認し、openclaw onboard を再実行 |
| デーモンがループで再起動 | 状態ディレクトリが iCloud Drive 上 | 状態ディレクトリを ~/.openclaw に移動 |
API rate limit exceeded | 同時タスク数が API クォータを超過 | maxConcurrentTasks を 1–2 に下げ、retryOnRateLimit を有効化 |
| 画面収録権限拒否 | macOS TCC 権限が付与されていない | システム設定 → プライバシーとセキュリティ → 画面収録 → openclaw を追加 |
Task context window exceeded | タスクが単一コンテキストウィンドウに対して大きすぎる | openclaw run --subtask でサブタスクに分割 |
openclaw daemon restart を実行してください。
ProxyMac Mac mini ノードへの OpenClaw デプロイ
- Mac mini インスタンスをプロビジョニング:ProxyMac にログインし、ノードを選択(日本ユーザーは JP または HK を推奨)、インスタンスを起動。約 2 分以内に SSH 認証情報を受け取ります。
- SSH で接続:
ssh -i ~/.ssh/id_ed25519_proxymac user@<ノードアドレス> - nvm と Node 22 をインストール:前提条件セクションの nvm インストールコマンドを実行。
- OpenClaw をインストール:
npm install -g openclaw@latest - ヘッドレスオンボーディングを実行:
OPENCLAW_STATE_DIR=~/.openclaw openclaw onboard --install-daemon --headless - 確認:
openclaw status
設定完了後、OpenClaw インスタンスは Mac mini ノードで 24 時間稼働します。いつでも SSH セッションを切断でき、アクティブなタスクは継続実行されます。openclaw jobs list で状態を確認できます。SSH および VNC アクセスの詳細についてはヘルプドキュメントをご覧ください。
2026年に OpenClaw の最適ホストが Mac mini M4 である理由
OpenClaw のパフォーマンス上限は二つの要因で決まります:AI プロバイダー API の応答速度(ネットワーク依存、制御外)と、Mac が AI の指示を実行する速度(CPU/メモリ依存、最適化可能)。Mac mini M4 では、アクション実行のオーバーヘッドが事実上ゼロです。
Apple Silicon M4 のニューラルエンジンはローカルモデル推論も可能にします——OpenClaw のローカルモデルモードは Apple の MLX フレームワークを使用し、M4 の 16 コアニューラルエンジン上で量化 LLM を 20–40 トークン/秒で実行します。API コストなし、データはノードの外に出ません。
ProxyMac のレンタルモデルにより、Mac mini の 9 万円〜18 万円の初期コストが不要になります。スプリント、製品ローンチ、1 ヶ月の研究プロジェクト用に期間限定で Mac mini M4 ノードをレンタルする方が大幅にコスト効率が良い。香港・日本・シンガポールのノードで OpenClaw エージェントを並列実行してグローバルな研究タスクを並列化したい場合も、ProxyMac のマルチノードプランで簡単に実現できます。料金ページでオプションをご確認ください。
クラウド Mac mini M4 で OpenClaw を動かす
HK / JP / KR / SG / US の SSH 対応ノード — 5 分以内に OpenClaw をデプロイ