macOS companion app

Gateway-levenscyclus op macOS

De macOS-app beheert de Gateway standaard via launchd en start de Gateway niet als onderliggend proces. De app probeert eerst verbinding te maken met een Gateway die al op de geconfigureerde poort draait. Als er geen bereikbaar is, schakelt de app de launchd-service in via de externe openclaw-CLI (zonder ingebouwde runtime). Dit zorgt voor betrouwbaar automatisch starten bij het aanmelden en herstarten na crashes.

De modus voor onderliggende processen (waarbij de Gateway rechtstreeks door de app wordt gestart) wordt momenteel niet gebruikt. Als je een nauwere koppeling met de gebruikersinterface nodig hebt, voer je de Gateway handmatig uit in een terminal.

Standaardgedrag (launchd)

De app installeert een LaunchAgent per gebruiker met het label ai.openclaw.gateway (of ai.openclaw.<profile> bij gebruik van --profile/OPENCLAW_PROFILE).
Wanneer de lokale modus is ingeschakeld, zorgt de app ervoor dat de LaunchAgent is geladen en start deze zo nodig de Gateway.
Logboeken worden naar het pad voor het launchd-Gateway-logboek geschreven (zichtbaar in de foutopsporingsinstellingen).

Veelgebruikte opdrachten:

bash

launchctl kickstart -k gui/$UID/ai.openclaw.gatewaylaunchctl bootout gui/$UID/ai.openclaw.gateway

Vervang bij gebruik van een benoemd profiel het label door ai.openclaw.<profile>.

Niet-ondertekende ontwikkelbuilds

scripts/restart-mac.sh --no-sign is bedoeld voor snelle lokale builds zonder ondertekeningssleutels. Om te voorkomen dat launchd naar een niet-ondertekend relay-binair bestand verwijst, schrijft het script ~/.openclaw/disable-launchagent.

Ondertekende uitvoeringen van scripts/restart-mac.sh wissen deze overschrijving als de markering aanwezig is. Handmatig herstellen:

bash

rm ~/.openclaw/disable-launchagent

Modus voor alleen verbinding maken

Om af te dwingen dat de macOS-app launchd nooit installeert of beheert, start je de app met --attach-only (of --no-launchd). Hiermee wordt ~/.openclaw/disable-launchagent ingesteld, zodat de app alleen verbinding maakt met een Gateway die al actief is. Schakel hetzelfde gedrag in of uit via de foutopsporingsinstellingen.

Externe modus

De externe modus start nooit een lokale Gateway. De app gebruikt een SSH-tunnel naar de externe host en maakt via die tunnel verbinding.

Waarom we de voorkeur geven aan launchd

Automatisch starten bij het aanmelden.
Ingebouwde semantiek voor herstarten en KeepAlive.
Voorspelbare logboeken en procesbewaking.

Als er ooit weer een echte modus voor onderliggende processen nodig is, moet die worden gedocumenteerd als een afzonderlijke, expliciete modus die uitsluitend voor ontwikkeling is bedoeld.

Gerelateerd

Was this useful?