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

Maintenance

Migration depuis Claude

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.

Deux méthodes d’importation

Assistant d’intégration

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

bash
openclaw onboard --flow import

Vous pouvez également indiquer une source précise :

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

Utilisez openclaw migrate pour les exécutions scriptées ou reproductibles. Consultez openclaw migrate pour la référence complète.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Ajoutez --from <path> pour importer un répertoire personnel Claude Code ou une racine de projet spécifique.

Éléments importés

Instructions et mémoire
  • 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.
Serveurs MCP

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.

Skills et commandes
  • 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

  • Afficher un aperçu du plan

    bash
    openclaw migrate claude --dry-run

    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.

  • Appliquer avec une sauvegarde

    bash
    openclaw migrate apply claude --yes

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

  • Exécuter le diagnostic

    bash
    openclaw doctor

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

  • Redémarrer et vérifier

    bash
    openclaw gateway restartopenclaw status

    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.

    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

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

    --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

    L’état Claude se trouve en dehors de ~/.claude

    Transmettez --from /actual/path avec la CLI ou --import-source /actual/path lors de l’intégration.

    L’intégration refuse l’importation dans une configuration existante

    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.

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

    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.

    Les commandes Claude ont été converties en Skills avec l’invocation par le modèle désactivée

    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

    Was this useful?
    On this page

    On this page