OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Guide de migration

OpenClaw prend en charge trois parcours de migration : l’importation depuis un autre système d’agents, le déplacement d’une installation existante vers une nouvelle machine et la mise à niveau d’un plugin sur place.

Importer depuis un autre système d’agents

Les fournisseurs de migration intégrés importent dans OpenClaw les instructions, les serveurs MCP, les Skills, la configuration des modèles et, sur acceptation explicite, les clés API. Les plans sont prévisualisés avant toute modification, les secrets sont masqués dans les rapports et l’application s’appuie sur une sauvegarde vérifiée.

Migration depuis Claude

Importez l’état de Claude Code et de Claude Desktop, notamment CLAUDE.md, les serveurs MCP, les Skills et les commandes de projet.
Migration depuis Hermes

Importez la configuration, les fournisseurs, les serveurs MCP, la mémoire, les Skills et les clés .env prises en charge de Hermes.

Le point d’entrée de la CLI est openclaw migrate. L’intégration peut également proposer une migration lorsqu’elle détecte une source connue (openclaw onboard --flow import).

Déplacer OpenClaw vers une nouvelle machine

Copiez le répertoire d’état (~/.openclaw/ par défaut) et votre espace de travail afin de conserver :

  • Configuration — openclaw.json et tous les paramètres du Gateway.
  • Authentification — le fichier auth-profiles.json de chaque agent (clés API et OAuth), ainsi que tout état de canal ou de fournisseur sous credentials/.
  • Sessions — l’historique des conversations et l’état des agents.
  • État des canaux — la connexion WhatsApp, la session Telegram et les éléments similaires.
  • Fichiers de l’espace de travail — MEMORY.md, USER.md, les Skills et les invites.

Étapes de migration

  • Arrêter le Gateway et effectuer une sauvegarde

    Sur l’ancienne machine, arrêtez le Gateway afin que les fichiers ne soient pas modifiés pendant la copie, puis créez une archive :

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Si vous utilisez plusieurs profils (par exemple ~/.openclaw-work), archivez-les séparément.

  • Installer OpenClaw sur la nouvelle machine

    Installez la CLI (et Node si nécessaire) sur la nouvelle machine. Ce n’est pas un problème si l’intégration crée un nouveau répertoire ~/.openclaw/ : vous le remplacerez à l’étape suivante.

  • Copier le répertoire d’état et l’espace de travail

    Transférez l’archive avec scp, rsync -a ou un disque externe, puis extrayez-la :

    bash
    cd ~tar -xzf openclaw-state.tgz

    Vérifiez que les répertoires masqués ont été inclus et que les propriétaires des fichiers correspondent à l’utilisateur qui exécutera le Gateway.

  • Exécuter le diagnostic et vérifier

    Sur la nouvelle machine, exécutez Doctor afin d’appliquer les migrations de configuration et de réparer les services :

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Si Telegram ou Discord utilise la variable d’environnement de secours par défaut (TELEGRAM_BOT_TOKEN ou DISCORD_BOT_TOKEN), vérifiez que le fichier .env du répertoire d’état migré contient ces clés sans afficher les valeurs secrètes :

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor affiche également un avertissement lorsqu’un compte Telegram ou Discord par défaut activé ne dispose d’aucun jeton configuré et que la variable d’environnement correspondante n’est pas accessible au processus de diagnostic.

    Problèmes courants

    Incohérence de profil ou de répertoire d’état

    Si l’ancien Gateway utilisait --profile ou OPENCLAW_STATE_DIR, contrairement au nouveau, les canaux sembleront déconnectés et les sessions seront vides. Lancez le Gateway avec le même profil ou répertoire d’état que celui que vous avez migré, puis réexécutez openclaw doctor.

    Copie du seul fichier openclaw.json

    Le fichier de configuration seul ne suffit pas. Les profils d’authentification des modèles se trouvent sous agents/<agentId>/agent/auth-profiles.json, tandis que l’état des canaux et des fournisseurs se trouve sous credentials/. Migrez toujours l’intégralité du répertoire d’état.

    Autorisations et propriété

    Si vous avez effectué la copie en tant que superutilisateur ou changé d’utilisateur, le Gateway risque de ne pas pouvoir lire les identifiants. Assurez-vous que le répertoire d’état et l’espace de travail appartiennent à l’utilisateur qui exécute le Gateway.

    Mode distant

    Si votre interface utilisateur pointe vers un Gateway distant, l’hôte distant détient les sessions et l’espace de travail. Migrez l’hôte du Gateway lui-même, et non votre ordinateur portable local. Consultez la FAQ.

    Secrets dans les sauvegardes

    Le répertoire d’état contient les profils d’authentification, les identifiants des canaux et d’autres états de fournisseurs. Stockez les sauvegardes sous forme chiffrée, évitez les canaux de transfert non sécurisés et renouvelez les clés si vous soupçonnez une exposition.

    Liste de vérification

    Sur la nouvelle machine, vérifiez les points suivants :

    • [ ] openclaw status indique que le Gateway est en cours d’exécution.
    • [ ] Les canaux sont toujours connectés (aucun nouvel appairage nécessaire).
    • [ ] Le tableau de bord s’ouvre et affiche les sessions existantes.
    • [ ] Les fichiers de l’espace de travail (mémoire, configurations) sont présents.

    Mettre à niveau un plugin sur place

    Les mises à niveau de plugins sur place conservent le même identifiant de plugin et les mêmes clés de configuration, mais peuvent déplacer l’état stocké sur disque vers la structure actuelle. Les guides de mise à niveau propres aux plugins se trouvent à côté de leurs canaux :

    • Migration de Matrix : limites de récupération de l’état chiffré, comportement des instantanés automatiques et commandes de récupération manuelle.

    Ressources associées

    Was this useful?
    On this page

    On this page