Claude Code / Hermes → OpenClaw 2026 : Guide complet de migration avec openclaw migrate sur Mac mini M4

Sorti le 28 avril 2026, OpenClaw v2026.4.26 intègre une fonctionnalité très attendue : openclaw migrate — une commande qui importe en masse la configuration de votre agent de codage IA depuis Claude Code ou Hermes vers OpenClaw. Si vous avez investi dans des connexions MCP, des compétences personnalisées et des ajustements de workflow dans Claude Code ou Hermes, vous pouvez maintenant migrer vers OpenClaw sans recréer manuellement chaque paramètre. Ce guide couvre l'intégralité du processus sur un nœud Mac mini M4 VpsGona — ce qui est migré automatiquement, ce qui requiert une intervention manuelle, et comment corriger les 6 erreurs post-migration les plus courantes.

Pourquoi les développeurs quittent Claude Code et Hermes pour OpenClaw en 2026

La tendance s'est accélérée depuis début 2026. Les raisons tiennent à des lacunes produit concrètes, pas au marketing. Les comprendre vous aide à décider si la migration correspond à votre workflow.

Raison 1 : Orchestration multi-agents native sans hacks de plugins. Le support multi-agents de Claude Code nécessite des contournements et se limite au routage de modèles hébergés par Anthropic. Le framework multi-agents natif d'OpenClaw (ClawHub) orchestre des processus agents indépendants partageant une couche d'état Memory-Wiki, avec n'importe quel fournisseur de modèles.

Raison 2 : L'observabilité OTEL d'OpenClaw est de niveau production. Depuis v2026.4.25, OpenClaw émet de la télémétrie structurée pour chaque appel de modèle, chaque appel d'outil et chaque accès mémoire. Claude Code et Hermes n'offrent pas d'observabilité structurée équivalente. Les équipes ayant besoin d'attribution des coûts en tokens, de détection de boucles d'outils et d'alertes de pression mémoire — en particulier pour les agents autonomes nocturnes — ne trouveront pas l'équivalent ailleurs.

Raison 3 : Neutralité fournisseur et support Cerebras intégré. OpenClaw v2026.4.26 ajoute Cerebras comme fournisseur intégré, rejoignant OpenAI, Anthropic, Gemini, DeepSeek et les modèles Ollama locaux. Claude Code est structurellement lié à l'API Anthropic. Hermes offre de la flexibilité fournisseur, mais son SDK de plugins n'atteint pas la maturité d'OpenClaw v2026.

Ce que fait réellement openclaw migrate dans v2026.4.26

La commande openclaw migrate effectue un scan structuré du répertoire de configuration de l'outil source, extrait les configurations compatibles, les convertit au format de configuration OpenClaw et les écrit. Elle ne copie pas l'historique des conversations ni les logs de session — seules la configuration, les définitions de fonctions et les métadonnées de connexion sont migrées.

Le processus de migration se déroule en trois phases :

1. Phase de découverte : OpenClaw scanne le répertoire de configuration source (~/.claude/ pour Claude Code, ~/.hermes/ pour Hermes) pour détecter les serveurs MCP installés, les compétences/outils personnalisés, les références de clés API et la configuration des fournisseurs.
2. Phase de conversion : Chaque élément détecté est mappé vers son équivalent OpenClaw. Les définitions de serveurs MCP sont réexprimées dans le format manifeste de plugin OpenClaw, les noms de variables d'environnement des clés API sont aliasés, et les définitions d'outils personnalisés sont encapsulées dans le schéma de compétences OpenClaw.
3. Phase de rapport : Un rapport de migration JSON est écrit dans ~/.openclaw/migrate-report.json, listant chaque élément migré avec succès, chaque élément partiellement migré (nécessitant une complétion manuelle) et chaque élément non migrable.

Élément de configuration	Migration depuis Claude Code	Migration depuis Hermes	Notes
Définitions d'endpoints MCP	✓ Automatique	✓ Automatique	URI de connexion et en-têtes d'auth préservés
Définitions de compétences/outils	✓ Automatique	✓ Automatique	Encapsulé dans schéma compétence OpenClaw ; tester après migration
Références variables d'env de clés API	✓ Alias automatique	✓ Alias automatique	Valeurs de clés non lues ; alias créés dans .env
Personnalisations de prompt système	⚠ Partiel (vérif. requise)	⚠ Partiel (vérif. requise)	Format des ID opérateur diffère entre outils
Configuration des fournisseurs de modèles	⚠ Partiel (Anthropic seul)	✓ Auto (multi-fournisseur)	Fournisseurs non-Anthropic de Claude Code non migrés
Contenu mémoire/base de connaissances	✗ Non migré	✗ Non migré	Réingestion manuelle dans Memory-Wiki OpenClaw
Historique de conversations/sessions	✗ Non migré	✗ Non migré	Par conception — format de session OpenClaw incompatible
Définitions TaskFlow/Webhook	✗ S/O (absent de Claude Code)	⚠ Partiel	Workflows Hermes nécessitent mappage manuel vers TaskFlows

