macOS コンパニオンアプリ
macOS 上の Gateway
OpenClaw.app は Node/Bun や Gateway ランタイムを同梱しなくなりました。macOS アプリは 外部の openclaw CLI インストールを想定し、Gateway を子プロセスとして起動せず、Gateway を実行し続けるためにユーザーごとの launchd サービスを管理します（または、すでにローカル Gateway が実行されている場合はそれにアタッチします）。
CLI のインストール (ローカルモードに必須)
Mac に Node 22+ が必要です。その後、グローバルに openclaw をインストールします:
npm install -g openclaw@<version>
macOS アプリの CLI をインストール ボタンは、npm/pnpm 経由で同じフローを実行します（Gateway ランタイムには bun は推奨されません）。
Launchd (LaunchAgent としての Gateway)
ラベル:
ai.openclaw.gateway(またはai.openclaw.<profile>; レガシーなcom.openclaw.*が残っている場合があります)
Plist の場所 (ユーザーごと):
~/Library/LaunchAgents/ai.openclaw.gateway.plist(または~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
マネージャー:
- macOS アプリがローカルモードでの LaunchAgent のインストール/更新を所有します。
- CLI でもインストールできます:
openclaw gateway install。
動作:
- 「OpenClaw アクティブ」は LaunchAgent を有効/無効にします。
- アプリを終了しても gateway は停止しません (launchd が生存を維持します)。
- 設定されたポートですでに Gateway が実行されている場合、アプリは新しいものを起動する代わりにそれにアタッチします。
ロギング:
- launchd stdout/err:
/tmp/openclaw/openclaw-gateway.log
バージョン互換性
macOS アプリは、gateway のバージョンを自身のバージョンと照合します。互換性がない場合は、グローバル CLI をアプリのバージョンに合わせて更新してください。
スモークチェック
openclaw --version
OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
その後:
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000