Aller au contenu
Guides

OpenClaw et Claude Code

Ce que la migration importe, ce qui reste archivé, et comment les deux s’emboîtent

5 min de lecture

Les gens qui arrivent à OpenClaw depuis Claude Code veulent en général deux choses : garder ce qu’ils y ont construit, et savoir si les deux outils se concurrencent ou se complètent. La documentation répond à la première par un fournisseur de migration embarqué qui lit l’état Claude local, prévisualise chaque élément avant de toucher à quoi que ce soit, et masque les secrets dans le plan et le rapport. La seconde réponse est plus simple : OpenClaw est une passerelle avec des canaux et un agent toujours actif, Claude Code est un outil de codage en terminal, et la migration existe parce que la même personne a souvent les deux. Voici ce qui se déplace, ce qui ne se déplace pas, et l’ordre que recommande la documentation.

Deux façons de la lancer

  • L’assistant de démarrage propose Claude quand il détecte un état Claude local, ou vous lui indiquez explicitement un répertoire source ; les imports au démarrage exigent une installation OpenClaw neuve, donc réinitialisez d’abord la configuration, les identifiants, les sessions et l’espace de travail si vous avez déjà un état.
  • La commande de migration, pour des exécutions scriptées ou répétables : un essai à blanc d’abord, puis l’application avec une confirmation, et une option de source quand il s’agit d’un dossier Claude Code ou d’une racine de projet précise.
  • Sans source, OpenClaw inspecte le dossier Claude Code par défaut, son fichier d’état et la configuration MCP de Claude Desktop sur macOS ; avec une racine de projet, il ne lit que les fichiers de ce projet et jamais votre dossier global.

Ce qui est importé

Instructions et mémoire : un CLAUDE.md de projet est copié ou ajouté dans l’AGENTS.md de l’espace de travail, et celui de l’utilisateur dans USER.md. Serveurs MCP : les définitions du fichier mcp du projet, du fichier d’état de Claude Code et de la configuration de Claude Desktop. Compétences et commandes : les compétences dotées d’un SKILL.md sont copiées dans le répertoire des compétences de l’espace de travail, et les fichiers Markdown de commandes deviennent des compétences OpenClaw que le modèle ne peut pas invoquer de lui-même.

OpenClaw refuse d’exécuter des hooks, de faire confiance aux listes d’autorisation de permissions, ou de décoder automatiquement l’état opaque des identifiants OAuth et Desktop.

Ce qui reste archivé

  • Les hooks Claude, les permissions et les larges listes d’autorisation d’outils, et les valeurs d’environnement par défaut.
  • Le fichier local CLAUDE.local.md et le répertoire des règles.
  • Les sous-agents Claude, les caches, les plans et l’historique des projets.
  • Les extensions de Claude Desktop et les identifiants stockés par le système d’exploitation.

Ceux-là sont copiés dans le rapport de migration pour relecture manuelle et jamais chargés dans la configuration active ; la documentation dit de déplacer à la main ce dont vous avez besoin après lecture de l’archive. OpenClaw avec Claude est la question distincte de faire tourner des modèles Claude dans OpenClaw, et Les compétences OpenClaw expliquées explique ce que deviennent les compétences importées.

L’ordre recommandé

Prévisualiser le plan, qui liste les changements, les conflits et les éléments ignorés ; appliquer avec la sauvegarde qu’OpenClaw crée et vérifie d’abord ; lancer le docteur ; redémarrer la passerelle et vérifier l’état. L’application refuse de continuer quand le plan signale un conflit, et l’option d’écrasement est réservée au cas où remplacer la cible est voulu ; une compétence sur le point d’être écrasée est d’abord sauvegardée et son chemin consigné dans le rapport. OpenClaw et les serveurs MCP couvre ce qu’il advient ensuite des serveurs importés.

Sur Diali

Les assistants Diali démarrent avec un espace de travail, si bien que la partie utile d’une migration Claude est le texte : vos instructions, vos compétences et les serveurs MCP auxquels vous faites confiance, que vous apportez dans le tableau de bord plutôt que par un import en terminal. OpenClaw hébergé sur Diali est l’assistant.

  • Prévisualiser d’abord ; les secrets sont masqués dans le plan et le rapport.
  • Instructions, serveurs MCP, compétences et commandes se déplacent ; hooks et permissions, non.
  • Docteur, redémarrage, état : les trois mêmes étapes que pour tout autre changement.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.