1. Mac 向け OpenClaw ガイドが必要な理由
OpenClaw は複数プラットフォームで動作しますが、Mac（特に Apple Silicon）では環境パス、Homebrew と npm のグローバルプレフィックス、Gatekeeper と権限、そしてプロセスをバックグラウンドで動かす方法が Linux/Windows と異なります。「コマンドが見つからない」、EACCES、ポート使用中で詰まる方が多いです。本ガイドでは再現可能な Mac 手順とトラブルシュート表を提供します。
2. Mac 環境準備（Xcode CLI、Homebrew、Node）
ステップ1： Xcode Command Line Tools をインストールします。ターミナルで xcode-select --install を実行してください。
ステップ2： Homebrew を公式のワンライナーでインストールします。Apple Silicon の場合は、PATH に Homebrew を追加してください：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile のあと source ~/.zprofile を実行します。
ステップ3： Node.js 22 以上をインストールします。推奨：brew install nvm で nvm を入れ、シェル設定のあと nvm install 22 と nvm use 22。または brew install node@22 と brew link node@22 --force。node -v と npm -v で確認してください。
3. インストール方式の比較
| 方式 | コマンド／備考 | 用途 |
|---|---|---|
| npm グローバル | npm install -g openclaw@latest | 既存の Node 環境で手軽に試す |
| 公式スクリプト | curl -fsSL https://openclaw.ai/install.sh | bash | 依存関係と PATH を一括設定 |
| Docker | 公式またはコミュニティの OpenClaw イメージを使用 | 隔離環境 |
4. 5 ステップでのインストールと初回実行
ステップ1： 選択した方法でインストールを実行します（例：npm install -g openclaw@latest）。EACCES: permission denied が出た場合は、npm グローバルディレクトリの権限を修正します：sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}。
ステップ2： CLI を確認します。新しいターミナルで openclaw --version を実行してください。「コマンドが見つからない」場合は、PATH に npm のグローバル bin（npm config get prefix の /bin）が含まれているか確認してください。
ステップ3： ドキュメントに従って初期化（例：openclaw onboard）し、API キーを設定します。デフォルトのコンソールポートは 18789 や 3000 が多いので、ファイアウォールまたはセキュリティグループで許可してください。
ステップ4： ゲートウェイ/サービスを起動します（例：openclaw gateway または openclaw start）。ブラウザで該当ポートを開き、コンソールが表示されるか確認してください。
ステップ5： 最小限のテスト（コンソールまたは CLI で 1 リクエスト）を行い、必要に応じて LaunchAgent やバックグラウンド常駐を設定してください。
5. Apple Silicon の注意点
（1）Homebrew のパス： Apple Silicon では Homebrew は /opt/homebrew にあります。/opt/homebrew/bin を PATH に追加してください。（2）Rosetta 2： 一部の npm ネイティブモジュールは Rosetta のインストールを促すことがあります。表示されたらインストールしてください。（3）Gatekeeper： バイナリがブロックされた場合は、システム設定 → プライバシーとセキュリティ →「開く」を選択してください。
6. Mac トラブルシュート表
| 症状 | 想定原因 | 対処 |
|---|---|---|
| コマンドが見つからない（openclaw / node） | PATH に Homebrew または npm グローバル bin が含まれていない | ~/.zprofile または ~/.bash_profile にパスを追加して source |
| EACCES | npm グローバルディレクトリの所有者が現在のユーザーでない | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| ポート使用中 | デフォルトポートが使用されている | 設定でポートを変更するか、lsof でプロセスを特定して停止 |
| コンソールにアクセスできない | ファイアウォールまたはセキュリティグループ | macOS ファイアウォールでアプリを許可；リモート Mac の場合は 18789/3000 を開放 |
| 蓋を閉じるとプロセスが終了する | 常駐設定がない | LaunchAgent または nohup/screen を使用；またはリモート Mac で 24/7 稼働させる |
7. まとめ：リモート Mac で OpenClaw を 24/7 稼働させる
ローカルで OpenClaw が動いたら、24/7 稼働させたい場合や自機を占有したくない場合、スリープ・蓋の影響を避けたい場合は、リモート Mac ノードにデプロイしてください。同じ macOS と上記の手順で、専用・安定稼働が可能です。ローカルでの常駐や運用を省きたい場合は、MACGPU のリモート Mac をレンタルし、そこで OpenClaw をインストールすれば、一度の設定で長期的に安定して運用できます。