Liste de vérification pré-migration : 7 points à vérifier avant d'exécuter la commande

Exécuter openclaw migrate sans préparation est la cause de la plupart des problèmes post-migration. Vérifiez les 7 points suivants avant d'exécuter la commande de migration.

1. Confirmer que la version d'OpenClaw est ≥ 2026.4.26. La sous-commande migrate n'existe pas dans les versions antérieures. Vérifiez avec openclaw --version et mettez à jour avec npx openclaw@latest update ou /update dans l'agent.
2. Sauvegarder le répertoire de configuration de l'outil source. Exécutez cp -r ~/.claude/ ~/claude-backup-$(date +%Y%m%d)/ (Claude Code) ou l'équivalent pour Hermes. La commande de migration est en lecture seule, mais une sauvegarde datée rassure en cas de problème.
3. Lister les serveurs MCP actifs. Exécutez /mcp dans Claude Code et notez les noms et types de connexion des serveurs MCP connectés. Vous utiliserez cette liste pour vérifier la couverture dans le rapport de migration.
4. Documenter les personnalisations de prompt système. Si vous avez modifié des ID opérateur, instructions de persona ou contournements de sécurité, copiez-les dans un fichier texte. Ce sont les éléments les plus susceptibles de nécessiter une vérification manuelle après migration.
5. Vérifier Node.js ≥ 20 sur le nœud Mac mini M4. migrate utilise l'API fetch native de Node.js qui nécessite Node 20+. Vérifiez avec node --version.
6. Inventorier les fournisseurs API utilisés actuellement. Si vous avez configuré plusieurs fournisseurs dans Hermes (OpenAI + Gemini + Cerebras, etc.), vérifiez avant la migration qu'ils figurent tous dans la liste des fournisseurs intégrés d'OpenClaw. Les fournisseurs manquants apparaîtront comme « manual-required » dans le rapport.
7. Vérifier l'espace disque disponible sur le nœud Mac mini M4. Le processus de migration écrit des rapports et des fichiers de configuration convertis dans ~/.openclaw/. 500 Mo d'espace libre suffisent pour la plupart des configurations.

Étape par étape : migrer depuis Claude Code sur Mac mini M4

Les étapes suivantes supposent que vous disposez d'une session VpsGona Mac mini M4 active avec Claude Code et OpenClaw v2026.4.26+ installés. Connectez-vous en SSH au nœud et exécutez :

1. Confirmer que les deux outils existent avec les bonnes versions :

   openclaw --version # doit être ≥ 2026.4.26 claude --version # confirmer l'installation Claude Code

2. Exécuter la commande de migration en spécifiant Claude Code :

   openclaw migrate --from claude-code

   OpenClaw détecte automatiquement ~/.claude/. Si votre configuration Claude Code se trouve à un emplacement non standard, spécifiez-le avec --source :

   openclaw migrate --from claude-code --source /chemin-custom/.claude/

3. Examiner la sortie de migration. Le CLI affiche en temps réel chaque élément détecté. Le préfixe ✓ indique une migration réussie, ⚠ nécessite une vérification, ✗ non migrable :

   Discovered: 8 MCP servers, 12 custom tools, 3 system prompt blocks, 1 provider config ✓ MCP server: filesystem-mcp → migrated ✓ MCP server: github-mcp → migrated ⚠ System prompt block 'persona' → manual-required (format differs) ⚠ Provider: anthropic → partial ✗ Memory content → not migrated (re-ingest manually) Migration complete. Report: ~/.openclaw/migrate-report.json

4. Vérifier le rapport de migration complet :

   cat ~/.openclaw/migrate-report.json | python3 -m json.tool | head -80

5. Démarrer OpenClaw et vérifier les connexions MCP :

   openclaw start /mcp status

   Chaque serveur MCP migré devrait afficher un état de connexion vert. Pour ceux qui ne sont pas connectés, consultez la section dépannage ci-dessous.

Étape par étape : migrer depuis Hermes vers OpenClaw

