Migrer OpenClaw vers Hermes : éléments transférés et éléments archivés

Migrer OpenClaw vers Hermes se fait avec une seule commande officielle : hermes claw migrate. Elle lit ~/.openclaw/, affiche un aperçu complet avant toute écriture et crée par défaut une archive zip de point de restauration — mais elle n’importe pas vos tâches cron, et c’est précisément cette omission qui fait discrètement payer deux fois une configuration migrée. L’ordre sûr est : sauvegarder, effectuer une simulation, appliquer, vérifier dans une nouvelle session, arrêter l’ancien planificateur, puis nettoyer.

Identifiez les entités avant toute autre chose, car cette requête entre en collision avec trois produits sans rapport. Cette page concerne Hermes Agent de Nous Research — la CLI et la passerelle, dernière version v0.21.3 (balise v2026.9.14, publiée le 14 septembre 2026) — et OpenClaw de l’OpenClaw Foundation, dernière version v2026.9.5, publiée le 19 septembre 2026. Les deux dépôts étaient actifs et non archivés lorsque leurs métadonnées ont été revérifiées le 21 septembre 2026. Il ne s’agit ni de Hermes 4, la famille distincte de modèles open-weight de Nous Research ; ni du moteur JavaScript Hermes de Meta ; ni de la maison de luxe. Si vous utilisez encore ~/.clawdbot/ ou ~/.moltbot/, il s’agit du même produit sous d’anciens noms, et l’importateur détecte les deux répertoires ainsi que les noms de fichiers de configuration clawdbot.json / moltbot.json.

Pourquoi migrer, et qui ne devrait pas le faire

Le prix n’est pas la raison. Les deux projets sont des logiciels libres : le README d’OpenClaw indique qu’il « n’a aucun forfait payant, service hébergé ou token », et son fichier LICENSE est simplement sous licence MIT, même si l’API GitHub renvoie NOASSERTION dans le champ de licence du dépôt — citez le fichier, pas le champ. Hermes Agent est indiqué comme étant sous licence MIT par l’API GitHub. Dans les deux cas, vous payez les tokens des modèles et l’hôte sur lequel vous exécutez la passerelle.

Une correction à retenir, car les anciennes pages de comparaison ne sont plus à jour : le sens inverse n’est plus limité à la mémoire. OpenClaw documente désormais une migration complète avec aperçu — openclaw migrate hermes --dry-run, puis openclaw migrate apply hermes --yes — qui importe la configuration des modèles, les fournisseurs et endpoints personnalisés, les serveurs MCP, SOUL.md et AGENTS.md, les fichiers mémoire (ajoutés), la configuration mémoire, les compétences avec leur configuration et les identifiants d’authentification après consentement. Ce que cette documentation décrit encore comme une copie limitée à la mémoire correspond à ses imports de mémoire de l’onboarding et de l’interface Control UI, qui placent MEMORY.md et USER.md sous memory/imports/hermes/ sans toucher à la mémoire existante de l’espace de travail. Il s’agit donc d’une migration réversible dans les deux sens, avec un avertissement pour le retour : ne laissez pas Hermes et OpenClaw partager le même refresh grant.

Ce qui migre, et ce qui est archivé à la place

Lisez ce tableau comme la liste d’acceptation. Tout ce qui figure dans la colonne de droite est un travail à effectuer manuellement, selon le calendrier de votre choix ; ce n’est pas un échec de l’outil — Hermes l’archive délibérément sous ~/.hermes/migration/openclaw/<timestamp>/archive/.

Deux correspondances sont destructrices d’une manière que masque une checklist. agents.defaults.timeoutSeconds ne devient pas un délai Hermes — il devient agent.max_turns, calculé comme timeoutSeconds / 10 et plafonné à 200. De plus, le vocabulaire d’OpenClaw à dix valeurs pour l’effort de raisonnement se réduit à trois : always, high et xhigh deviennent tous high ; auto, medium et adaptive deviennent medium ; off, low, none et minimal deviennent low. Dans les deux cas, il s’agit de calculs, pas de copies ; vérifiez donc les valeurs obtenues au lieu de supposer que vos anciens réglages ont été conservés. Les minuteurs d’inactivité de session et de réinitialisation quotidienne ne sont pas importés du tout : les conversations Hermes persistent jusqu’à un /new ou /reset explicite. Tout ceci provient du guide officiel de migration depuis OpenClaw, consulté le 19 septembre 2026.

La commande, option par option

