OpenClaw 2026.9.1 Migration : Notes de mise à niveau des systèmes multi-agents hérités provenant de r/openclaw

Mettre à niveau OpenClaw entre les versions majeures peut sembler intimidant, mais un post récent sur r/openclaw montre une configuration multi-agents existante passant de 2026.7.1-2 à 2026.9.1 sans drame majeur — surtout quand on laisse un agent de codage IA gérer les étapes.

La configuration existante

La migration a commencé à partir de cette configuration :

• Installation npm globale d'OpenClaw
• Version 2026.7.1-2
• Service de passerelle systemd utilisateur
• Plusieurs agents configurés avec des espaces de travail spécifiques aux agents
• Canal WhatsApp avec routage spécifique aux groupes
• Profils de navigateur et plusieurs plugins gérés

Problèmes trouvés

Ce n'est qu'après la mise à niveau que vous voyez vraiment ce qui a changé. Les problèmes identifiés incluaient :

• Plusieurs clés de configuration héritées rejetées par 2026.9.1
• La propriété multi-agents nécessitait une déclaration explicite
• La base de données SQLite partagée nécessitait des migrations de schéma
• L'état de configuration de l'espace de travail hérité devait être migré
• Plusieurs plugins officiels étaient encore sur l'ancienne version
• WhatsApp n'avait pas d'agent de secours pour les messages non correspondants
• Le proxy inverse de l'interface Web nécessitait une attribution fiable du client transmis
• La définition de service avait des métadonnées obsolètes ou non standard

Ce qui a réparé

La mise à niveau a été déléguée à Codex (via l'extension VS Code, connectée à distance à la machine OpenClaw). Le processus complet a pris environ 30 minutes. Principales étapes du résumé généré :

• Création d'une sauvegarde de restauration datée de la configuration, des secrets, des fichiers de service, des métadonnées de package et de l'état du runtime.
• Mise à jour d'OpenClaw vers 2026.9.1 à l'aide du programme de mise à jour intégré.
• Migration de la configuration en supprimant les clés retirées et en convertissant les paramètres de délai d'attente pris en charge.
• Définition de la propriété multi-agents sur explicite.
• Exécution de Doctor avec la politique de réparation de service externe pour permettre la migration de l'état SQLite, de l'espace de travail, de l'appareil et des plugins.
• Rafraîchi la définition du service de passerelle systemd.
• Mis à jour les plugins officiels vers 2026.9.1.
• Défini main comme propriétaire de battement de cœur par défaut et agent de routage WhatsApp non correspondant.
• Ajouté une entrée de proxy de confiance étroitement limitée pour le proxy inverse local.

Résultat et leçon

Après la migration, la passerelle exécute 2026.9.1, la configuration valide, le service est actif, le listener HTTP/RPC local répond, WhatsApp signale qu'il écoute les messages entrants, et le traitement des battements de cœur démarre normalement.

La leçon principale : pour un grand saut de version, sauvegardez d'abord, attendez-vous à des migrations de schéma et d'état, et vérifiez à la fois la propriété de la passerelle et le routage multi-agents.