Public : vous avez installé npm i -g openclaw en suivant des notes éparses, mais vous jonglez entre workspace, Gateway, canaux et Skills sans la séquence openclaw onboard recommandée, et hésitez sur la manière d’aligner Node 24, daemons, canaux stable/beta/dev. Résultat : un runbook relecturable—doctor → onboard → preuve de premier canal → premier Skill ClawHub → install daemon → montées/retours documentés—pour passer de « ça démarre » à « ça tient seul en continu ». Carte : six pièges → tableau des chemins → six étapes → trois champs d’audit ; lire avec docker-setup + GHCR, pairing Compose 1008 et triage post-install doctor.
L’amont pousse onboard car Gateway, workspace, canaux et modèles par défaut ont des dépendances d’ordre. Sauter l’assistant en éditant le JSON finit souvent en « processus up, jamais de messages » ou « Skill installé, outils jamais enregistrés ». Six lectures erronées fréquentes en 2026 :
openclaw doctor : sans bisect en fin d’onboard. Traitez doctor comme un verrou, pas un ornement.Si vous ciblez les conteneurs, lisez docker-setup + GHCR d’abord, cet article ensuite. Problèmes de sous-agent, lisez Compose 1008 avant de réinstaller npm à l’aveugle.
| Chemin | Idéal pour | Artefacts à saisir | Rapport à cet article |
|---|---|---|---|
openclaw onboard (npm global) | Mac dédié ou VPS avec Gateway durable | Workspace, openclaw.json, unité launchd/systemd, preuve de canal, journal de vérification Skill | Principal |
| Docker/Compose officiel | livraison par image, runtime homogène | fichier Compose, carto volumes, politique de switch OPENCLAW_IMAGE | Complément |
| Triage centré sur doctor | installé mais malsain | arbres de symptômes, empreintes de logs | Lecture en parallèle |
Attention : onboard écrit sous le home. Sur comptes macOS partagés, validez la politique. En production, préférez des hôtes dédiés ou comptes de service.
node -v dans le ticket de changement.npm i -g openclaw@latest puis openclaw doctor; vider le risque élevé avant onboard.openclaw onboard : workspace, modèle par défaut, injection AGENTS.md, au moins un canal; noter le port du Gateway et le chemin Control UI depuis l’assistant.openclaw skills search → openclaw skills install <name> → redémarrer le Gateway → openclaw skills list.openclaw onboard --install-daemon (ou équivalent assistant); rotation des logs et seuils disque avant de jouer openclaw update --channel beta|dev.node -v npm i -g openclaw@latest openclaw doctor openclaw onboard openclaw skills search "calendar" openclaw skills install example-org/some-skill openclaw restart openclaw skills list openclaw onboard --install-daemon openclaw update --channel stable
v24.x via nvm; relancer doctor après chaque upgrade OS.stable|beta|dev à des fenêtres calendrier; les retours notent des paires versions CLI+Gateway.Ce sont des champs d’ingénierie, pas des SLA fournisseurs. Si le Gateway partage l’hôte avec la CI, ajoutez des alertes CPU et disque pour ne pas laisser les builds affamer les logs ou l’état SQLite.
Le onboard ancre l’automatisation : une fois les répertoires workspace/Skills stables, sauvegardes et upgrades n’ont qu’une source de vérité. Sauter cette ancre, c’est des réunions sur « qui a touché openclaw.json ».
Veille, aléas VPN et mises à jour d’entreprise brisent la continuité temporelle du Gateway. Quand OpenClaw devient le plan de contrôle de fait d’une petite équipe, privilégiez un hôte 7j/7 avec disque et sortie internet prévisibles; gardez le portable en client CLI si besoin.
Les tours maison et bureau offrent des fenêtres de patch et d’aléa électriques mal maîtrisées. Avec ferme de builds iOS et agents IA colocalisés, des hôtes cloud Apple Silicon multi-régions, gouvernés, donnent en général de meilleures métriques qu’un portable emprunté. MACCOME fournit nœuds bare metal et loyers flexibles : voir tarifs publics et centre d’aide sur canaux et accès.
Pilote : une semaine d’onboard+daemon sur un Mac distant dédié, capter le volume de logs et les pics CPU, puis décider de colocaliser le bêta; évitez d’ancrer le Gateway de prod sur une machine de dev dès la semaine 1.
FAQ
Sous WSL2, c’est le même enchaînement que sur macOS ?
Même trame, chemins et réseau diffèrent—préférez triage doctor + WSL2 plutôt qu’assumer la parité launchd.
La liste de Skills est vide après install par où commencer ?
Confirmez le redémarrage du Gateway et la visibilité du workspace, puis lisez triage no-reply avant de sauter en bêta.
Cela heurte l’install Docker ?
Non, mais ne partagez pas le même répertoire de données; choisissez la piste npm ou conteneur par politique. Voir docker-setup + GHCR.