Migrer d'OpenClaw vers Hermes Agent : guide manuel

Vous Avez Pris La Décision. Reste Le Week-End.

Vous avez déjà décidé. Peut-être avez-vous lu la comparaison Hermes Agent vs OpenClaw et conclu que ce runtime d'agent plus ciblé correspond à votre façon réelle de travailler. Peut-être un coéquipier l'a fait. Dans tous les cas, la décision est derrière vous. Ce qui se trouve devant vous, c'est du vrai travail opérationnel : faire passer une installation OpenClaw vivante, avec des mois de mémoire accumulée et des skills affinées, sur une installation Hermes Agent propre sans rien perdre d'important.

Hermes livre une commande de migration officielle. Le paquet hermes-migrate a été publié le 10 mars 2026 et le flux hermes claw migrate est documenté pour importer settings, mémoires, skills, canaux et clés d'API. Cela couvre le chemin heureux. Ce que cela ne couvre pas, c'est le travail autour : provisionner un hôte, traduire la config provider de l'ancienne forme d'OpenClaw vers le schéma snake_case de Hermes, verrouiller les secrets au repos, ré-appairer votre bot Telegram, et vérifier de bout en bout avant d'annoncer à votre équipe que le nouveau bot est en ligne.

Ce guide parcourt l'ensemble à la main pour que vous sachiez exactement à quoi vous vous engagez. À la fin, il y a une alternative en 1 minute.

Étape 1 : Figez Et Exportez Votre État OpenClaw

Ne commencez pas par installer Hermes. Commencez par immobiliser le côté OpenClaw.

La documentation de migration d'OpenClaw vous dit elle-même d'arrêter le gateway avant de copier l'état, sinon l'historique des conversations et les sessions de canal écrivent sous vos pieds. Le répertoire d'état par défaut est ~/.openclaw/, qui contient openclaw.json, les settings du gateway, auth-profiles.json, les credentials provider, les sessions, l'état des canaux pour WhatsApp et Telegram, et vos fichiers de workspace dont MEMORY.md, USER.md, skills et prompts.

openclaw gateway stop
cd ~
tar -czf openclaw-state-$(date +%Y%m%d).tgz .openclaw
sha256sum openclaw-state-*.tgz

Si vous avez défini un chemin personnalisé via OPENCLAW_STATE_DIR, ou si vous utilisez des profils comme ~/.openclaw-work ou ~/.openclaw-personal, archivez chacun séparément. La migration n'est complète que dans la mesure des répertoires que vous pensez à capturer, et le mode d'échec d'oublier un profil est silencieux : Hermes va démarrer correctement et votre personnalité du week-end aura simplement disparu.

Copiez les archives sur le nouvel hôte avant de toucher à autre chose. Si vous sautez cette étape et que l'installation sur le nouvel hôte échoue, vous voudrez un chemin de rollback propre qui ne dépend pas de la santé de l'ancienne machine.

Étape 2 : Provisionnez Un Hôte Et Installez Hermes

Il vous faut maintenant un endroit où Hermes vit. Les deux options réalistes sont un petit VPS ou un hôte Docker local.

Pour un VPS, une machine 2 vCPU / 4 Go est un plancher confortable. Vous allez passer l'heure suivante sur les parties dont personne n'écrit d'articles : choisir une région proche de vos utilisateurs de messagerie, durcir SSH, configurer un pare-feu qui n'autorise que les ports dont vous avez vraiment besoin, mettre en place les mises à jour de sécurité non assistées, et décider si l'agent tourne en root (il ne devrait pas) ou en tant qu'utilisateur de service dédié avec un home verrouillé.

Pour Docker local, le travail est différent mais pas plus court. Vous écrivez un fichier Compose, vous décidez où vivent les volumes d'état, vous décidez comment le conteneur redémarre quand l'hôte redémarre, et vous trouvez comment le conteneur atteint l'extérieur sans exposer plus que nécessaire.

Une fois l'hôte en place, installez Hermes :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup

