メインコンテンツへスキップ

​
macOS における Gateway（ゲートウェイ）のライフサイクル

子プロセスモード（アプリが直接 Gateway（ゲートウェイ）を起動する方式）は、現在 使用されていません。UI とのより密な連携が必要な場合は、ターミナルで Gateway（ゲートウェイ）を手動起動してください。 38. まず設定されたポートで既に実行中の Gateway への接続を試みます。到達可能なものがない場合は、外部の openclaw CLI を介して launchd サービスを有効化します（組み込みランタイムはありません）。 39. これにより、ログイン時の確実な自動起動と、クラッシュ時の再起動が実現します。 チャイルドプロセス モード (ゲートウェイはアプリから直接生成されます) は今日は 使用されていません 。 UI へのより強いカップリングが必要な場合は、ターミナルで Gateway を手動で実行します。

​
既定の動作（launchd）

  • アプリは、ユーザーごとの LaunchAgent（ラベルは bot.molt.gateway。--profile/OPENCLAW_PROFILE を使用する場合は bot.molt.<profile>。レガシーの com.openclaw.* もサポート）をインストールします。
  • ローカルモードが有効な場合、アプリは LaunchAgent がロードされていることを確認し、必要に応じて Gateway（ゲートウェイ）を起動します。
  • ログは launchd の Gateway（ゲートウェイ）ログパスに書き込まれます（Debug Settings で確認できます）。
一般的なコマンド: 
launchctl kickstart -k gui/$UID/bot.molt.gateway
launchctl bootout gui/$UID/bot.molt.gateway
名前付きプロファイルを実行する場合は、ラベルを bot.molt.<profile> に置き換えてください。

​
署名なしの開発ビルド

scripts/restart-mac.sh --no-sign は、署名キーがない場合の高速なローカルビルド向けです。launchd が署名されていないリレーのバイナリを指さないようにするため、次を行います。 unsigned 中継バイナリを指して起動を防ぐには、次の手順を実行します。 unsigned 中継バイナリを指して起動を防ぐには、次の手順を実行します。
  • ~/.openclaw/disable-launchagent を書き込みます。
scripts/restart-mac.sh の署名付き実行では、マーカーが存在する場合にこの上書きを解除します。手動でリセットするには、次を実行してください。 手動でリセットするには: 手動でリセットするには: 
rm ~/.openclaw/disable-launchagent

​
アタッチのみモード

macOS アプリに launchd のインストールや管理を一切行わせない ようにするには、--attach-only（または --no-launchd）を指定して起動します。これにより ~/.openclaw/disable-launchagent が設定され、アプリは既に稼働中の Gateway（ゲートウェイ）にのみ接続します。同じ挙動は Debug Settings でも切り替え可能です。 40. これにより ~/.openclaw/disable-launchagent が設定され、アプリは既に実行中の Gateway にのみ接続するようになります。 「デバッグ設定」で同じ 動作を切り替えることができます。 「デバッグ設定」で同じ 動作を切り替えることができます。

​
リモートモード

リモートモードでは、ローカルの Gateway（ゲートウェイ）を起動しません。アプリはリモートホストへの SSH トンネルを使用し、そのトンネル越しに接続します。 リモートモードでは、ローカルの Gateway（ゲートウェイ）を起動しません。アプリはリモートホストへの SSH トンネルを使用し、そのトンネル越しに接続します。 アプリは リモートホストにSSHトンネルを使用し、そのトンネルを介して接続します。

​
launchd を推奨する理由

  • ログイン時の自動起動。
  • 組み込みの再起動／KeepAlive のセマンティクス。
  • 予測可能なログと監督。
真の子プロセスモードが再び必要になった場合は、別個の、明示的な開発専用モードとして文書化されるべきです。