Gateway on macOS
Gateway runtime on macOS (external launchd service)
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 経由で同じフローを実行します(bun は Gateway ランタイムとして推奨されません)。
Launchd(Gateway を LaunchAgent として)
ラベル:
- ''bot.molt.gateway'' (or ''bot.molt.<profile>''; legacy ''com.openclaw.*'' may remain)
Plist の場所(ユーザーごと):
- ''~/Library/LaunchAgents/bot.molt.gateway.plist''
(or ''~/Library/LaunchAgents/bot.molt.<profile>.plist'')
マネージャー:
- macOS アプリはローカルモードで LaunchAgent のインストール/更新を所有します。
- CLI もインストールできます:''openclaw gateway install''。
Behavior:
- "OpenClaw Active" は 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