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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

macOS アプリはデフォルトで launchd 経由で Gateway を管理し、Gateway を子プロセスとして生成しません。まず、設定済みポートで既に実行中の Gateway への接続を試みます。到達可能なものがない場合は、外部の openclaw CLI（埋め込みランタイムなし）を介して launchd サービスを有効にします。これにより、ログイン時の信頼性の高い自動起動と、クラッシュ時の再起動が得られます。 子プロセスモード（アプリが Gateway を直接生成する方式）は、現在 使用されていません。UI とより密に連携する必要がある場合は、ターミナルで Gateway を手動実行してください。

​
デフォルトの動作（launchd）

  • アプリは、ai.openclaw.gateway というラベルのユーザー単位 LaunchAgent をインストールします （--profile/OPENCLAW_PROFILE を使用する場合は ai.openclaw.<profile>。従来の com.openclaw.* もサポートされます）。
  • ローカルモードが有効な場合、アプリは LaunchAgent が読み込まれていることを確認し、 必要に応じて Gateway を起動します。
  • ログは launchd の Gateway ログパスに書き込まれます（デバッグ設定で確認できます）。
一般的なコマンド: 
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl 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 セマンティクス。
  • 予測可能なログと監視。
真の子プロセスモードが再び必要になった場合は、独立した明示的な開発専用モードとして文書化するべきです。

​
関連