Passer de Claude Code à OpenClaw

Si vos instructions, serveurs MCP et compétences vivent dans Claude Code ou Claude Desktop, OpenClaw peut les importer par un fournisseur de migration intégré. La documentation décrit un outil prudent : il prévisualise chaque élément avant de changer l’état, expurge les secrets dans les plans et les rapports, crée une sauvegarde vérifiée sur le chemin autonome, et sur le chemin de l’assistant de démarrage met l’import en attente et ne le publie qu’après une vérification réussie. Voici comment le lancer, ce qu’il importe, ce qu’il laisse délibérément dans l’archive, et le flux que la documentation recommande.

Deux points d’entrée

• L’assistant de démarrage propose Claude quand il détecte un état local, par le flux d’import ou un chemin de source explicite ; les imports au démarrage exigent une installation OpenClaw neuve, donc une installation existante doit d’abord réinitialiser configuration, identifiants, sessions et espace de travail.
• La commande migrate de la CLI sert aux exécutions scriptées ou répétables : un essai à blanc, puis une application avec l’option yes, éventuellement depuis un dossier Claude Code ou une racine de projet précis.
• Instructions et mémoire : le contenu du CLAUDE.md de projet est copié ou ajouté dans l’AGENTS.md de l’espace de travail, et le fichier au niveau utilisateur dans USER.md.
• Les serveurs MCP viennent du fichier MCP du projet, du fichier d’état de Claude Code et de la configuration de Claude Desktop quand elle existe ; les compétences avec un SKILL.md sont copiées dans le répertoire de compétences de l’espace de travail, et les fichiers Markdown de commandes deviennent des compétences avec l’invocation par le modèle désactivée, parce que les commandes Claude sont déclenchées par l’utilisateur.

OpenClaw refuse d’exécuter les 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 en archive seulement

Les hooks, les permissions et larges listes d’autorisation d’outils, les valeurs d’environnement par défaut, le fichier d’instructions local, le répertoire de règles, les sous-agents Claude, les caches, plans et historiques de projet, et les extensions Claude Desktop et identifiants stockés par le système sont tous copiés dans le rapport de migration pour revue manuelle et jamais chargés dans la configuration vivante. La raison est la citation ci-dessus : OpenClaw ne lancera pas les hooks de quelqu’un d’autre, n’héritera pas d’une liste d’autorisation de permissions et ne décodera pas d’état d’identifiants tout seul, donc ce dont vous avez besoin dans cette liste, vous le déplacez à la main après avoir lu l’archive.

Les sources et le flux

• Sans chemin, OpenClaw inspecte le dossier Claude Code par défaut, le fichier d’état échantillonné et la configuration MCP de Desktop sur macOS ; pointé vers une racine de projet, il n’importe que les fichiers de ce projet et ne lit pas le dossier global.
• Le flux recommandé : prévisualiser le plan, qui liste chaque changement, les conflits, les éléments ignorés et les valeurs expurgées dans les champs env ou headers imbriqués des MCP ; appliquer avec l’option yes, qui crée et vérifie d’abord une sauvegarde ; lancer le docteur ; redémarrer la passerelle et vérifier l’état pour confirmer que les instructions, serveurs MCP et compétences importés sont chargés.
• L’application refuse de continuer quand le plan signale des conflits, un fichier ou une valeur de configuration déjà présent à la cible ; l’option de remplacement est pour quand remplacer est intentionnel, et avant de remplacer une compétence générée depuis une commande, tout son répertoire est sauvegardé et le chemin enregistré dans le rapport.

OpenClaw et Claude Code est l’autre façon dont ces deux outils se rencontrent, Claude Code comme environnement qu’OpenClaw pilote, et Migrer de Hermes vers OpenClaw est l’import jumeau depuis l’autre agent.

Automatisation et dépannage

Les deux commandes prennent une option JSON, et l’option yes est obligatoire hors d’un terminal interactif, donc les scripts prévisualisent avec l’essai à blanc en JSON et appliquent avec JSON et yes. Quand l’état Claude vit ailleurs, passez le chemin ; quand l’assistant de démarrage refuse sur une installation existante, réinitialisez ou utilisez l’application par la CLI ; quand les serveurs MCP de Desktop n’ont pas été importés, pointez vers le répertoire de ce fichier de configuration ; et le comportement des commandes devenues compétences est voulu, l’en-tête de chaque compétence restant modifiable si vous voulez l’invocation automatique. OpenClaw et MCP et Les compétences d’OpenClaw expliquées expliquent où atterrissent les serveurs et compétences importés.

Sur Diali

Sur Diali, les pièces que cet import déplace sont les mêmes que celles que le tableau de bord gère pour un assistant : le personnage et les instructions depuis l’assistant de démarrage, les serveurs MCP depuis la page MCP, les compétences depuis le catalogue. OpenClaw hébergé sur Diali est l’assistant.

• Prévisualiser, sauvegarder, appliquer, docteur.
• Instructions, serveurs MCP et compétences passent ; hooks et permissions non.
• Les commandes deviennent des compétences que le modèle ne peut pas appeler seul.