Aller au contenu
OpenClaw Docs

Migration depuis Claude

OpenClaw importe l’état local de Claude via le provider de migration Claude intégré. Le provider prévisualise chaque élément avant de modifier l’état, masque les secrets dans les plans et rapports, et crée une sauvegarde vérifiée avant l’application.

Deux méthodes d’import

Section intitulée « Deux méthodes d’import »

L’assistant propose Claude lorsqu’il détecte un état local de Claude.

Fenêtre de terminal
openclaw onboard --flow import

Ou pointez vers une source spécifique :

Fenêtre de terminal
openclaw onboard --import-from claude --import-source ~/.claude

Ce qui est importé

Section intitulée « Ce qui est importé »
Instructions and memory
  • Le contenu du projet CLAUDE.md et .claude/CLAUDE.md est copié ou ajouté à l’espace de travail de l’agent OpenClaw AGENTS.md.
  • Le contenu ~/.claude/CLAUDE.md de l’utilisateur est ajouté à l’espace de travail USER.md.
Serveurs MCP

Les définitions de serveur MCP sont importées depuis le projet .mcp.json, Claude Code ~/.claude.json, et Claude Desktop claude_desktop_config.json lorsqu’ils sont présents.

Skills and commands
  • Les compétences Claude avec un fichier SKILL.md sont copiées dans le répertoire des compétences de l’espace de travail OpenClaw.
  • Les fichiers Markdown de commandes Claude sous .claude/commands/ ou ~/.claude/commands/ sont convertis en compétences OpenClaw avec disable-model-invocation: true.

Ce qui reste en archive uniquement

Section intitulée « Ce qui reste en archive uniquement »

Le fournisseur copie ces éléments dans le rapport de migration pour examen manuel, mais ne les charge pas dans la configuration active de OpenClaw :

  • Hooks Claude
  • Autorisations et listes d’autorisation d’outils larges Claude
  • Valeurs par défaut de l’environnement Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Sous-agents Claude sous .claude/agents/ ou ~/.claude/agents/
  • Répertoires de cache, de plans et d’historique de projet de Claude Code
  • Extensions Claude Desktop et identifiants stockés par le système d’exploitation

OpenClaw refuse d’exécuter des hooks, de faire confiance aux listes d’autorisation d’outils, ou de décoder automatiquement l’état des identifiants OAuth et Desktop opaques. Déplacez manuellement ce dont vous avez besoin après avoir examiné l’archive.

Sélection de la source

Section intitulée « Sélection de la source »

Sans --from, OpenClaw inspecte le domicile Claude Code par défaut sur ~/.claude, le fichier d’état ~/.claude.json de Claude Code échantillonné, et la configuration MCP de Claude Desktop sur macOS.

Lorsque --from pointe vers une racine de projet, OpenClaw n’importe que 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 domicile Claude global lors d’une importation de racine de projet.

Flux recommandé

Section intitulée « Flux recommandé »

  1. Prévisualiser le plan

    Fenêtre de terminal
    openclaw migrate claude --dry-run

    Le plan répertorie tout ce qui va changer, y compris les conflits, les éléments ignorés et les valeurs sensibles masquées des champs MCP imbriqués env ou headers.

  2. Appliquer avec sauvegarde

    Fenêtre de terminal
    openclaw migrate apply claude --yes

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

  3. Exécuter le docteur

    Fenêtre de terminal
    openclaw doctor

    Le Docteur vérifie les problèmes de configuration ou d’état après l’importation.

  4. Redémarrer et vérifier

    Fenêtre de terminal
    openclaw gateway restart
    openclaw status

    Confirmez que la passerelle est en bonne santé et que vos instructions importées, serveurs MCP et compétences sont chargés.

Gestion des conflits

Section intitulée « Gestion des conflits »

L’application refuse de continuer lorsque le plan signale des conflits (un fichier ou une valeur de configuration existe déjà à la cible).

Pour une nouvelle installation de OpenClaw, les conflits sont inhabituels. Ils apparaissent généralement lorsque vous relancez l’importation sur une configuration qui possède déjà des modifications utilisateur.

Sortie JSON pour l’automatisation

Section intitulée « Sortie JSON pour l’automatisation »
Fenêtre de terminal
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes

Avec --json et sans --yes, l’application affiche le plan et ne modifie pas l’état. C’est le mode le plus sûr pour les scripts CI et partagés.

Dépannage

Section intitulée « Dépannage »
L'état Claude réside en dehors de ~/.claude

Passez --from /actual/path (CLI) ou --import-source /actual/path (onboarding).

L'intégration refuse d'importer sur une configuration existante

Les importations via l’intégration nécessitent une nouvelle configuration. Réinitialisez l’état et relancez l’intégration, ou utilisez openclaw migrate apply claude directement, qui prend en charge --overwrite et le contrôle explicite des sauvegardes.

Les serveurs MCP de Claude Desktop n'ont pas été importés

Claude Desktop lit claude_desktop_config.json à partir d’un chemin spécifique à la plateforme. Pointez --from vers le répertoire de ce fichier si OpenClaw ne l’a pas détecté automatiquement.

Les commandes Claude sont devenues des compétences avec l'invocation du modèle désactivée

Par conception. Les commandes Claude sont déclenchées par l’utilisateur, donc OpenClaw les importe en tant que compétences avec disable-model-invocation: true. Modifiez les métadonnées de chaque compétence si vous souhaitez que l’agent les invoque automatiquement.

Connexes

Section intitulée « Connexes »