macOS companion app
macOS での Gateway のライフサイクル
macOS アプリはデフォルトで launchd を介して Gateway を管理し、Gateway を子プロセスとして起動しません。まず、設定されたポートですでに実行中の Gateway への接続を試みます。到達可能な Gateway がない場合は、外部の openclaw CLI を介して launchd サービスを有効にします（組み込みランタイムは使用しません）。これにより、ログイン時の確実な自動起動と、クラッシュ時の再起動が実現します。
子プロセスモード（アプリが Gateway を直接起動する方式）は、現在 使用されていません。UI とのより緊密な連携が必要な場合は、ターミナルで Gateway を手動実行してください。
デフォルトの動作（launchd）
- アプリは、
ai.openclaw.gatewayというラベルのユーザーごとの LaunchAgent をインストールします（--profile/OPENCLAW_PROFILEを使用する場合はai.openclaw.<profile>）。 - ローカルモードが有効な場合、アプリは LaunchAgent が読み込まれていることを確認し、必要に応じて Gateway を起動します。
- ログは launchd の Gateway ログパスに書き込まれます（デバッグ設定で確認できます）。
よく使用するコマンド：
launchctl kickstart -k gui/$UID/ai.openclaw.gatewaylaunchctl bootout gui/$UID/ai.openclaw.gateway名前付きプロファイルを実行する場合は、ラベルを ai.openclaw.<profile> に置き換えてください。
署名なしの開発ビルド
scripts/restart-mac.sh --no-sign は、署名キーを使用せずにローカルビルドをすばやく行うためのものです。launchd が署名なしのリレーバイナリを参照しないように、~/.openclaw/disable-launchagent を書き込みます。
署名ありで scripts/restart-mac.sh を実行すると、マーカーが存在する場合はこのオーバーライドが解除されます。手動でリセットするには、次のコマンドを実行します。
rm ~/.openclaw/disable-launchagent接続専用モード
macOS アプリが launchd をインストールまたは管理しないように強制するには、--attach-only（または --no-launchd）を指定して起動します。これにより ~/.openclaw/disable-launchagent が設定されるため、アプリはすでに実行中の Gateway に接続するだけになります。デバッグ設定でも同じ動作を切り替えられます。
リモートモード
リモートモードでは、ローカルの Gateway は起動されません。アプリはリモートホストへの SSH トンネルを使用し、そのトンネル経由で接続します。
launchd を推奨する理由
- ログイン時の自動起動。
- 組み込みの再起動および KeepAlive セマンティクス。
- 予測可能なログとプロセス監視。
真の子プロセスモードが再び必要になった場合は、開発専用の独立した明示的なモードとして文書化する必要があります。
