Si tu fais tourner OpenClaw depuis un moment, Hermes Agent en est le successeur. Même lignée du projet, mêmes mainteneurs, un renommage et un redesign par-dessus. L'installeur de Hermes est construit pour reconnaître ça — v0.14.0 embarque une commande de première classe, hermes claw migrate, qui importe ton état OpenClaw existant en un coup, avec support du dry-run et des presets explicites.
Voici le guide pratique de migration : ce qui passe, les flags disponibles, et le workflow « dry-run d'abord » qui évite les mauvaises surprises.
1. Installer Hermes Agent
L'assistant de setup de Hermes détecte automatiquement ~/.openclaw et te propose de migrer avant que la configuration commence. Le chemin le plus court :
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
Quand l'assistant voit ton répertoire home OpenClaw, il demande s'il doit migrer. Dis oui — mais si tu veux voir exactement ce qui serait migré avant, tu quittes l'assistant et tu lances la commande de migration directement.
2. Prévisualiser avec --dry-run
Toujours celui-ci en premier. Il énumère tout ce que le migrateur importerait sans rien écrire sur disque :
hermes claw migrate --dry-run
La sortie est groupée par catégorie — SOUL.md, memories, skills, liste blanche, configs de messagerie, API keys, assets TTS. Lis-la. Si quelque chose te gêne (une vieille API key que tu ne veux pas embarquer, un fichier de personnalité que tu as dépassé), tu sautes la section correspondante via un preset.
3. Choisir un preset
Deux presets fournis par défaut :
- •
full(par défaut) — tout migrer, y compris les secrets - •
user-data— tout migrer sauf les API keys ; tu ressaisis les secrets à la main
Tu passes sur une machine fraîche et tu veux couper net avec les secrets ? Prends user-data :
hermes claw migrate --preset user-data
Tu mets à niveau la même machine et tu veux la continuité ?
hermes claw migrate
4. Ce qui est importé
Selon le README :
| OpenClaw | Cible Hermes |
|---|---|
SOUL.md (persona) | importé tel quel |
Entrées de MEMORY.md et USER.md | importées dans le memory Hermes |
| Skills créés par l'utilisateur | copiés vers ~/.hermes/skills/openclaw-imports/ |
| Liste blanche de commandes (patterns d'approbation) | importée |
| Réglages de messagerie (configs de plateforme, users autorisés, dossier de travail) | importés |
| API keys (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs) | importées sous le preset full |
| Assets TTS (fichiers audio du workspace) | importés |
AGENTS.md du workspace | importé avec --workspace-target |
Les skills venant d'agentskills.io ne sont pas réinstallés automatiquement — Hermes suppose que tu vas refaire un tour du hub et choisir ce que tu veux via hermes skills. C'est volontaire : le renommage OpenClaw → Hermes a aussi remanié le hub de skills (v0.14.0 a ajouté huggingface/skills comme tap par défaut de confiance), et une nouvelle sélection est plus propre qu'un report en bloc.
5. Gérer les conflits
Si Hermes a déjà des réglages sur cette machine (par exemple, tu as lancé hermes setup avant de te rappeler qu'OpenClaw était là), la commande de migration refuse d'écraser par défaut. Deux options :
- •
--overwrite— écrase les réglages Hermes avec les valeurs OpenClaw - •Sauter la catégorie en conflit avec
--preset user-datasi le conflit est sur les secrets
N'utilise --overwrite qu'après un --dry-run qui confirme que les valeurs OpenClaw sont bien celles que tu veux.
6. Vérifier
hermes doctor
Ça lance le check de santé post-install. Si les memories, skills, liste blanche ou configs de plateforme ne sont pas là où ils devraient, des erreurs précises remontent. Tu corriges, tu relances, tu passes à la suite.
Alternative : migration guidée par l'agent
Si tu n'as pas envie de toucher aux flags CLI, Hermes embarque un skill openclaw-migration :
hermes
> /openclaw-migration
Le skill te fait passer par la même migration en mode interactif, avec des aperçus --dry-run à chaque étape.
Questions fréquentes
Est-ce que je perds mes données OpenClaw ? Non. Le migrateur copie — il ne déplace pas. Ton dossier ~/.openclaw reste intact. Si quelque chose tourne mal, tu peux revenir en arrière en supprimant ~/.hermes et continuer à utiliser OpenClaw.
Je peux faire tourner les deux ? Brièvement. Ils partagent des suppositions sur HOME et ne sont pas censés posséder le même memory en même temps. Pour un fonctionnement en parallèle plus long, le pont communautaire HermesClaw gère le fait de faire tourner OpenClaw et Hermes sur le même compte WeChat.
Mes skills vont casser ? Les skills créés par l'utilisateur sont copiés vers ~/.hermes/skills/openclaw-imports/, ils survivent au déménagement. Les skills pris sur agentskills.io sont liés au hub, pas à ton install locale — tu les réinstalles via hermes skills.
Où je peux avoir de l'aide si quelque chose casse ? D'abord hermes doctor. Ensuite le Discord Nous Research ou les GitHub Issues — les deux liens sont dans le README.