hermes setup va chercher ~/.openclaw/ et proposer de migrer. Si vous avez uploadé votre tarball sur un autre chemin, extrayez-le d'abord pour que l'assistant le trouve.

Un terminal extrayant une archive d'état OpenClaw sur un serveur neuf

Étape 3 : Traduisez La Config Provider

C'est l'étape où la plupart des migrations manuelles cassent en silence.

OpenClaw comme Hermes vous laissent pointer l'agent vers OpenAI, Anthropic, OpenRouter, vLLM, Ollama ou un endpoint custom compatible OpenAI. Les champs se ressemblent. Ils n'ont pas la même forme.

Hermes ne reconnaît que snake_case dans la config provider. Un apiKey ou baseUrl édité à la main est ignoré en silence. Utilisez api_key et base_url. Quand base_url est défini, Hermes ignore le nom du provider et appelle cet endpoint directement en utilisant api_key ou la variable d'environnement OPENAI_API_KEY pour l'authentification.

Le mapping manuel minimum ressemble à ceci pour chaque provider que vous reportez :

| Champ OpenClaw | Champ Hermes | Notes | |---|---|---| | provider | provider | Utilisez le slug en minuscules attendu par Hermes (openai, anthropic, openrouter, ollama, vllm, custom) | | model | model | Même chaîne, sans traduction | | apiKey | api_key | snake_case obligatoire, le camelCase est ignoré | | baseUrl | base_url | snake_case obligatoire, ne le définissez que si vous avez vraiment besoin d'un endpoint custom | | apiMode | api_mode | Confirmez que Hermes supporte toujours la valeur que vous utilisiez |

Répétez l'opération pour chaque provider configuré. Si vous utilisez des chaînes de fallback (un principal plus un de secours bon marché), faites-les un par un et testez chacun avant de passer au suivant.

Étape 4 : Portez Persona, Skills Et Mémoire

OpenClaw stocke la persona dans workspace/SOUL.md et IDENTITY.md, avec des dossiers optionnels par personnalité sous personalities/, plus USER.md, MEMORY.md et des fichiers de mémoire quotidiens. Les skills vivent dans le répertoire skills de votre workspace.

Un portage manuel propre, c'est une décision par fichier, pas une copie de répertoire. Ouvrez chaque fichier de persona et confirmez :

La voix et les contraintes correspondent toujours à la façon dont vous voulez que le nouvel agent se comporte.
Les références à des outils spécifiques à OpenClaw (Control UI, noms de plugins, comportements du gateway) sont supprimées ou reformulées.
Les noms de skills n'entrent pas en collision avec les skills natives de Hermes, sinon la version importée peut éclipser ou être éclipsée sans avertissement.

Ensuite déplacez les fichiers vers la disposition attendue par Hermes :

~/.hermes/SOUL.md pour la persona
~/.hermes/memories/ pour MEMORY.md, USER.md et fichiers quotidiens
~/.hermes/skills/openclaw-imports/ pour les skills, avec la résolution des conflits faite à la main

Les fichiers de mémoire sont l'endroit où la plupart des équipes sous-estiment le travail. Après un an d'utilisation d'OpenClaw, MEMORY.md peut contenir des centaines d'entrées qui mêlent du contexte de projets obsolètes à des faits encore pertinents. La migration est le bon moment pour dédupliquer et élaguer, pas pour copier à l'aveugle.

Étape 5 : Sécurisez Vos Secrets

Cette étape n'a pas de raccourci. Hermes stocke les credentials dans ~/.hermes/, avec des tokens d'auth sensibles placés à des chemins comme ~/.hermes/auth/google_oauth.json en utilisant chmod 0600, des écritures atomiques et des verrous de fichier inter-processus. C'est le plancher, pas le plafond.

Une migration manuelle qui prend les secrets au sérieux nécessite :

