Skip to main content
OpenClaw.app には Node または Gateway ランタイムは同梱されていません。macOS アプリは 外部の openclaw CLI インストールを必要とし、Gateway を 子プロセスとして起動せず、ユーザーごとの launchd サービスを管理して Gateway の 実行を維持します（または、すでに実行中のローカル Gateway に接続します）。

​
自動セットアップ

新しい Mac では、オンボーディング中に This Mac を選択します。アプリは Gateway ウィザードの前に、署名済みの同梱インストーラースクリプトを実行します。ユーザー空間の Node ランタイムと対応する openclaw CLI を ~/.openclaw 配下に インストールしてから、ユーザーごとの launchd サービスをインストールして起動します。 この方法では Terminal、Homebrew、管理者アクセスは不要です。 アプリに同梱されるのはインストーラースクリプトのみで、Node または Gateway の ペイロードは含まれません。セットアップでランタイムと対応する OpenClaw パッケージを ダウンロードするには、インターネット接続が必要です。

​
手動復旧

手動インストールには Node 24.15+ を推奨します。Node 22.22.3+ も使用できます。 openclaw をグローバルにインストールします。
自動セットアップに失敗した後は Retry setup を使用します。それでも失敗する場合は、 上記のコマンドで CLI を手動インストールしてから、オンボーディングで Check again を選択します。

​
Launchd（LaunchAgent としての Gateway）

ラベル: ai.openclaw.gateway（デフォルトプロファイル）、または名前付きプロファイルの場合は ai.openclaw.<profile>。 Plist の場所（ユーザーごと）: ~/Library/LaunchAgents/ai.openclaw.gateway.plist （または ai.openclaw.<profile>.plist）。 ローカルモードでは、macOS アプリがデフォルトプロファイルの LaunchAgent の インストールと更新を管理します。CLI から直接インストールすることもできます: openclaw gateway install （名前付きプロファイルは OPENCLAW_PROFILE 環境変数で選択します）。 動作:
  • 「OpenClaw Active」で LaunchAgent を有効化または無効化します。
  • アプリを終了しても Gateway は停止しません（launchd が実行を維持します）。
  • 設定されたポートですでに Gateway が実行中の場合、アプリは新しい Gateway を 起動せず、その Gateway に接続します。
ログ:
  • launchd の標準出力: ~/Library/Logs/openclaw/gateway.log（プロファイルでは gateway-<profile>.log を使用）
  • launchd の標準エラー出力: 抑制
  • ホストで EADDRINUSE が繰り返されるループや高速な再起動が発生する場合は、 重複する ai.openclaw.gateway / ai.openclaw.node LaunchAgent と、 Gateway のトラブルシューティングにある launchd マーカーの回避策を確認してください。

​
バージョンの互換性

macOS アプリは、Gateway のバージョンを自身のバージョンと照合します。既存の CLI が 見つからない場合や互換性がない場合、オンボーディングは管理対象セットアップを 自動的に実行します。インストールを再実行するには Retry setup を使用し、 外部 CLI を修復した後は Check again を使用します。

​
macOS の状態ディレクトリ

OpenClaw の状態は、同期されないローカルディスクに保存してください。iCloud Drive や その他のクラウド同期フォルダーは避けてください。同期遅延とファイルロックが、 セッション、認証情報、および Gateway の状態に影響する可能性があります。 オーバーライドが必要な場合にのみ、OPENCLAW_STATE_DIR をローカルパスに設定します。 openclaw doctor は一般的なクラウド同期状態パスについて警告し、 ローカルストレージに戻すことを推奨します。 環境変数と Doctorを参照してください。

​
アプリ接続のデバッグ

ソースチェックアウトから macOS デバッグ CLI を使用して、アプリと同じ Gateway WebSocket ハンドシェイクおよび検出ロジックを実行します。
connect は --url、--token、--timeout、--probe、および --json を受け付けます（クライアント ID のオーバーライドも使用できます。完全な一覧を表示するには --help を指定して実行してください）。 discover は --timeout、--json、および --include-local を受け付けます。 CLI の検出とアプリ側の接続問題を切り分ける必要がある場合は、検出出力を openclaw gateway discover --json と比較してください。

​
スモークチェック

次に実行します。

​
関連項目