Comment corriger les configurations manquantes après la mise à jour de l’agent Hermes ?

Si l’agent Hermes est mis à jour avec « Configuration manquante », « Une option n’existe pas », ou si l’ancienne configuration ne prend pas effet, exécutez d’abord le hermes config check, puis suivez les instructions pour exécuter le hermes config migrate. C’est plus stable que de changer manuellement config.yaml.

Pourquoi la configuration manque-t-elle après la mise à jour ?

Les capacités d’Hermes évoluent rapidement, et les nouvelles versions peuvent ajouter de la compression, des outils, des plateformes, des plugins ou des options contextuelles. Lorsque ces champs n’étaient pas disponibles dans l’ancienne ~/.hermes/config.yaml, le programme essayait d’utiliser les paramètres par défaut, mais certaines fonctionnalités exigeaient explicitement de les compléter. La documentation officielle utilise config check et config migrate comme chemins de traitement standards mis à jour.

Séquence de réparation recommandée

1. Exécutez-hermes config d’abord pour voir si la configuration actuelle peut être lue normalement.
2. Effectuez hermes config check pour vérifier si la configuration normale ou la clé est manquante.
3. Exécutez hermes config migrate pour combler les éléments manquants de manière interactive.
4. Si des informations sensibles telles que la clé API, le jeton bot ou le mot de passe sont écrites avec hermes config set KEY VALUE, elles seront automatiquement placées dans le .env.

Les priorités de configuration doivent également être clairement visibles

La priorité de configuration d’Hermes est le paramètre CLI avec la priorité la plus élevée, suivi de config.yaml, puis .env, et enfin le paramètre par défaut. Donc, si vous sentez que « le changement a été modifié mais n’a pas d’effet » après la mise à jour, vous devez vérifier si la commande de démarrage contient des paramètres temporaires, comme --model ou --profile.

La conclusion est simple : les problèmes de configuration mis à jour sont d’abord transmis aux commandes officielles, et ne sont modifiés manuellement que lorsque la signification des champs est connue. Cela évite d’écrire des clés dans le mauvais fichier et réduit le besoin de la prochaine mise à jour.