La migration Hermes suit le même schéma mais avec un flag --from différent et des considérations spécifiques à Hermes. Hermes stocke sa configuration par défaut dans ~/.hermes/ et utilise un format YAML que l'outil de migration OpenClaw peut lire directement.

1. Exécuter la migration Hermes :

   openclaw migrate --from hermes

   Pour les workspaces Hermes (configuration à portée projet), spécifiez le répertoire du workspace :

   openclaw migrate --from hermes --source /path/to/hermes-workspace/

2. Traiter manuellement les définitions de workflow Hermes. La structure « workflow » de Hermes se mappe partiellement vers les TaskFlows d'OpenClaw. L'outil de migration convertit les déclencheurs et la structure des étapes, mais ne peut pas répliquer automatiquement la logique de branchement conditionnel. Après migration, ouvrez chaque workflow signalé dans l'éditeur TaskFlow d'OpenClaw et vérifiez que les conditions de branchement sont correctement exprimées.
3. Reconfigurer les paramètres multi-fournisseurs. Si vous utilisiez plusieurs fournisseurs de modèles dans Hermes, vérifiez que chacun est actif dans la configuration OpenClaw :

   openclaw config list-providers

   Ajoutez les fournisseurs manquants :

   openclaw config add-provider cerebras --api-key $CEREBRAS_API_KEY

4. Réingérer le contenu Memory-Wiki. Le contenu mémoire Hermes doit être réingéré dans Memory-Wiki d'OpenClaw. Pour les petites bases de connaissances (moins de 50 documents), utilisez la commande /learn de manière interactive. Pour les bases plus grandes, utilisez l'API d'ingestion par lots :

   openclaw memory ingest --dir /path/to/hermes/knowledge/ --format markdown

Périmètre de migration : automatique vs intervention manuelle requise

Catégorie d'élément	Migration automatique ?	Action manuelle requise
Endpoints et authentification MCP	✓ Oui	Aucune si connexion réussie ; réauthentifier si token expiré
Définitions d'outils/compétences	✓ Oui	Après conversion schéma, tester chaque outil manuellement
Alias de variables d'env de clés API	✓ Oui (alias seuls)	Vérifier que les vraies clés sont dans ~/.openclaw/.env ou l'env système
ID opérateur du prompt système	⚠ Partiel	Vérifier et réécrire selon le format opérateur OpenClaw
Config. fournisseurs de modèles	⚠ Partiel	Ajouter manuellement les fournisseurs non-Anthropic lors d'une migration Claude Code
Conditions de workflows Hermes	⚠ Partiel	Convertir manuellement le branchement conditionnel au schéma TaskFlow
Contenu mémoire/base de connaissances	✗ Aucune	Réingérer tous les documents via /learn ou ingestion par lots
Historique de conversations	✗ Aucune	Non nécessaire — l'historique est spécifique à l'outil et non portable
Config. Matrix E2EE (nouveau en v2026.4.26)	✗ S/O (nouvelle fonctionnalité)	Configurer from scratch : openclaw security matrix --setup

Dépannage post-migration : 6 erreurs courantes et corrections

Erreur 1 : Les serveurs MCP affichent « déconnecté » après migration. La cause la plus courante est l'expiration des tokens d'authentification. Les serveurs MCP stockent les références de tokens mais pas les valeurs réelles des tokens — qui expirent. Solution : ouvrez les paramètres d'authentification du serveur MCP dans le panneau de contrôle OpenClaw et réauthentifiez.

Erreur 2 : openclaw migrate: source directory not found. Claude Code peut être installé à un emplacement non standard. Trouvez-le avec find ~ -name ".claude" -type d 2>/dev/null et spécifiez-le explicitement avec --source.

Erreur 3 : schema validation error lors d'appels d'outils personnalisés. L'outil de migration encapsule les outils dans le schéma de compétences OpenClaw, mais certains types de paramètres d'outils n'ont pas d'équivalent exact. Vérifiez les définitions de paramètres de l'outil dans ~/.openclaw/skills/ et alignez les déclarations de type avec le schéma OpenClaw (string, number, boolean, array, object).

Erreur 4 : Blocage au démarrage après migration (bug connu de v2026.4.26). Certains utilisateurs signalent des délais de démarrage après mise à jour vers v2026.4.26 lorsque de nombreux serveurs MCP sont configurés. C'est un bug connu causé par une initialisation synchrone des connexions. Contournement : désactivez temporairement les serveurs MCP non essentiels dans openclaw.config.js et réactivez-les progressivement après démarrage réussi.

Erreur 5 : ENOENT: no such file or directory, open '~/.openclaw/.env'. L'outil de migration suppose que .env existe. Créez-le manuellement et saisissez les vraies clés :

