OPENCLAW 2026
FAUX_
UPGRADE_
PID_PREUVE.
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ôme | Soupçon | Preuve |
|---|---|---|
| CLI neuve, gateway status ancienne | Pas de redémarrage propre | Horodatage PID, status --all |
| Erreur requires | Seuil hôte non atteint | Ligne de version dans les logs |
| Juste après maintenance | Reload avorté | launchctl print |
| Uniquement Mac distant | PATH/plist | EnvironmentVariables |
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é.
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.