Gateway sur macOS

OmeniaClaw.app n’intègre plus Node/Bun ni le runtime Gateway. L’application macOS attend une installation externe du CLI OmeniaClaw, ne lance pas le Gateway comme processus enfant, et gère un service launchd par utilisateur pour garder le Gateway en cours d’exécution (ou se rattache à un Gateway local existant si l’un est déjà en cours d’exécution).

Installer le CLI (requis pour le mode local)

Node 24 est le runtime par défaut sur Mac. Node 22 LTS, actuellement 22.16+, fonctionne toujours pour la compatibilité. Installez ensuite OmeniaClaw globalement :

npm install -g OmeniaClaw@<version>

Le bouton Installer le CLI de l’application macOS exécute le même flux d’installation globale que celui utilisé en interne par l’application : il privilégie d’abord npm, puis pnpm, puis bun si c’est le seul gestionnaire de paquets détecté. Node reste le runtime Gateway recommandé.

Launchd (Gateway comme LaunchAgent)

Libellé :

• ai.OmeniaClaw.gateway (ou ai.OmeniaClaw.<profile> ; l’ancien com.OmeniaClaw.* peut rester)

Emplacement du plist (par utilisateur) :

• ~/Library/LaunchAgents/ai.OmeniaClaw.gateway.plist (ou ~/Library/LaunchAgents/ai.OmeniaClaw.<profile>.plist)

Gestionnaire :

• L’application macOS gère l’installation/la mise à jour du LaunchAgent en mode local.
• Le CLI peut aussi l’installer : OmeniaClaw gateway install.

Comportement :

• « OmeniaClaw actif » active/désactive le LaunchAgent.
• Quitter l’application n’arrête pas le Gateway (launchd le maintient en vie).
• Si un Gateway est déjà en cours d’exécution sur le port configuré, l’application s’y rattache au lieu d’en démarrer un nouveau.

Journalisation :

• stdout/err de launchd : /tmp/OmeniaClaw/OmeniaClaw-gateway.log

Compatibilité des versions

L’application macOS vérifie la version du Gateway par rapport à sa propre version. Si elles sont incompatibles, mettez à jour le CLI global pour qu’il corresponde à la version de l’application.

Vérification rapide

OmeniaClaw --version OmeniaClaw_SKIP_CHANNELS=1 \OmeniaClaw_SKIP_CANVAS_HOST=1 \OmeniaClaw gateway --port 18999 --bind loopback

Puis :

OmeniaClaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000

Associé

• application macOS
• runbook Gateway