2026 Hermes Agent Langzeit-Wartung: Best Practices für Updates, Logs, Backup und Neustart-Wiederherstellung — vollständiger Leitfaden

2. Typische Schmerzpunkte

1. Einschränkung: Unbeaufsichtigt ≠ wartungsfrei. macOS, Homebrew/pip und Hermes-Releases laufen nicht synchron; hermes update ohne Abnahme lässt Gateway oder Cron halb aktualisiert zurück.
2. Versteckte Kosten: PATH- und launchd-Umgebung. git und node funktionieren in der interaktiven Shell, das launchd-Gateway findet die Binaries nicht — in den Task-Logs nur vage Tool-Fehler.
3. Stabilität und Audit: Ohne Backup kein Rollback-Punkt. Konfiguration verteilt sich über ~/.hermes/config.yaml, .env, Skills und Session-DB; Keys nur im Chat gespeichert brechen bei Rotation die ganze Kette.

3. Was sichern? (Checkliste vor Updates)

Standard-Datenverzeichnis: HERMES_HOME (meist ~/.hermes). Pfade mit hermes config path und hermes config env-path bestätigen; jedes Profil hat ein eigenes Home.

Empfohlene Befehle: täglicher Schnappschuss hermes backup --quick --label "pre-upgrade"; vor größeren Änderungen hermes backup -o ~/hermes-backups/$(date +%F).zip. Wiederherstellung mit hermes import. Hinweis: Das offizielle Backup enthält nicht das Hermes-Code-Repo (git vs. pip Rollback unterscheidet sich).

4. Upgrades ohne kaputte Umgebung: Takt, Matrizen und Sieben-Schritte-Runbook

4.1 Update-Takt: macOS, Abhängigkeiten und Hermes

Auto-Update ist nicht automatisch sicher. Ob git pull oder pip install --upgrade — immer Backup → Update → Minimal-Task-Abnahme → Rollback-Zip behalten. Setzen Sie update.backup: true in config.yaml oder führen Sie einmalig hermes update --backup aus.

4.2 Sieben-Schritte-Runbook für Upgrade und Abnahme

1. Baseline erfassen: hermes version, hermes dump und hermes gateway status ins Change-Ticket schreiben.
2. Backup: hermes backup --quick --label "pre-$(date +%Y%m%d)" oder vollständiges Zip.
3. Vorprüfung: hermes update --check; hermes doctor --fix für auto-fixbare Punkte.
4. Update ausführen: im Wartungsfenster hermes update --backup (git-Install zieht Code und deps; pip-Install upgraded von PyPI).
5. Minimal-Abnahme: hermes chat -q "reply OK"; bei Gateway echte Nachricht von Telegram/Discord senden.
6. Neustart-Test: hermes gateway restart; optional Mac neu booten und launchd-Autostart prüfen.
7. Rollback bei Fehler: hermes import <backup.zip>, oder config/.env wiederherstellen und hermes gateway restart; pip/git je nach Installationsmethode downgraden.

5. Logs und Health Checks

5.1 Log-Pfade und häufige Befehle

Standardverzeichnis: ~/.hermes/logs/ (andere Profile: passendes HERMES_HOME/logs/).

• agent.log — API-Aufrufe, Tool-Dispatch, Session-Lebenszyklus (INFO+)
• errors.log — WARNING und höher; erste Anlaufstelle bei Störungen
• gateway.log — Messaging-Plattform-Verbindungen und Webhooks

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

Das Framework rotiert agent.log (z. B. zu agent.log.1). *.log.* älter als 30 Tage monatlich ins Archiv; Checkpoint-Shadow-Repos mit hermes checkpoints prune --max-size-mb 500 begrenzen.

5.2 Health-Check-Schwellen (Vorschlag)

Tägliche Checks skriptbar: hermes doctor + hermes logs errors --since 24h + df -h. Für externe Alarmierung ERROR-Zeilen in die Log-Pipeline (JSONL-Sidecar oder hermes debug share --local für manuellen Upload).

6. Neustart, Netzwerkausfall, Sleep und Recovery-Drills

Nach Mac-Sleep/Wake zuerst hermes gateway status; läuft es nicht, hermes gateway start (launchd-Installation). Nach Netzwerk-Wiederherstellung in gateway.log Reconnect bestätigen.

Quartals-Drill (in den Kalender):

1. Vollständiges hermes backup ins Offsite-Verzeichnis
2. Mac neu booten → 3 Minuten warten → hermes status --deep
3. Testnachricht von der Messaging-Plattform + hermes cron tick (falls Cron-Jobs existieren)
4. RTO erfassen: Zeit von Boot bis Gateway verfügbar (Ziel < 5 Minuten, abhängig von Modell und Login-Items)

Bei physischen Fern-Macs (z. B. ZoneMac-Knoten) zusätzlich prüfen: SSH erreichbar, gleicher Benutzer wie launchd, PATH enthält git/node — gleiche Ursache wie PATH-Probleme in OpenClaw Gateway launchd-Fehlersuche.

7. Secrets und Berechtigungen prüfen

• API-Keys (OpenRouter, Anthropic usw.): alle 90 Tage rotieren; hermes auth add/remove, nie Klartext in Skills.
• OAuth (Codex, Anthropic, Copilot): hermes auth status <provider>; bei Ablauf re-OAuth, keine .env-Edits.
• Tool-Berechtigungen: monatlich hermes tools list; ungenutztes Terminal/Browser/MCP deaktivieren.
• Pairing und Webhooks: hermes pairing list; ungenutzte Abos bereinigen.

8. Wartungskalender (in Erinnerungen übernehmen)

Zitierbare Parameter (für internes Wiki)

• Standard-Log-Verzeichnis: ~/.hermes/logs/, rotierte Dateien agent.log.1+
• Quick-Backup typische Größe: wenige MB bis hunderte MB (Sessions/Skills); Vollbackup — Festplatte ≥ 2× HERMES_HOME reservieren
• Produktions-Gateway-Health-Poll: Status alle 30–60 s; < 5 ERROR-Zeilen pro Stunde als Start-Schwelle
• Checkpoint-Repo Standard-Cap: prune --max-size-mb 500 (disk-abhängig anpassen)

FAQ

F: Wie unterscheidet sich Rollback bei brew vs. pip?

A: pip kann das vorherige Wheel reinstallieren; git-Install kann git checkout auf einen bekannten Commit und deps neu installieren. In beiden Fällen: Benutzerdaten-Rollback via hermes import — Binary nicht downgraden ohne Config-Wiederherstellung.

F: Wie sichere ich mehrere Profile?

A: hermes -p <name> backup pro Profil-HERMES_HOME; nach Update mit mehreren Gateways hermes gateway restart --all.