OPENCLAW 2026
FAUX_
UPGRADE_
PID_PREUVE.

Baies serveurs et câblage réseau

openclaw update affiche le succès, mais un plugin exige OpenClaw ≥ … ou openclaw status et openclaw gateway status divergent sur la version hôte en cours : c’est une fausse mise à jour (dérive). La couche paquets a bougé, pas le processus Gateway supervisé, ou un rechargement a été interrompu. Matrice symptômes–preuves–actions, runbook en cinq étapes, trois garde-fous, seuils chiffrés, FAQ. Lire aussi : passerelle absente, v2026.5.x production, breaking & doctor, systemd/launchd. Pour un plan de contrôle propre sur Apple Silicon, rejouez la même échelle sur un Mac distant MACGPU.

1. Pourquoi « update OK » ne suffit pas

La CLI et la passerelle publient des faits distincts. npm peut pointer vers un tag récent pendant que launchd exécute encore un ancien openclaw-gateway. Un hot-reload peut échouer à la validation. Plusieurs Node et chemins plist figés créent la dérive ; shell SSH interactif ≠ enfant launchd. Avant d’incriminer les quotas API, verrouillez la version hôte et le PID.

2. Matrice

SymptômeSoupçonPreuve
CLI neuve, gateway status anciennePas de redémarrage propreHorodatage PID, status --all
Erreur requiresSeuil hôte non atteintLigne de version dans les logs
Juste après maintenanceReload avortélaunchctl print
Uniquement Mac distantPATH/plistEnvironmentVariables

3. Cinq étapes

Étape 1 Triade figée

Dans un seul shell : openclaw --version, openclaw status, openclaw gateway status—captures d’écran.

Étape 2 PID→binaire

Mapper le PID vers le fichier réel ; vérifier le nouveau préfixe.

Étape 3 Cycle à froid

Arrêt, port libre, démarrage ; sinon openclaw gateway install --force.

Étape 4 Sonde requires

Plugin avec seuil explicite.

Étape 5 launchd sans session

Unload/Load, répéter l’étape 1 sans utilisateur connecté.

openclaw --version openclaw status || true openclaw status --all || true openclaw gateway status || true openclaw logs --since 45m || true

4. Trois garde-fous

Pas de bascule production tant que status et gateway status divergent. Pas de retour canaux si requires reste rouge. Pas de dépendance tunnel portable sans cold start non assisté.

5. Cas

« Update OK, plugin Feishu requires, PID vieux de trois jours. »

Mini Mac distant : mise à jour sous Node 22 nvm, plist vers ancien préfixe ; reload interrompu. Correction : chemin Node absolu unifié, arrêt complet, gateway install --force, relecture à froid sans login. Prouver d’abord le bump hôte, puis ouvrir les couches v2026.5.x.

6. Regard industrie & création

Les trains hebdomadaires exigent des pipelines qui vérifient build hôte réel et cycle de vie PID. macOS/Metal simplifient souvent l’observabilité des workflows créatifs proches du navigateur. Un Mac distant MACGPU sert de gabarit doré reproductible.

Windows/Linux restent possibles, mais la surface de variables augmente avec les outils graphiques ; validez d’abord sur Apple Silicon, puis élargissez.

7. Seuils

Attente >180 s après arrêt : revue d’architecture. >deux gateway install --force : diff manuel. Écart requires ≥2 patchs avec trafic : incident. Triade incohérente après cold start : pas de trafic.

8. FAQ

Doctor tout vert, on saute PID ? Non. token_mismatch ? Auth vs version. Reload aborted ? Cold cycle d’abord.