Un ordre d’exécution conforme à la checklist officielle post-migration, sans ajouter d’étapes. Premièrement, arrêtez le calendrier d’OpenClaw : openclaw cron list, puis openclaw cron disable <job-id> pour tout ce qui ferait doublon (openclaw automations est un alias documenté pour l’une ou l’autre). Deuxièmement, effectuez une simulation. Troisièmement, appliquez en laissant l’archive zip de point de restauration par défaut être créée. Quatrièmement, lisez le rapport de migration et tout ce qui se trouve sous le répertoire d’archive. Cinquièmement — et cela surprend souvent — démarrez une nouvelle session ; les compétences et entrées mémoire importées ne prennent pas effet dans la session déjà ouverte, et /skills confirme ce qui a été chargé. Sixièmement, exécutez hermes status pour l’authentification des fournisseurs, redémarrez la passerelle si vous avez déplacé des tokens de plateforme, et réassociez WhatsApp si vous l’utilisiez. Ce n’est qu’une fois toutes ces étapes réussies que vous devez exécuter hermes claw cleanup, qui renomme les répertoires OpenClaw restants en .pre-migration/ afin que deux agents ne puissent pas lire le même état. Il s’agit d’une sous-commande distincte, pas d’une option de migrate ; le guide ne lui documente aucune option propre.

La réserve concernant l’ordre est honnête plutôt que rassurante : la documentation de Hermes place le nettoyage à l’étape 8 et n’indique pas ce qui se produit si un service de passerelle OpenClaw est encore installé lorsque son répertoire est renommé. Arrêter d’abord le planificateur et la passerelle OpenClaw est défendable au vu de la documentation des deux projets ; ce n’est pas un ordre explicitement indiqué par l’un ou l’autre.

Le coût du calendrier en double, détaillé

Les tâches cron sont archivées, pas importées. L’échec naturel est donc le suivant : vous recréez quatre tâches dans Hermes, la passerelle OpenClaw est toujours installée, et chaque invite planifiée s’exécute désormais deux fois auprès de votre fournisseur. Voici ce que cela coûte sous forme de calcul de tokens, et non d’un coût de tâche mesuré ni d’un plafond de facture. Supposons qu’une exécution planifiée envoie 25,000 tokens d’entrée non mis en cache et renvoie 1,500 tokens de sortie, et que quatre tâches exécutées toutes les deux heures produisent 48 exécutions dupliquées par jour. Les tarifs sont ceux, en temps réel, du catalogue Kunavo par million de tokens.

Remplacez par votre propre format et votre propre cadence d’exécution ; l’essentiel est le multiplicateur, pas la ligne. Si le travail en double est déjà en cours, Hermes documente un seul levier : hermes pause est un arrêt d’urgence global — aucune nouvelle tâche cron ne se déclenche, aucune tâche kanban n’est distribuée et aucune exécution de passerelle ne démarre jusqu’à hermes resume, tandis que le travail en cours n’est pas interrompu. Utilisez-le pour stopper l’hémorragie, puis désactivez le bon côté. Notez la limite de permission côté OpenClaw : sa référence automations indique que add/create, edit, remove et run nécessitent operator.admin. Elle ne précise pas si disable relève de cet ensemble ; prévoyez donc que le rôle soit nécessaire.

Deux sources de coût post-migration plus discrètes méritent d’être mentionnées. La page de configuration des modèles de Hermes avertit que les caches de prompts sont indexés par le modèle qui traite la requête ; ainsi, un changement de modèle /model au milieu d’une conversation fait relire le message suivant avec toute la conversation au tarif normal des tokens d’entrée. Sa page fallback-providers indique la même chose pour un basculement automatique, et sa page credential-pools précise que les caches côté fournisseur sont associés au compte ou à la clé ayant effectué la requête ; une rotation de pool coûte donc elle aussi un passage complet au tarif normal. Sur Claude Sonnet 4.6 aux tarifs du catalogue, relire une conversation de 200,000 tokens coûte environ $0.420 au tarif d’entrée $2.10, contre environ $0.042 au tarif de lecture du cache $0.21 — là encore, il s’agit d’un calcul illustratif fondé sur les hypothèses indiquées. Hermes propose model.switch_context_confirm_tokens comme garde-fou. Par ailleurs, la même page indique que les emplacements auxiliaires — vision, résumé Web, compression et autres — utilisent par défaut provider: auto avec un model vide, ce qu’elle présente comme l’utilisation du modèle principal pour cette tâche ; une configuration fraîchement migrée peut donc facturer les tarifs du modèle phare pour des tâches d’arrière-plan jusqu’à ce que vous les remplaciez.

Diriger le Hermes migré vers votre propre endpoint

