Liste de contrôle pour la mise à niveau vers OpenClaw 3.22 : Étapes pratiques d'un développeur qui s'est brûlé les doigts

Avant de mettre à jour vers OpenClaw 3.22

Vérifiez votre fichier .env pour toutes les variables préfixées par CLAWDBOT_ ou MOLTBOT_. La version 3.22 a supprimé toutes ces variables sans solution de repli ni compatibilité. Si vous en avez, votre agent ne démarrera pas et le message d'erreur ne sera pas utile. Renommez d'abord tout en OPENCLAW_. Si vous avez configuré OpenClaw avant mi-février, vous en avez presque certainement au moins une.

Exécutez openclaw backup create avant de toucher à quoi que ce soit. Pensez à étiqueter votre image Docker actuelle comme :pre-upgrade pour pouvoir revenir en arrière instantanément si nécessaire.

Après la mise à jour vers OpenClaw 3.22

Exécutez openclaw doctor --fix qui détecte automatiquement la plupart des migrations de configuration.

Vérifiez /tools dans n'importe quel canal pour voir quels outils sont réellement disponibles. La version 3.22 a modifié la surface du SDK des plugins (passage de openclaw/extension-api à openclaw/plugin-sdk/*), donc les plugins tiers utilisant les anciens chemins d'importation ne se chargeront tout simplement pas en silence.

Exécutez openclaw secrets audit pour trouver les clés API en texte clair dans votre espace de travail. Le développeur en a trouvé deux qui étaient complètement oubliées, assises dans des fichiers de configuration de compétences.

Nouvelles fonctionnalités dans la version 3.22

• Conversations latérales /btw
• Installation native de ClawHub depuis la CLI (openclaw skills install au lieu de télécharger manuellement les fichiers skill.md)
• Nettoyage des sessions mortes
• Réduction progressive des nouvelles tentatives Cron pour qu'un travail en échec ne draine pas votre budget API pendant la nuit
• Délai d'expiration de l'agent de 48 heures au lieu de 10 minutes, ce qui signifie que les tâches longues se terminent maintenant réellement

Le développeur recommande de prévoir 30 à 45 minutes pour une mise à niveau minutieuse au lieu de supposer qu'elle se passera sans accroc, notant qu'une fois terminée, "c'est vraiment mieux".