Skip to main content
OpenClaw importe l’état Claude local via le fournisseur de migration Claude intégré. Le fournisseur affiche un aperçu de chaque élément avant de modifier l’état, masque les secrets dans les plans et les rapports, et crée une sauvegarde vérifiée avant l’application.
Les importations lors de l’intégration nécessitent une nouvelle configuration d’OpenClaw. Si vous disposez déjà d’un état OpenClaw local, réinitialisez d’abord la configuration, les identifiants, les sessions et l’espace de travail, ou utilisez directement openclaw migrate avec --overwrite après avoir examiné le plan.

​
Deux méthodes d’importation

L’assistant propose Claude lorsqu’il détecte un état Claude local.
Vous pouvez également indiquer une source précise :

​
Éléments importés

  • Le contenu des fichiers de projet CLAUDE.md et .claude/CLAUDE.md est copié ou ajouté au fichier AGENTS.md de l’espace de travail de l’agent OpenClaw.
  • Le contenu du fichier utilisateur ~/.claude/CLAUDE.md est ajouté au fichier USER.md de l’espace de travail.
Les définitions de serveurs MCP sont importées depuis le fichier de projet .mcp.json, le fichier Claude Code ~/.claude.json et le fichier Claude Desktop claude_desktop_config.json, lorsqu’ils sont présents.
  • Les Skills Claude comportant un fichier SKILL.md sont copiées dans le répertoire des Skills de l’espace de travail OpenClaw.
  • Les fichiers Markdown de commandes Claude situés dans .claude/commands/ ou ~/.claude/commands/ sont convertis en Skills OpenClaw avec disable-model-invocation: true.

​
Éléments conservés uniquement dans l’archive

Le fournisseur copie les éléments suivants dans le rapport de migration afin qu’ils puissent être examinés manuellement, mais ne les charge pas dans la configuration OpenClaw active :
  • Les hooks Claude
  • Les autorisations Claude et les listes étendues d’outils autorisés
  • Les valeurs par défaut de l’environnement Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Les sous-agents Claude situés dans .claude/agents/ ou ~/.claude/agents/
  • Les répertoires de caches, de plans et d’historique des projets Claude Code
  • Les extensions Claude Desktop et les identifiants stockés par le système d’exploitation
OpenClaw refuse d’exécuter automatiquement les hooks, d’accorder sa confiance aux listes d’autorisations ou de décoder l’état opaque des identifiants OAuth et Desktop. Déplacez manuellement ce dont vous avez besoin après avoir examiné l’archive.

​
Sélection de la source

Sans --from, OpenClaw inspecte le répertoire personnel Claude Code par défaut situé dans ~/.claude, le fichier d’état échantillonné de Claude Code ~/.claude.json et la configuration MCP de Claude Desktop sous macOS. Lorsque --from désigne une racine de projet, OpenClaw importe uniquement les fichiers Claude de ce projet, tels que CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ et .mcp.json. Il ne lit pas votre répertoire personnel Claude global lors de l’importation depuis une racine de projet.

​
Procédure recommandée

1

Afficher un aperçu du plan

Le plan répertorie tout ce qui sera modifié, notamment les conflits, les éléments ignorés et les valeurs sensibles masquées dans les champs MCP env ou headers imbriqués.
2

Appliquer avec une sauvegarde

OpenClaw crée et vérifie une sauvegarde avant l’application.
3

Exécuter le diagnostic

Le diagnostic recherche d’éventuels problèmes de configuration ou d’état après l’importation.
4

Redémarrer et vérifier

Vérifiez que le Gateway fonctionne correctement et que vos instructions, serveurs MCP et Skills importés sont chargés.

​
Gestion des conflits

L’application refuse de continuer lorsque le plan signale des conflits, c’est-à-dire lorsqu’un fichier ou une valeur de configuration existe déjà à la destination.
Relancez la commande avec --overwrite uniquement si vous souhaitez remplacer la destination existante. Les fournisseurs peuvent néanmoins créer des sauvegardes individuelles des fichiers remplacés dans le répertoire du rapport de migration.
Les conflits sont inhabituels dans une nouvelle installation d’OpenClaw. Ils apparaissent généralement lorsque vous relancez l’importation dans une configuration qui contient déjà des modifications utilisateur.

​
Sortie JSON pour l’automatisation

--yes est requis pour migrate apply en dehors d’un terminal interactif. Sans cette option, OpenClaw renvoie une erreur au lieu d’effectuer l’application ; les scripts et l’intégration continue doivent donc transmettre explicitement --yes. Affichez d’abord un aperçu avec --dry-run --json, puis appliquez les modifications avec --json --yes une fois le plan vérifié.

​
Résolution des problèmes

Transmettez --from /actual/path avec la CLI ou --import-source /actual/path lors de l’intégration.
Les importations lors de l’intégration nécessitent une nouvelle configuration. Réinitialisez l’état et recommencez l’intégration, ou utilisez directement openclaw migrate apply claude, qui prend en charge --overwrite et le contrôle explicite des sauvegardes.
Claude Desktop lit claude_desktop_config.json depuis un chemin propre à la plateforme. Faites pointer --from vers le répertoire de ce fichier si OpenClaw ne l’a pas détecté automatiquement.
Ce comportement est intentionnel. Les commandes Claude sont déclenchées par l’utilisateur ; OpenClaw les importe donc comme Skills avec disable-model-invocation: true. Modifiez le frontmatter de chaque Skill si vous souhaitez que l’agent les invoque automatiquement.

​
Voir aussi