Si vous avez terminé le guide d’installation OpenClaw mais voyez encore « CLI OK, Gateway mort », « timeouts modèle » ou « le démon ne tient pas sous WSL2 », il vous faut une validation post-install et un triage par symptômes, pas un copier-coller des étapes d’install. Cet article se positionne par rapport au guide trois plateformes, au Docker production et au guide avancé Secrets/PDF : il ne livre qu’une matrice de symptômes, un runbook en six étapes et trois métriques ops, plus les écarts WSL2 contre Linux/macOS natifs.
Les systèmes qui combinent un Gateway longue durée, une sortie vers les modèles et des démons locaux échouent souvent alors que « chaque brique semble bonne seule ». En astreinte, séparez aussi une mauvaise config ponctuelle des problèmes réseau intermittents et de politique d’alimentation. Alignez-vous sur les cinq pièges ci-dessous avant le tableau.
Utilisez le tableau en astreinte ; les noms exacts de CLI dépendent de votre version OpenClaw installée. Préférez doctor ou équivalent avant d’aller plus loin.
| Ce que vous voyez | Direction probable | Essayer en premier |
|---|---|---|
| Le processus quitte tout de suite | Version Node, droits, répertoire de travail | Aligner la baseline Node officielle ; lancer doctor ; vérifier utilisateur d’install et droits sur le répertoire de données |
| Port Gateway silencieux | Adresse d’écoute, conflit de port, pare-feu | Confirmer l’écoute ; curl health en local ; vérifier pare-feu hôte et groupes de sécurité amont |
| Timeouts modèle ou flux qui coupent | Egress, DNS, proxy, région, quota | Requête minimale ; contourner le proxy ; vérifier quota et région du endpoint |
| Uniquement sous WSL2, Linux nu OK | Perf FS, réseau virtuel, trous systemd | Garder les dépôts sur ext4 WSL ; éviter d’énormes arbres cross-disque ; valider stratégie systemd/session utilisateur |
| Échec après veille/mise à jour | Politique d’alimentation portable et reprise démon | Réglages d’alimentation ; si les démons meurent avec la session GUI ; besoin d’un hôte dédié |
# Contrôles post-install (noms selon votre CLI)
openclaw doctor
curl -fsS "http://127.0.0.1:${OPENCLAW_GATEWAY_PORT:-PORT}/health" || true
WSL2 : grosses compilations ou file watchers sur /mnt/c sont plus lents et peuvent manquer des événements par rapport aux systèmes de fichiers Linux ; les Gateways longue durée doivent garder dépôts et données sur le volume Linux WSL et valider le cycle de vie systemd/session séparément.
Ces étapes reprennent la discipline des health checks Docker mais s’appliquent aux installs bare-metal ou hybrides : chaque critère d’acceptation doit être reproductible.
Elles ne remplacent pas la doc mais alignent revue et astreinte.
Veille, mises à jour et invites de droits interrompent les processus longue durée ; WSL2 et le réseau Windows natif divergent encore plus. Si le Gateway OpenClaw doit être fiable pour l’équipe, un hôte Apple Silicon dédié et observable bat en général l’empilement infini de contournements locaux.
MACCOME propose des Mac distants bare-metal multi-régions adaptés à des Gateways stables et à l’automatisation ; après les guides install et Docker, si veille et reprise démon vous bloquent encore, commencez par le centre d’aide et alignez-vous sur les tarifs et régions.
Pour un débogage court sur laptop, terminez cette checklist en six étapes et scriptez les health checks ; quand la CI ou des agents 24/7 entrent en jeu, évaluez plutôt une migration vers un Mac distant dédié qu’un empilement de rustines locales.
FAQ
Le guide d’install liste déjà les commandes—pourquoi cet article ?
Le guide trois plateformes couvre comment installer ; cet article couvre comment prouver la santé et trier les symptômes.
Cela duplique-t-il l’article Docker production ?
Non. Le runbook Docker production traite images et Compose ; celui-ci des contrôles post-install, sondes et écarts WSL2/natif.
Dois-je lire d’abord l’article avancé Secrets ?
La gouvernance est dans le runbook avancé ; si les modèles échouent encore, utilisez d’abord la matrice ici, puis revenez pour rotation et audit. Pour une surface d’exécution stable, voir le centre d’aide et les tarifs de location.