2026 — OpenClaw Gateway 7×24 : déconnexions et dépannage du démon — install-daemon, launchd et openclaw health (parcours reproductible)

2. Trois causes racines fréquentes

1. launchd contre shell interactif : lancer openclaw gateway à la main hérite de nvm/fnm/PATH personnalisé, alors que les LaunchAgents ne voient que les EnvironmentVariables du plist. Symptômes : command not found sporadiques ou chemins de modèles locaux manquants.
2. Spirales crash–throttle (ThrottleInterval) : erreurs 429 amont, rotation de certificats ou conflits de ports font quitter la passerelle vite ; launchd relance en quelques secondes, applique le backoff, et l'extérieur voit des « minutes silencieuses ». Sans LastExitStatus, on croit souvent à une panne réseau pure.
3. Sondes « santé » qui ne sont pas des sondes de disponibilité : tester « le processus existe » au lieu de la readiness HTTP — ou sonder trop agressivement — provoque de faux redémarrages pendant le GC ou le renouvellement DNS, ce qui amplifie ThrottleInterval. Les charges planifiées OpenClaw (tarification, conformité) ajoutent du pic ; anticipez la capacité en parallèle des pratiques décrites dans Pratiques de déploiement sécurisé OpenClaw 2026 : passerelle d'agents IA hautement disponible avec ZoneMac pour éviter que la passerelle ne tombe en même temps qu'une tempête de cron aveugle.

3. Matrice : symptôme → preuve → action

Un tableau pour relier ce que voient les utilisateurs à la première commande à lancer — moins de défilement de journaux au hasard.

4. Sept étapes de dépannage reproductibles

1. Référence : à l'état sain, exécutez openclaw health --json si votre build l'offre ; conservez URL d'écoute, version et contrôles de dépendances comme instantané de référence.
2. Fenêtre de reproduction : utilisez log stream --predicate 'process == "launchd"' ou la Console filtrée sur le label de la passerelle ; ciblez ±5 minutes autour d'un incident.
3. État launchd : exécutez launchctl print gui/$(id -u)/com.openclaw.gateway (remplacez par votre Label réel) et notez LastExitStatus, runs et état.
4. Réinstaller le démon : en fenêtre de maintenance, openclaw install-daemon, puis launchctl bootout sur l'ancienne entrée et launchctl bootstrap sur le nouveau plist pour éviter deux instances.
5. Passage paramètres : définissez un ThrottleInterval raisonnable (souvent ≥ 10 s), KeepAlive et ExitTimeOut (point de départ courant 20 s) pour laisser la fermeture gracieuse drainer les connexions.
6. Sondes externes : pointez l'orchestration vers openclaw health toutes les 30–60 s ; alertez seulement après trois échecs consécutifs pour lisser le jitter.
7. Acceptation : conservez 24 h de courbe santé et le nombre d'exécutions launchd ; une croissance en marches d'escalier signifie retour à l'étape 3 pour comparer les codes de sortie.

5. Paramètres citables et checklist

• ExitTimeOut 20 s : laisse à la passerelle le temps de se terminer après SIGTERM ; une valeur trop basse pousse launchd au SIGKILL et à des sorties non nulles.
• Sondes 30–60 s : cohérent avec la FAQ — équilibre faux positifs et délai de détection ; les métriques internes peuvent rester à 15 s sans lier la politique de redémarrage à cette granularité.
• ThrottleInterval ≥ 10 s : amortit temporairement les tempêtes de redémarrage avant correction durable ; associez limites amont et surveillance des certificats plutôt que de compter sur le seul backoff.

6. Pourquoi le Mac mini accueille mieux la passerelle

Les charges passerelle redoutent deux risques cachés : redémarrages thermiques ou alimentation, et une couche de virtualisation qui ajoute du jitter d'ordonnancement. Un Mac mini Apple Silicon se situe souvent autour d'environ 4 W au repos branché, ce qui convient aux démons toujours actifs ; la pile macOS + Silicon unifiée simplifie launchd, la pile réseau et TLS quand vous rédigez des runbooks.

Pour une sortie stable vers les API amont avec moins de bruit de voisinage qu'en VM multi-locataire, un nœud physique réduit aussi la « latence mystère ». Unix et SSH sont de première classe sur macOS : les étapes ci-dessus s'intègrent proprement au CI ou aux playbooks d'astreinte.

Si vous voulez OpenClaw Gateway sur du matériel silencieux, économe et prévisible dans la durée, le Mac mini M4 est l'un des meilleurs points d'entrée — découvrez les nœuds ZoneMac et alignez démon et supervision en une seule passe.