macOS companion app

Cycle de vie du Gateway sous macOS

L’app macOS gère le Gateway via launchd par défaut et ne lance pas le Gateway en tant que processus enfant. Elle tente d’abord de se connecter à un Gateway déjà en cours d’exécution sur le port configuré ; si aucun n’est accessible, elle active le service launchd via la CLI openclaw externe (sans environnement d’exécution intégré). Cela garantit un démarrage automatique fiable à l’ouverture de session et un redémarrage après un plantage.

Le mode processus enfant (Gateway lancé directement par l’app) n’est pas utilisé actuellement. Si vous avez besoin d’un couplage plus étroit avec l’interface utilisateur, exécutez manuellement le Gateway dans un terminal.

Comportement par défaut (launchd)

L’app installe un LaunchAgent propre à l’utilisateur avec l’identifiant ai.openclaw.gateway (ou ai.openclaw.<profile> lors de l’utilisation de --profile/OPENCLAW_PROFILE).
Lorsque le mode local est activé, l’app vérifie que le LaunchAgent est chargé et démarre le Gateway si nécessaire.
Les journaux sont écrits dans le chemin du journal du Gateway de launchd (visible dans les réglages de débogage).

Commandes courantes :

bash

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

Remplacez l’identifiant par ai.openclaw.<profile> lors de l’exécution d’un profil nommé.

Builds de développement non signés

scripts/restart-mac.sh --no-sign permet d’effectuer rapidement des builds locaux sans clés de signature. Pour empêcher launchd de pointer vers un binaire relais non signé, cette commande écrit ~/.openclaw/disable-launchagent.

Les exécutions signées de scripts/restart-mac.sh suppriment ce remplacement si le marqueur est présent. Pour le réinitialiser manuellement :

bash

rm ~/.openclaw/disable-launchagent

Mode connexion uniquement

Pour forcer l’app macOS à ne jamais installer ni gérer launchd, lancez-la avec --attach-only (ou --no-launchd). Cela définit ~/.openclaw/disable-launchagent, afin que l’app se connecte uniquement à un Gateway déjà en cours d’exécution. Activez ou désactivez le même comportement dans les réglages de débogage.

Mode distant

Le mode distant ne démarre jamais de Gateway local. L’app utilise un tunnel SSH vers l’hôte distant et se connecte par l’intermédiaire de ce tunnel.

Pourquoi nous préférons launchd

Démarrage automatique à l’ouverture de session.
Sémantique intégrée de redémarrage/KeepAlive.
Journaux et supervision prévisibles.

Si un véritable mode processus enfant devait de nouveau être nécessaire, il devrait être documenté comme un mode distinct, explicite et réservé au développement.

Voir aussi

Was this useful?