Si install.sh ou install.ps1 officiel vient de se terminer mais que le terminal signale Gateway introuvable, que le port par défaut n'écoute pas et que la Control UI ne répond pas, il s'agit en général du demi-état d'installation fréquent en 2026 : CLI en place, daemon Gateway et finalisation onboard absents. Ce guide fournit une échelle d'acceptation en 10 minutes, un runbook de reprise en six étapes, une matrice et une checklist de mise en production — à lire avec l'installation multiplateforme et la baseline Node 24.
Vers mars 2026, la communauté a signalé un cas récurrent : sur environnement vierge, le script ne faisait que rafraîchir un service Gateway existant sans premier daemon install — succès apparent, Gateway absent. Même après correctifs en amont, les machines anciennes peuvent garder des traces. Si deux signes ou plus ci-dessous correspondent, suivez ce parcours de reprise plutôt qu'une réinstallation complète du serveur.
openclaw-gateway ou équivalent introuvable : which openclaw répond, mais le binaire Gateway ou le lien symbolique n'est pas dans le répertoire PATH attendu.
Port par défaut (souvent 18789) sans écoute : openclaw gateway status indique not running ou sorties en boucle ; openclaw logs vide ou très court.
Control UI / Dashboard sans réponse : Délai navigateur sur l'interface locale — distinct d'un échec d'authentification : le processus ne tourne pas.
onboard --install-daemon en erreur ou ignoré : certaines builds v2026.3.x échouaient à la vérification systemd — config écrite, service non installé.
Régression après mise à jour : deux openclaw dans le PATH, doctor signale split brain — lire d'abord reprise split brain après upgrade, puis revenir à l'acceptation Gateway ici.
Seule la sonde de canal échoue, Gateway running : phase la plus risquée passée — passer à dépannage auth ; ne pas supprimer la config à l'aveugle.
| Contrôle | Sain (prêt production) | Demi-installation (cet article) | Faux succès |
|---|---|---|---|
openclaw gateway status | Runtime: running; Probe ok | not running / commande absente | running mais port sans écoute (fichier PID obsolète) |
openclaw doctor | aucun bloquant ; validate ok | daemon non installé ou anomalie PATH | warnings seuls, ignorés |
channels status --probe | Connectivity probe: ok | pas de canaux (acceptable en phase Gateway seule) | échec de sonde pris à tort pour « installation cassée » |
| Runtime Node | Node 24 (oder dokumentiertes Minimum 22.14+) | mélange Node système et nvm, utilisateur du service voit autre chose | node -v correct en shell interactif, ancien dans l'unité systemd |
La dernière ligne verte du script ne vaut pas acceptation production — status, doctor et port doivent concorder.
L'ordre compte : rendre le Gateway démarrable et persistant, puis onboard pour modèles et canaux — ne pas modifier openclaw.json tant qu'aucun processus ne tourne.
Geler le contexte : openclaw --version, which -a openclaw, noter le canal d'installation (curl / npm -g / git).
Échelle de diagnostic : openclaw status → openclaw gateway status → openclaw logs --follow (second terminal) → openclaw doctor.
Démarrer le Gateway : openclaw gateway start; si daemon absent openclaw onboard --install-daemon (token et config minimale dans l'assistant).
CLI oui, Gateway non : après baseline Node 24, éventuellement npm install -g openclaw --force ; en conteneur, privilégier Docker/Podman plutôt que systemd forcé.
Version : si régression daemon v2026.3.2, épingler v2026.3.1 ou build avec correctif PR #48649 ; noter le point de rollback dans le change ticket.
Acceptation production : openclaw channels status --probe, loopback/Token, retest après redémarrage ; macOS : Mac distant launchd, Linux: Ubuntu systemd.
# Acceptation 10 minutes (2026) openclaw status openclaw gateway status openclaw doctor openclaw gateway start openclaw onboard --install-daemon # si daemon absent openclaw channels status --probe
Note : Les scripts officiels recommandent Node 24 sur macOS/Linux. D'abord baseline CVE-2026-25253 et Node 24, puis ce runbook — ne pas exposer le Gateway sans alignement sécurité.
Attention : Ne pas « réparer » une demi-installation en exposant le Gateway sur Internet ; rester sur 127.0.0.1, accès distant via Tailscale ou tunnel — voir les articles sécurité Gateway du site.
onboard --install-daemon transforme le Gateway en service redémarrable — une étape manquante = demi-installation.doctor und gateway status à journaliser régulièrement ; l'issue #48272 montre qu'un log d'installation ne remplace pas l'acceptation au niveau processus.Un Gateway sur portable en veille ou machine de dev partagée retombe facilement en demi-état après mise à jour OS. Un nœud macOS dédié et toujours en ligne convient mieux comme hôte d'agent. Pour une capacité Mac maintenable en SSH comme un VPS avec scripts d'acceptation reproductibles, la location Mac Mini cloud NodeMini est souvent le meilleur choix — même logique opérationnelle que le mode distant OpenClaw et le CI sur un même hôte ; les contrôles 10 minutes s'intègrent aux images standard et runbooks.
Section trois : gateway start und onboard --install-daemon, Daemon mit doctor verifizieren. Kapazität: tarifs de location Mac Mini.
Là : première installation Windows/macOS/Linux ; ici : script terminé, Gateway pas prêt. Lire les deux articles.
Commandes de diagnostic identiques ; persistance : launchd vs. systemd. Accès : centre d’aide Cloud Mac.