Migration Matrix d’OpenClaw

Mettre à niveau une installation Matrix depuis l’ancien plugin public vers l’actuel est un déplacement en place pour la plupart des gens, mais la documentation est précise sur la seule chose qui ne peut pas migrer : l’historique chiffré qui n’a jamais été sauvegardé. Voici ce que la migration fait seule, le déroulé recommandé, les messages que vous pouvez voir et l’échelle de récupération quand les salons chiffrés restent noirs.

Ce qui reste où

• Le plugin reste le même paquet de plugin Matrix, le canal reste matrix et la configuration reste sous channels.matrix, il n’y a donc rien à renommer ; les identifiants en cache passent dans l’état de plugin SQLite partagé tandis que l’état d’exécution reste sous le répertoire Matrix du dossier OpenClaw.
• Le paquet racine openclaw n’embarque plus le code d’exécution Matrix ni les dépendances du SDK : si channels status montre Matrix configuré mais le plugin non installé, lancez doctor --fix ou installez le paquet du plugin Matrix avec plugins install, et n’installez jamais de paquets SDK Matrix dans le paquet racine.
• La migration du doctor importe et vérifie les fichiers d’identifiants retirés sous credentials/matrix avant de les archiver, garde la même sélection de compte et la même configuration, et importe les fichiers annexes (le cache de synchronisation bot-storage, le fichier de clé de récupération, le marqueur de migration crypto héritée et les instantanés IndexedDB) dans l’état SQLite de Matrix, en archivant les fichiers avec un suffixe .migrated.
• Quand le jeton d’accès change plus tard, la migration réutilise la racine de stockage par hachage de jeton la plus complète pour le même compte, serveur, utilisateur et appareil ; l’import des fichiers d’identifiants est réservé au doctor, parce que l’exécution ne lit que l’état d’identifiants SQLite canonique.

Si la sauvegarde se restaure correctement mais que certains anciens salons manquent encore d’historique, ces clés manquantes n’ont probablement jamais été sauvegardées par le plugin précédent.

Antérieur à 2026.4

Les versions jusqu’au train 2026.6 migraient aussi la disposition plate d’origine à magasin unique, le fichier bot-storage plus le répertoire crypto directement sous le répertoire Matrix, et préparaient la récupération de l’état chiffré depuis l’ancien magasin crypto rust. Les versions actuelles ne portent plus cette migration : une installation encore en disposition plate passe d’abord à une version 2026.6, lance doctor --fix, démarre la passerelle une fois pour que le magasin plat et les clés de salon récupérables migrent, et seulement ensuite passe à la dernière version. L’ancien plugin ne créait pas de sauvegardes de clés de salon automatiquement, c’est pourquoi un historique chiffré local jamais sauvegardé peut rester illisible après la mise à niveau quel que soit le chemin.

Le déroulé recommandé

• Mettez à jour OpenClaw et le plugin Matrix normalement, lancez doctor --fix, démarrez ou redémarrez la passerelle, puis vérifiez l’état avec matrix verify status et matrix verify backup status.
• Placez la clé de récupération dans une variable d’environnement propre au compte (MATRIX_RECOVERY_KEY pour un seul compte par défaut, une variable par compte comme MATRIX_RECOVERY_KEY_ASSISTANT avec --account assistant sinon) et passez-la à verify backup restore --recovery-key-stdin quand OpenClaw dit qu’une clé est nécessaire, puis à verify device --recovery-key-stdin si l’appareil est encore non vérifié.
• Si la clé est acceptée et la sauvegarde utilisable mais que la signature croisée affiche encore non, lancez matrix verify self, acceptez la demande dans un autre client Matrix, comparez les emojis ou les décimales et tapez yes seulement s’ils correspondent ; verify backup reset --yes repart d’une base neuve quand vous abandonnez l’historique irrécupérable, et verify bootstrap crée une sauvegarde côté serveur quand il n’en existe aucune.

OpenClaw sur Matrix est l’article de canal auquel cette migration appartient et Le chiffrement Matrix d’OpenClaw explique le modèle de vérification, de sauvegarde et de signature croisée sur lequel ces commandes agissent.

Lire les messages

Une migration échouée du stockage client hérité arrête le démarrage, garde en place les imports SQLite terminés et les fichiers annexes archivés, et laisse les fichiers non archivés disponibles pour une nouvelle tentative une fois la permission ou le conflit corrigé. Un message d’installation par chemin personnalisé signifie que Matrix est épinglé à un chemin, donc les mises à jour principales ne le remplacent pas ; réinstallez depuis le paquet par défaut pour y revenir. Les commandes verify impriment une ligne de problème de sauvegarde avec les étapes suivantes : aucune sauvegarde sur le serveur signifie bootstrap, une clé non chargée sur cet appareil signifie restore avec la clé de récupération, une clé discordante signifie restore avec la clé active du serveur ou reset, une chaîne de signature non fiable signifie vérifier l’appareil puis verify self, et un diagnostic de confiance non concluant signifie le status détaillé. Installer Matrix pour OpenClaw et Comptes et serveurs Matrix d’OpenClaw couvrent le côté installation neuve et la disposition multi-comptes que ces variables nomment.

Sur Diali

Matrix figure dans la liste des canaux connectables de Diali, aux côtés de WhatsApp, Telegram, Discord, Slack, Mattermost, des SMS et de la voix : le compte sur le serveur d’accueil et la liste d’autorisation des salons sont à vous, la passerelle est à nous. OpenClaw hébergé sur Diali est l’assistant hébergé et La sécurité Diali décrit comment l’état, y compris celui des plugins, est conservé sur un volume persistant, avec des instantanés quotidiens et une restauration en un clic grâce à l’option Sauvegardes (incluse avec Max).

• Même plugin, même identifiant de canal, mêmes clés de configuration.
• Les dispositions plates passent par 2026.6 avant la dernière version.
• L’historique jamais sauvegardé reste illisible ; créez une sauvegarde maintenant.