macOS companion app
Gateway op macOS
OpenClaw.app bundelt Node/Bun of de Gateway-runtime niet langer mee. De macOS-app
verwacht een externe installatie van de openclaw CLI, start de Gateway niet als
childproces en beheert een launchd-service per gebruiker om de Gateway
actief te houden (of koppelt met een bestaande lokale Gateway als er al een draait).
Installeer de CLI (vereist voor lokale modus)
Node 24 is de standaardruntime op de Mac. Node 22 LTS, momenteel 22.16+, werkt nog steeds voor compatibiliteit. Installeer daarna openclaw globaal:
npm install -g openclaw@<version>
De knop CLI installeren in de macOS-app voert dezelfde globale installatiestroom uit die de app intern gebruikt: eerst wordt npm geprobeerd, daarna pnpm, daarna bun als dat de enige gedetecteerde pakketbeheerder is. Node blijft de aanbevolen Gateway-runtime.
Launchd (Gateway als LaunchAgent)
Label:
ai.openclaw.gateway(ofai.openclaw.<profile>; legacycom.openclaw.*kan blijven bestaan)
Plist-locatie (per gebruiker):
~/Library/LaunchAgents/ai.openclaw.gateway.plist(of~/Library/LaunchAgents/ai.openclaw.<profile>.plist)
Beheerder:
- De macOS-app is eigenaar van installatie/update van de LaunchAgent in lokale modus.
- De CLI kan deze ook installeren:
openclaw gateway install.
Gedrag:
- "OpenClaw actief" schakelt de LaunchAgent in/uit.
- Het afsluiten van de app stopt de gateway niet (launchd houdt deze actief).
- Als er al een Gateway draait op de geconfigureerde poort, koppelt de app ermee in plaats van een nieuwe te starten.
Logging:
- launchd stdout/err:
/tmp/openclaw/openclaw-gateway.log
Versiecompatibiliteit
De macOS-app controleert de gatewayversie ten opzichte van de eigen versie. Als ze incompatibel zijn, werk dan de globale CLI bij zodat deze overeenkomt met de appversie.
Smoke-check
openclaw --version
OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
Daarna:
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000