macOS companion app
Gateway op macOS
OmeniaClaw.app bundelt Node/Bun of de Gateway-runtime niet langer mee. De macOS-app
verwacht een externe installatie van de OmeniaClaw 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 OmeniaClaw globaal:
npm install -g OmeniaClaw@<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.OmeniaClaw.gateway(ofai.OmeniaClaw.<profile>; legacycom.OmeniaClaw.*kan blijven bestaan)
Plist-locatie (per gebruiker):
~/Library/LaunchAgents/ai.OmeniaClaw.gateway.plist(of~/Library/LaunchAgents/ai.OmeniaClaw.<profile>.plist)
Beheerder:
- De macOS-app is eigenaar van installatie/update van de LaunchAgent in lokale modus.
- De CLI kan deze ook installeren:
OmeniaClaw gateway install.
Gedrag:
- "OmeniaClaw 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/OmeniaClaw/OmeniaClaw-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
OmeniaClaw --version OmeniaClaw_SKIP_CHANNELS=1 \OmeniaClaw_SKIP_CANVAS_HOST=1 \OmeniaClaw gateway --port 18999 --bind loopbackDaarna:
OmeniaClaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000