Gateway op macOS (externe launchd)¶

OpenClaw.app bundelt niet langer Node/Bun of de Gateway-runtime. De macOS-app verwacht een externe openclaw CLI-installatie, start de Gateway niet als childprocess en beheert een per‑gebruiker launchd-service om de Gateway draaiend te houden (of koppelt aan een bestaande lokale Gateway als die al actief is).

De CLI installeren (vereist voor lokale modus)¶

Je hebt Node 22+ op de Mac nodig en installeert daarna openclaw globaal:

npm install -g openclaw@<version>

De knop Install CLI in de macOS-app voert dezelfde stappen uit via npm/pnpm (bun niet aanbevolen voor de Gateway-runtime).

Launchd (Gateway als LaunchAgent)¶

Label:

• bot.molt.gateway (of bot.molt.<profile>; legacy com.openclaw.* kan blijven bestaan)

Plist-locatie (per gebruiker):

• ~/Library/LaunchAgents/bot.molt.gateway.plist (of ~/Library/LaunchAgents/bot.molt.<profile>.plist)

Beheer:

• De macOS-app beheert de installatie/update van de LaunchAgent in lokale modus.
• De CLI kan deze ook installeren: openclaw gateway install.

Gedrag:

• “OpenClaw Active” 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 daaraan in plaats van een nieuwe te starten.

Logregistratie:

• launchd stdout/err: /tmp/openclaw/openclaw-gateway.log

Versiecompatibiliteit¶

De macOS-app controleert de Gateway-versie ten opzichte van zijn eigen versie. Als ze niet compatibel zijn, werk de globale CLI bij zodat deze overeenkomt met de appversie.

Rook schaak¶

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