La documentation des fournisseurs de Hermes indique qu’il fonctionne avec n’importe quel endpoint compatible OpenAI. Le piège propre à la migration concerne l’emplacement où arrive votre fournisseur importé : une entrée OpenClaw models.providers.* est écrite dans custom_providers, et ne devient une entrée du dictionnaire canonique providers: qu’au cours de la migration de configuration hermes update suivante. Un guide qui vous demande de chercher sous providers: juste après la migration vous dirige vers une clé vide.

# What `hermes claw migrate` writes FIRST. An OpenClaw
# `models.providers.*` entry lands under `custom_providers`,
# not under `providers:` — so check here right after migrating.
custom_providers:
  - name: kunavo
    base_url: https://api.kunavo.com/v1
    api_key: sk-your-kunavo-key
    model: claude-sonnet-4-6

# The providers doc says the legacy list is auto-migrated to the
# canonical `providers:` dict on `hermes update` (config v12). The
# documented keys of that dict are `api`, `key_env`, `transport`
# and `default_model` (`base_url`/`url` are accepted aliases of `api`).
providers:
  kunavo:
    api: https://api.kunavo.com/v1
    key_env: KUNAVO_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6

Trois remarques concernant ce bloc. L’importateur associe les valeurs API courtes (openai, anthropic) et avec trait d’union (openai-completions, anthropic-messages, google-generative-ai) d’OpenClaw. La documentation de Hermes elle-même n’est pas cohérente sur le nom du transport — la référence des fournisseurs répertorie chat_completions, anthropic_messages et codex_responses, tandis que la page de configuration des modèles écrit transport: openai_chat ; utilisez chat_completions, qui est la valeur donnée par la référence dédiée des fournisseurs, et considérez openai_chat comme non confirmé. Les endpoints personnalisés compatibles OpenAI ne reçoivent aucun plafond automatique de sortie de la taille du catalogue dans Hermes ; définissez donc vous-même context_length ou fournissez une liste explicite models: avec discover_models: false si la découverte auprès de votre endpoint ne se comporte pas comme prévu.

Pour être explicite sur les limites de cette page : Kunavo publie des références de configuration pour plusieurs clients, mais Hermes Agent n’a pas été testé en conditions réelles ici, aucun hermes claw migrate n’a été exécuté pour cet article et la réussite du transport anthropic_messages de Hermes ou de la découverte de ses modèles auprès de l’endpoint Kunavo n’a pas été testée. Conservez une voie opérationnelle pendant vos essais. Aux tarifs du catalogue, Claude Sonnet 4.6 indique $2.10 par million de tokens d’entrée et $10.50 par million de tokens de sortie ; le montant du catalogue Kunavo constitue un plancher de facturation plutôt qu’un plafond, car lorsque l’amont communique son coût, la facture est le montant le plus élevé entre le coût catalogue et le coût amont multiplié par la majoration applicable. Le rechargement minimal est de $10 en crédit prépayé — un minimum de financement, et non des frais de tâche ou un abonnement. Consultez les détails de facturation et créez un compte Kunavo lorsque vous serez prêt à financer une clé.

Après le premier jour, faites le rapprochement. Hermes fournit hermes insights, que sa référence CLI décrit uniquement comme « afficher les analyses de tokens/coûts/activité » et documente sans options ; lisez donc hermes insights --help pour connaître ce que votre build accepte réellement — puis comparez-le à l’utilisation effectivement enregistrée par votre compte fournisseur. Si les deux ne concordent pas, recherchez un calendrier en double avant de chercher une erreur de tarification. Pour le contexte de cette méthode, consultez l’optimisation des coûts de l’IA ; pour la vue des forfaits de chaque côté, tarification de Hermes Agent et tarification d’OpenClaw ; et Hermes contre OpenClaw si vous n’avez pas encore décidé de migrer.

Questions fréquentes

La documentation de Hermes Agent et d’OpenClaw, les références CLI et les métadonnées des dépôts ont été vérifiées le 19 septembre 2026, par rapport à Hermes v0.21.3 (v2026.9.14) et OpenClaw v2026.9.5 ; les métadonnées des dépôts ont été revérifiées le 21 septembre 2026. Chaque commande, option et chemin de cette page a été lu dans ces sources officielles ; aucune migration n’a été exécutée et aucune clé Kunavo n’a été dirigée vers l’un ou l’autre agent, cette page ne constitue donc pas un test de compatibilité. Les tarifs des tokens Kunavo proviennent du catalogue en ligne, et chaque montant en dollars est un calcul illustratif de tokens, et non un coût mesuré.