touch ~/.openclaw/.env echo "ANTHROPIC_API_KEY=votre-clé-ici" >> ~/.openclaw/.env echo "OPENAI_API_KEY=votre-clé-ici" >> ~/.openclaw/.env

Erreur 6 : La connexion Ollama échoue après migration. OpenClaw v2026.4.26 a particulièrement amélioré la fiabilité d'Ollama pour les modèles Qwen et Gemma 4. Si une connexion Ollama qui fonctionnait dans Hermes échoue dans OpenClaw, vérifiez que vous exécutez Ollama 0.22.0 ou plus récent :

ollama --version # doit être ≥ 0.22.0 ollama serve # confirmer qu'Ollama est en cours d'exécution avant de démarrer OpenClaw

Optimiser votre configuration OpenClaw migrée sur Mac mini M4

Une fois la migration stable et tous les serveurs MCP connectés, quatre optimisations sont particulièrement bénéfiques pour un déploiement Mac mini M4 :

• Définir maxContextTokens selon les modèles réellement utilisés. La configuration migrée hérite d'une taille de fenêtre de contexte générique. Sur un Mac mini M4 à 16 Go de mémoire unifiée, la fenêtre de contexte 200K de Claude 3.7 Sonnet est intensive en mémoire. Pour les tâches de codage typiques, définir maxContextTokens: 32768 dans openclaw.config.js réduit significativement la pression mémoire tout en couvrant presque toutes les sessions de codage réelles.
• Activer le nouveau panneau de diff des modifications en attente au format JSON5. Nouvelle fonctionnalité de v2026.4.26, elle affiche un diff structuré avant que l'agent ne commite les modifications de fichiers. Particulièrement utile quand vous ne pouvez pas surveiller le répertoire de travail en temps réel depuis une session Mac mini M4 distante :

  // Dans openclaw.config.js ui: { pendingChangesDiff: true, diffFormat: 'json5' }

• Configurer le fournisseur Cerebras pour les tâches prioritaires en vitesse. Cerebras est devenu un fournisseur intégré dans v2026.4.26. Pour les tâches où la vitesse de réponse prime sur la longueur de sortie — explications rapides de code, suggestions d'annotations de type, génération de cas de test — les modèles Cerebras offrent un temps jusqu'au premier token bien inférieur à Anthropic ou OpenAI à niveau de qualité similaire.
• Configurer Matrix E2EE pour les sessions distantes sécurisées. Fonctionnalité absente de Claude Code et Hermes. Lorsque vous exécutez OpenClaw sur un nœud VpsGona, toutes les données transitent déjà via SSH, mais l'ajout de Matrix E2EE ajoute un chiffrement de bout en bout au niveau de la couche applicative :

  openclaw security matrix --setup

Pourquoi le Mac mini M4 de VpsGona est l'environnement cible idéal pour migrer vers OpenClaw

Migrer vers OpenClaw est un changement de configuration ; où vous exécutez OpenClaw détermine si la migration déploie toute sa valeur. Pour les développeurs qui utilisaient Claude Code ou Hermes sur un laptop ou bureau personnel, migrer vers OpenClaw sur un nœud Mac mini M4 VpsGona change concrètement la donne sur plusieurs points.

Premièrement, l'architecture Apple Silicon du Mac mini M4 est nativement compatible avec tous les serveurs MCP macOS-only et outils que les utilisateurs Claude Code ont construits. Accès au système de fichiers, intégration Xcode, automatisation macOS via AppleScript ou Raccourcis, inférence de modèles locaux via CoreML — tout fonctionne comme prévu sur la puce M4. Migrer votre configuration MCP vous amène dans un environnement avec exactement le même OS et la même architecture de puce que l'environnement pour lequel il a été conçu.

Deuxièmement, le modèle de location sans engagement minimum de VpsGona s'aligne naturellement avec les patterns d'utilisation d'OpenClaw. Les fonctionnalités les plus puissantes d'OpenClaw — orchestration multi-agents via ClawHub, observabilité OTEL, agents autonomes nocturnes — ont le plus de valeur lorsqu'elles s'exécutent de manière continue sur un nœud dédié, pas de manière intermittente sur une machine personnelle. Louer un nœud Mac mini M4 dédié aux charges de travail OpenClaw par cycle de projet vous donne des performances Apple Silicon natives pour une fraction du coût des alternatives de serveur dédié. Consultez les tarifs et disponibilités des nœuds sur la page de tarification VpsGona, et référez-vous à la documentation de déploiement pour la configuration de l'environnement OpenClaw.