2026 OpenClaw sur Mac Mini loué : mise à jour npm vers @openclaw/cli@latest, seuils Node, statut passerelle, doctor et rollback reproductible

Trois frictions qui cassent les upgrades distants

1. PATH et utilisateur launchd. Un npm interactif voit une autre arborescence que l’agent graphique qui porte la passerelle ; le binaire glisse sans message clair.
2. Moteur Node en retard. Les notes de version durcissent engines ; openclaw doctor doit être votre portillon avant toute interruption.
3. Absence de contrat runtime. Sans journal openclaw status horodaté, on confond régression fonctionnelle et simple perte de certificat ou de listener après reboot.

Matrice décision : que figer à chaque phase

Sur une flotte de plusieurs Minis, le « rolling » ne signifie pas magie réseau : c’est le même gabarit de ticket, déclenché avec des créneaux décalés, des journaux status homogènes et une politique de communication vers les équipes métier qui consomment la passerelle.

HowTo : séquence reproductible (un nœud RunMini)

Le paquet supporté côté registre npm est @openclaw/cli ; lorsqu’une équipe dit « passer sur openclaw@latest », elle désigne en pratique ce tag appliqué au CLI global. Commande canonique :

npm install -g @openclaw/cli@latest
openclaw --version

Avant toute transaction, consignez dans un fichier texte versionné : node -v, npm -v, npm list -g @openclaw/cli --depth=0, le chemin absolu renvoyé par which openclaw et le bloc ProgramArguments actif. Exécutez openclaw doctor puis openclaw status en redirigeant vers des journaux horodatés ; corrigez jetons expirés ou permissions TLS tant que la passerelle tourne encore.

1. Annoncer la fenêtre et suspendre automatisations qui ouvriraient de nouvelles sessions.
2. Arrêter launchd avec le label documenté (launchctl bootout gui/$(id -u) …) pour vider stderr proprement.
3. Installer @openclaw/cli@latest avec l’utilisateur qui possède le préfixe global référencé par le plist.
4. Recharger l’agent, attendre port d’écoute ou URL de santé, puis relancer doctor et status.
5. Valider métier via un déclencheur réel : enchaînez avec le guide cron et watchdog 7×24 pour prouver qu’un minuteur critique refire.
6. Rollback : en cas de divergence, bootout, npm install -g @openclaw/cli@<semver_checkpoint>, restauration plist si besoin, bootstrap puis nouvelle paire de journaux.

Repères citables : conserver au moins deux cycles de sondes avant clôture du ticket ; journaliser stderr complet lors du premier bootout ; vérifier que ThrottleInterval du plist évite les boucles serrées sur build défectueuse.

FAQ opérateur

Puis-je tout faire dans tmux SSH sans launchd ?

Utilisez SSH pour npm et la lecture des journaux, mais laissez launchd superviser la passerelle 7×24 ; sinon une coupure client ressemble à une régression OpenClaw.

doctor reste vert alors que status manque des listeners ?

Priorisez status pour le câblage runtime : variables d’environnement plist, chemin binaire post-npm, profils pare-feu macOS après upgrade Node.

Comment tester @latest sans parier la production ?

Isolez un préfixe secondaire ou invoquez npx @openclaw/cli@latest dans un répertoire jetable avec clé API de préproduction avant de promouvoir le semver global.

Que faire si le plist pointe encore vers un wrapper obsolète ?

Après chaque npm global, revalidez le chemin absolu du binaire, mettez à jour ProgramArguments si votre stratégie impose un shim, puis rechargez l’agent ; sinon vous exécutez silencieusement l’ancienne couche alors que le registre affiche déjà le nouveau tag.

Combien de temps attendre avant de clôturer le changement ?

Attendez au moins un intervalle complet de sondes plus un cycle de chaque planificateur critique : ainsi webhooks, Skills et crons passent une fois sous la nouvelle build avec journaux propres.

Synthèse

Figez l’état, validez Node et doctor, archivez status, exécutez drain → arrêt → npm → bootstrap, puis gardez le semver précédent à portée de commande. Cette routine tient sur un Mac Mini loué RunMini comme sur une machine détenue, avec la flexibilité contractuelle en plus. Documentez enfin la fenêtre horaire UTC et locale utilisée : elle évite les malentendus lorsque l’équipe relit les journaux depuis un fuseau différent.