OpenClaw 2.0 : migrer sans casser

En bref

• « OpenClaw 2.0 » désigne la version 2026.8.1, publiée le 31 août 2026. Ce n'est plus la dernière : au 24 octobre 2026, la version stable est la 2026.10.7.
• Deux changements incompatibles sont à traiter en passant à la 2.0 ou au-delà : le plugin OpenProse et la commande /prose sont supprimés, et les références de modèles codex/* et openai-codex/* se migrent avec openclaw doctor --fix.
• Depuis la 2026.10.6 (22 octobre), OpenClaw exige un Node corrigé : 24.22.1 ou plus, ou 26.12.1 ou plus. C'est la première chose à vérifier avant toute mise à jour.

Billet rédigé le 24 octobre 2026 à partir du README et des pages de version du dépôt openclaw/openclaw. Ce qu'est OpenClaw, son architecture et son modèle de sécurité sont décrits dans le guide OpenClaw ; ce billet traite de la mise à jour vers la 2.0 et ses suites, avec une checklist de migration. Waimia n'a pas effectué cette migration : les étapes viennent des notes de version, et nos recommandations sont signalées comme telles. Quand une procédure n'est pas décrite dans les sources lues, nous écrivons « voir la documentation du projet ».

OpenClaw 2.0, c'est quelle version ?

OpenClaw numérote ses versions par date (CalVer : année, mois, numéro d'ordre). « OpenClaw 2.0 » est le nom donné à la version 2026.8.1, publiée le 31 août 2026 ; la presse l'a annoncée dès le 30. Le projet a continué à publier depuis.

Conséquence pratique : « passer à OpenClaw 2.0 » aujourd'hui, c'est passer à la dernière version stable, en traversant les changements de la 2.0 puis l'exigence Node de la 2026.10.6. Des versions bêta circulent aussi : pas en production.

Ce que la 2.0 a changé

D'après la page de version de la 2026.8.1, lue le 24 octobre 2026 :

• Des demandes d'identifiants masquées. L'agent peut demander un mot de passe ou une clé sans que la valeur passe dans la conversation ni dans le contexte du modèle. Après la migration, c'est la voie à privilégier pour tout secret (recommandation Waimia).
• Les plugins de source quelconque exigent --force. Installer un plugin exécutable depuis une source arbitraire demande désormais cette option ; les sources de confiance (ClawHub, plugins intégrés, catalogue officiel) gardent la demande de consentement aux capacités du plugin. Un script d'installation interne qui ajoutait un tel plugin sans option est donc à revoir.
• Un accès aux fichiers ancré à l'espace de travail. En accès restreint, l'agent reste dans l'espace de travail de la session. Lecture Waimia : un usage qui allait chercher des fichiers ailleurs peut cesser de fonctionner, et c'est voulu.
• Des sessions déplaçables. Une session peut passer sur un appareil appairé ou sur un worker cloud, avec son espace de travail. Les données de cet espace quittent alors la machine hôte.

Selon la presse (infoq.com, therundown.ai, decrypt.co, cybersecuritynews.com), la 2.0 apporte aussi un installateur qui détecte un accès ChatGPT ou Claude existant, une application navigateur refaite et des sessions cloud partagées pour que des collègues suivent et reprennent un travail ; le projet revendique 933 contributeurs et plus de 16 000 demandes de fusion. Un article signale que la session partagée n'a ni frontière réseau ni frontière de fichiers. Ces points ne figurent pas dans les sources primaires que nous avons lues : à vérifier auprès du projet avant de s'y fier.

Les deux changements incompatibles

OpenProse et /prose supprimés

Le plugin OpenProse et la commande /prose n'existent plus. Avant de migrer, cherchez où vous les utilisez : consignes, habitudes de l'équipe, documentation interne, tâches récurrentes. Nous n'avons pas trouvé de remplaçant décrit dans les sources lues : voir la documentation du projet, et prévoyez de réécrire ces usages.

Références de modèles codex/* et openai-codex/*

Les références de modèles qui commencent par codex/ ou openai-codex/ doivent être migrées. La commande prévue est openclaw doctor --fix. Recommandation Waimia : lancez-la d'abord sur une copie de test, relisez ce qu'elle a modifié, puis rejouez-la sur l'installation qui travaille.

Le Node exigé depuis la 2026.10.6

OpenClaw tourne sur Node.js. Depuis la 2026.10.6 du 22 octobre 2026, il exige un runtime corrigé : Node 24.22.1 ou plus, ou Node 26.12.1 ou plus. Le README indiquait encore 24.16 ou 26.1 à la même date : retenez l'exigence la plus récente, celle de la page de version. La commande standard node --version affiche la version installée sur la machine. Mettez Node à jour avant OpenClaw, pas après.

Avant de migrer : trois préparatifs

Recommandations Waimia.

• Une copie de test. Une seconde machine, ou une machine virtuelle, qui reproduit l'installation : même version, même configuration, sans les vrais comptes de messagerie. Toute la checklist se joue d'abord là.
• Une sauvegarde complète. D'après le README, l'état, la mémoire et les identifiants restent sur votre matériel : c'est donc à vous de les sauvegarder. Où ils se trouvent exactement et comment les restaurer : voir la documentation du projet.
• Un inventaire. Les canaux ouverts, les plugins installés et leur provenance, les modèles référencés, les usages de /prose. Sans cet inventaire, impossible de savoir ce que la migration a cassé.

Checklist de migration, étape par étape

Ordre recommandé par Waimia. Chaque commande citée vient du README ou des pages de version ; quand la source ne donne pas la procédure, nous le disons.

1. Lire les notes de chaque version entre la vôtre et la 2026.10.7, sur la page des versions du dépôt, et relever tout ce qui est marqué comme incompatible.
2. Sauvegarder l'installation qui travaille : état, mémoire, identifiants, configuration.
3. Mettre Node à jour sur la copie de test : 24.22.1 ou plus, ou 26.12.1 ou plus.
4. Installer la version stable 2026.10.7 sur la copie, jamais une bêta. La commande de mise à jour d'une installation existante : voir la documentation du projet. Pour une installation neuve, le README donne openclaw onboard --install-daemon.
5. Lancer openclaw doctor --fix et relire ce qui a changé dans les références de modèles.
6. Réécrire les usages de /prose repérés dans l'inventaire.
7. Revoir les plugins. Ceux qui demandent désormais --force viennent d'une source hors du circuit de confiance : relisez-les ou retirez-les avant de forcer quoi que ce soit.
8. Passer les secrets en saisie masquée là où c'est possible, plutôt que de les coller dans la conversation.
9. Vérifier le service avec openclaw gateway status, puis ouvrir le tableau de bord avec openclaw dashboard.
10. Lancer openclaw security audit et traiter chaque alerte avant d'aller plus loin.
11. Laisser de côté les sessions déplaçables et partagées tant que leurs frontières ne sont pas vérifiées pour votre usage.
12. Rejouer la séquence sur l'installation qui travaille, en gardant la sauvegarde de l'étape 2 jusqu'à ce que l'agent ait tourné normalement quelques jours.

Le durcissement complet, au-delà de la migration (bac à sable, appairage, Gateway), fait l'objet d'un billet à part : sécuriser OpenClaw en 12 contrôles.

La première semaine après la migration

Recommandations Waimia. Une migration réussie le jour J peut montrer ses effets plus tard. Pendant la première semaine, relisez chaque jour ce que l'agent a fait (messages envoyés, tâches lancées) : une tâche récurrente qui s'appuyait sur /prose ou sur un fichier hors de l'espace de travail échouera à sa prochaine exécution, pas pendant le test. Vérifiez que les expéditeurs appairés sont toujours ceux que vous attendez. Relancez openclaw security audit en fin de semaine. Enfin, notez la version en place et la date de la prochaine relecture des notes : au rythme d'octobre (2026.10.6 puis 2026.10.7 à deux jours d'écart), la suivante ne tardera pas.

Ce que les sources lues ne disent pas

Trois questions restent ouvertes après lecture du README et des pages de version : la procédure de retour arrière si une mise à jour échoue, le remplaçant éventuel d'OpenProse, et l'emplacement exact des données à sauvegarder. Sur ces points, voir la documentation du projet, et ne supposez rien : une migration se prépare sur ce qui est écrit, pas sur ce qui semble logique.

Et si vous changiez de moteur ?

Une migration lourde est aussi le moment de reposer la question du moteur. Hermes Agent, de Nous Research, annonce depuis sa v0.22.5 (notes du 22 octobre 2026) une migration depuis OpenClaw et une commande hermes import-agent ; les sources lues ne disent pas ce qui est repris. Les deux moteurs sont comparés critère par critère dans Hermes Agent ou OpenClaw, et le tutoriel installer Hermes Agent pas à pas montre ce qu'un premier essai demande. Pour la question plus large (agent ouvert, agent d'éditeur ou agent sur mesure), voir agent IA toujours actif : propriétaire ou open source.

Et après ?

• Revoir les bases : le guide OpenClaw, avec le modèle de confiance, le coût et le RGPD.
• Confier la migration : notre intégration d'OpenClaw prend en charge la copie de test, la mise à jour, openclaw doctor --fix et l'audit de sécurité, dans le cadre de nos agents IA open source : un sprint de cadrage de 10 heures à 999 € HT, puis 99 € HT de l'heure.
• En parler : réserver l'audit gratuit. Audit gratuit de 45 minutes en visio. Vous repartez avec une cartographie écrite et un ou deux chantiers classés (déroulé de l'audit).