Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw importe l’état local de Claude 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 imports lors de l’intégration nécessitent une configuration OpenClaw neuve. Si vous avez déjà 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 façons d’importer

L’assistant propose Claude lorsqu’il détecte un état Claude local.
openclaw onboard --flow import
Ou pointez vers une source précise :
openclaw onboard --import-from claude --import-source ~/.claude

​
Ce qui est importé

  • Le contenu du projet CLAUDE.md et de .claude/CLAUDE.md est copié ou ajouté à l’AGENTS.md de l’espace de travail de l’agent OpenClaw.
  • Le contenu utilisateur de ~/.claude/CLAUDE.md est ajouté au USER.md de l’espace de travail.
Les définitions de serveurs MCP sont importées depuis le projet .mcp.json, Claude Code ~/.claude.json et Claude Desktop claude_desktop_config.json lorsqu’elles sont présentes.
  • Les Skills Claude avec 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 sous .claude/commands/ ou ~/.claude/commands/ sont convertis en Skills OpenClaw avec disable-model-invocation: true.

​
Ce qui reste uniquement archivé

Le fournisseur copie ces éléments dans le rapport de migration pour examen manuel, mais ne les charge pas dans la configuration OpenClaw active :
  • Hooks Claude
  • Autorisations Claude et listes d’autorisation larges pour les outils
  • 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 caches, plans et historiques de projet de Claude Code
  • Extensions Claude Desktop et identifiants stockés par le système d’exploitation
OpenClaw refuse d’exécuter automatiquement des hooks, de faire confiance aux listes d’autorisation, 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 dans ~/.claude, le fichier d’état Claude Code échantillonné ~/.claude.json et la configuration MCP de Claude Desktop sur macOS. Lorsque --from pointe vers une racine de projet, OpenClaw importe uniquement les fichiers Claude de ce projet, comme CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ et .mcp.json. Il ne lit pas votre répertoire personnel Claude global pendant un import depuis une racine de projet.

​
Flux recommandé

1

Prévisualiser le plan

openclaw migrate claude --dry-run
Le plan liste tout ce qui changera, y compris les conflits, les éléments ignorés et les valeurs sensibles masquées depuis les champs MCP imbriqués env ou headers.
2

Appliquer avec sauvegarde

openclaw migrate apply claude --yes
OpenClaw crée et vérifie une sauvegarde avant l’application.
3

Exécuter doctor

openclaw doctor
Doctor vérifie les problèmes de configuration ou d’état après l’import.
4

Redémarrer et vérifier

openclaw gateway restart
openclaw status
Confirmez que le Gateway est sain 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 (un fichier ou une valeur de configuration existe déjà à la cible).
Relancez avec --overwrite uniquement lorsque le remplacement de la cible existante est intentionnel. Les fournisseurs peuvent encore écrire des sauvegardes par élément pour les fichiers écrasés dans le répertoire du rapport de migration.
Pour une installation OpenClaw neuve, les conflits sont inhabituels. Ils apparaissent généralement lorsque vous relancez l’import sur une configuration qui comporte déjà des modifications utilisateur.

​
Sortie JSON pour l’automatisation

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 la CI et les scripts partagés.

​
Dépannage

Passez --from /actual/path (CLI) ou --import-source /actual/path (intégration).
Les imports lors de l’intégration nécessitent une configuration neuve. 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. Pointez --from vers le répertoire de ce fichier si OpenClaw ne l’a pas détecté automatiquement.
C’est intentionnel. Les commandes Claude sont déclenchées par l’utilisateur, donc OpenClaw les importe comme Skills avec disable-model-invocation: true. Modifiez le frontmatter de chaque Skill si vous voulez que l’agent les invoque automatiquement.

​
Connexe