Un inventaire clair de chaque clé d'API que vous reportez, avec rotation au moment de la migration pour invalider toute clé qui aurait fuité durant votre période OpenClaw.
Des permissions sur ~/.hermes/.env réglées à 0600, possédées par l'utilisateur de service, jamais lisibles par d'autres comptes sur l'hôte.
Du chiffrement au repos sur le volume qui héberge ~/.hermes/, surtout si l'hôte est un VPS partagé.
Des sauvegardes hors-hôte, elles aussi chiffrées, avec une procédure de restauration testée, parce qu'une sauvegarde que vous n'avez jamais restaurée n'est pas vraiment une sauvegarde.
Des allowlists documentées indiquant qui et quoi peut lire ces fichiers, pour que la prochaine personne d'astreinte n'ait pas à deviner.

Si vous sautez l'étape de rotation, vous n'avez pas migré votre posture de sécurité, vous l'avez seulement déplacée.

Étape 6 : Ré-appairez Telegram Et Testez De Bout En Bout

Telegram est le canal Hermes le plus courant et le plus facile à casser en route. Vous avez besoin du token du bot, de la liste des utilisateurs autorisés et de tout réglage spécifique au canal comme les IDs de groupe ou les flags admin-only. Hermes lit tout cela depuis des variables d'environnement dans ~/.hermes/.env. Après import, le gateway doit être redémarré avant que le bot ne réponde.

hermes status
hermes gateway restart

Si vous n'avez jamais déployé Hermes sur Telegram, le guide de déploiement de Hermes Agent sur Telegram couvre la création du bot et les détails du webhook. Une fois le gateway de retour, lancez un test de bout en bout depuis le client Telegram réel, pas depuis hermes status. Envoyez un message qui exerce la récupération de mémoire, un message qui exerce une skill migrée et un message qui exerce votre chaîne de providers. Si l'un des trois échoue, corrigez avant d'annoncer à qui que ce soit que la migration est terminée.

Étape 7 : Dépannage Des Suspects Habituels

Réaliste, vous tomberez sur au moins un de ces cas. Prévoyez-le.

Conflits de port : le gateway OpenClaw et le gateway Hermes veulent le même port. Si vous les avez co-localisés en test, arrêtez OpenClaw d'abord.
Erreurs d'auth provider : presque toujours une erreur snake_case ou une clé périmée. Re-vérifiez api_key et base_url, puis hermes status.
Skills manquantes ou incompatibles : les skills importées font parfois référence à des outils qui n'existent que dans OpenClaw. Lisez la skill qui échoue et réécrivez-la ou supprimez-la.
Encodage de la mémoire : si votre MEMORY.md provient d'une installation OpenClaw Windows avec des fins de ligne CRLF, passez-le dans dos2unix avant copie.
Dérive de persona : l'agent semble différent même si le fichier persona est identique. Vérifiez que vous ne chargez pas deux fichiers persona en même temps et qu'aucune persona par défaut de Hermes ne supplante la vôtre.

Si quelque chose fonctionne dans hermes status mais pas dans Telegram, le problème est presque toujours côté gateway, pas agent.

Ou Faites Tout Cela En Moins D'1 Minute Avec Hermify

Relisez les sept dernières sections. C'est entre un week-end concentré et une semaine éclatée de soirées, selon la propreté de votre installation OpenClaw au moment de commencer.

Hermify embarque un assistant de migration OpenClaw en un clic dans le tableau de bord qui fait le même travail sans le week-end. Vous uploadez votre export OpenClaw, l'assistant prévisualise la migration avec des compteurs pour persona, skills, mémoires, secrets, providers et Telegram avant d'appliquer quoi que ce soit, et l'étape d'application écrit le tout dans une installation Hermes managée avec les secrets chiffrés au repos. Pas d'hôte à provisionner, pas de traduction snake_case à mémoriser, pas de script de sauvegarde à écrire.

L'article que vous venez de lire correspond à ce que l'assistant exécute en coulisse. Si le chemin manuel est l'expérience que vous voulez, les étapes ci-dessus sont précises et complètes. Si c'est le résultat que vous voulez, l'assistant vous y mène en environ une minute.

Démarrez avec Hermify et migrez d'OpenClaw avant le week-end que vous comptiez y consacrer.