2026 — Bonnes pratiques de maintenance longue durée d'Hermes Agent : mise à jour, journaux, sauvegarde et reprise après redémarrage

2. Points de friction

1. Contrainte : sans surveillance ≠ sans maintenance. Les cycles macOS, Homebrew/pip et Hermes ne s'alignent pas ; lancer hermes update sans acceptation laisse passerelle ou cron à mi-mise à jour.
2. Coût caché : PATH et environnement launchd. git et node marchent en shell interactif, mais la passerelle launchd ne trouve pas les binaires — les journaux de tâches n'affichent que des erreurs outils vagues.
3. Stabilité et audit : pas de sauvegarde, pas de point de retour. La config est éclatée entre ~/.hermes/config.yaml, .env, skills et base de sessions ; des clés uniquement dans le chat cassent toute la chaîne à la rotation.

3. Que sauvegarder (checklist avant mise à jour)

Le répertoire de données par défaut est HERMES_HOME (souvent ~/.hermes). Confirmez les chemins avec hermes config path et hermes config env-path ; chaque profil a son propre home.

Commandes recommandées : instantané rapide quotidien hermes backup --quick --label "pre-upgrade" ; avant changement majeur hermes backup -o ~/hermes-backups/$(date +%F).zip. Restauration avec hermes import. Note : la sauvegarde officielle n'inclut pas le dépôt code Hermes (retour arrière git vs pip différent).

4. Mettre à jour sans casser l'environnement : rythme, matrices et runbook en sept étapes

4.1 Rythme de mise à jour : macOS, dépendances et Hermes

Ne supposez pas que la mise à jour auto est sans risque. Que ce soit git pull ou pip install --upgrade, suivez sauvegarde → mise à jour → acceptation tâche minimale → conserver le zip de retour arrière. Définissez update.backup: true dans config.yaml, ou lancez hermes update --backup une fois.

4.2 Runbook de mise à jour et d'acceptation en sept étapes

1. Baseline : noter hermes version, hermes dump et hermes gateway status dans le ticket de changement.
2. Sauvegarde : hermes backup --quick --label "pre-$(date +%Y%m%d)" ou zip complet.
3. Pré-contrôle : hermes update --check ; hermes doctor --fix pour les WARN auto-corrigeables.
4. Mise à jour : pendant la fenêtre de maintenance hermes update --backup (install git tire le code et réinstalle les deps ; pip met à jour depuis PyPI).
5. Acceptation minimale : hermes chat -q "reply OK" ; avec passerelle, envoyer un vrai message Telegram/Discord.
6. Test redémarrage : hermes gateway restart ; optionnel : redémarrer le Mac pour vérifier le démarrage auto launchd.
7. Retour arrière si échec : hermes import <backup.zip>, ou restaurer config/.env puis hermes gateway restart ; rétrograder pip/git selon la méthode d'install.

5. Journaux et contrôles de santé

5.1 Emplacements et commandes courantes

Répertoire par défaut : ~/.hermes/logs/ (profils non par défaut : HERMES_HOME/logs/ correspondant).

• agent.log — appels API, dispatch outils, cycle de vie session (INFO+)
• errors.log — WARNING et plus ; premier arrêt en dépannage
• gateway.log — connexions plateformes messagerie et webhooks

hermes logs list
hermes logs errors --since 30m -n 100
hermes logs gateway -f
hermes logs --level ERROR --since 2h --component tools

Le framework fait tourner agent.log (ex. vers agent.log.1). Archivez mensuellement les *.log.* de plus de 30 jours ; limitez les dépôts shadow checkpoint avec hermes checkpoints prune --max-size-mb 500.

5.2 Seuils de contrôle de santé (suggérés)

Contrôles quotidiens scriptables : hermes doctor + hermes logs errors --since 24h + df -h. Pour alertes externes, envoyez les lignes ERROR vers votre pipeline (sidecar JSONL ou hermes debug share --local pour envoi manuel).

6. Redémarrage, perte réseau, veille et exercices de reprise

Après veille/réveil Mac, vérifiez d'abord hermes gateway status ; si arrêté, hermes gateway start (scénario install launchd). Après retour réseau, confirmez la reconnexion dans gateway.log.

Exercice trimestriel (à mettre au calendrier) :

1. hermes backup complet vers répertoire hors site
2. Redémarrer le Mac → attendre 3 minutes → hermes status --deep
3. Message test depuis la messagerie + hermes cron tick (si tâches cron)
4. Noter le RTO : délai boot → passerelle disponible (cible < 5 min, selon modèle et éléments de connexion)

Sur Mac physiques distants (ex. nœuds ZoneMac), vérifiez aussi : SSH joignable, même utilisateur que launchd, PATH inclut git/node — même cause racine que les soucis PATH dans OpenClaw Gateway 7×24 : dépannage du démon launchd.

7. Revue des secrets et permissions

• Clés API (OpenRouter, Anthropic, etc.) : rotation tous les 90 jours ; hermes auth add/remove, jamais en clair dans les skills.
• OAuth (Codex, Anthropic, Copilot) : hermes auth status <provider> ; re-OAuth à expiration, pas d'édition .env.
• Permissions outils : mensuel hermes tools list ; désactiver terminal/navigateur/MCP inutilisés.
• Appairage et webhooks : hermes pairing list ; nettoyer abonnements obsolètes.

8. Calendrier de maintenance (à coller dans Rappels)

Paramètres citables (wiki interne)

• Répertoire journaux par défaut : ~/.hermes/logs/, fichiers tournés agent.log.1+
• Taille sauvegarde rapide typique : quelques Mo à centaines de Mo (sessions/skills) ; sauvegarde complète — réserver disque ≥ 2× HERMES_HOME
• Sonde santé passerelle prod : statut toutes les 30–60 s ; < 5 lignes ERROR/heure comme seuil de départ
• Plafond dépôt checkpoint : prune --max-size-mb 500 (ajuster au disque)

FAQ

Q : Retour arrière brew vs pip ?

R : pip peut réinstaller le wheel précédent ; install git peut git checkout sur un commit connu et réinstaller les deps. Dans tous les cas, les données utilisateur reviennent via hermes import — ne rétrogradez pas le binaire sans restaurer la config.

Q : Sauvegarder plusieurs profils ?

R : hermes -p <name> backup pour chaque HERMES_HOME de profil ; après mise à jour multi-passerelles, hermes gateway restart --all.