Warum wechseln – und was nicht automatisch besser wird

Hermes kombiniert persistente Erinnerung, eigene Skills, viele Messaging-Plattformen, Zeitplanung, Subagenten und Toolsets in einer konsistenten Laufzeit. Wer früh mit OpenClaw gearbeitet hat, findet viele vertraute Dateien wieder. Ein Wechsel löst aber keine schlechte Datenhygiene, überbreite Rechte oder unklare Cron-Jobs. Diese Altlasten sollten nicht ungeprüft mitwandern.

Mitnehmen

Persona und Wissen

SOUL.md, AGENTS.md, Memory, Nutzerprofil und geeignete Skills können strukturiert importiert werden.

Prüfen

Provider und MCP

Custom Provider, API-Modi, Base-URLs und MCP-Server brauchen eine Validierung im aktuellen Hermes-Format.

Neu verbinden

Einzelne Messenger

Einige Tokens lassen sich importieren; QR-basierte WhatsApp-Verbindungen müssen neu gepairt werden.

Nicht blind kopieren

Secrets und Altlasten

Secrets erfordern explizite Freigabe. Nicht direkt abbildbare Elemente landen im Migrationsarchiv zur manuellen Prüfung.

Vorbereitung: Inventar, Backup und Zielsystem

  • OpenClaw-Version, Arbeitsverzeichnisse, Profile, Gateway, Cron-Jobs, MCP-Server und Provider inventarisieren.
  • Separates Backup des gesamten OpenClaw-Home und wichtiger Projektdateien erstellen.
  • Hermes aktuell und unter dem Benutzer installieren, der später Gateway und Dateien besitzen soll.
  • Einen neuen, noch nicht produktiven Telegram-Bot oder Testkanal für die Validierung verwenden.
  • Entscheiden, ob nur Nutzerdaten oder auch Infrastrukturkonfiguration übernommen werden soll.
  • Rollback-Zeitpunkt und Umschaltfenster festlegen; nicht gleichzeitig beide Bots mit identischen Tokens betreiben.

Dry Run und Presets richtig einsetzen

Der Standardlauf zeigt ebenfalls eine Vorschau und fragt vor Änderungen. --dry-run beendet nach dem Plan. Konflikte werden standardmäßig nicht überschrieben; für Skills stehen skip, overwrite oder rename zur Verfügung. Der konservative Weg ist skip oder rename, danach manuell vergleichen.

Nur Vorschau
hermes claw migrate --dry-run
Vollständiger kompatibler Import – Secrets weiterhin separat
hermes claw migrate --preset full
Nutzerdaten ohne Infrastruktur
hermes claw migrate --preset user-data
Automatisierter Vollimport inklusive Secrets – nur nach Prüfung
hermes claw migrate --preset full --migrate-secrets --yes

Was wohin migriert wird

OpenClawHermesPrüfpunkt
workspace/SOUL.md~/.hermes/SOUL.mdPersona knapp und ohne Projektregeln?
workspace/AGENTS.mdProjekt-AGENTS.mdWorkspace-Target explizit gesetzt?
MEMORY.md / USER.md~/.hermes/memories/Duplikate und veraltete Fakten?
Workspace-/Shared-Skills~/.hermes/skills/openclaw-imports/Konflikte, Secrets, alte Befehle?
Custom Providerconfig.yamlAPI-Modus, Base-URL und Modell-ID aktuell?
Provider- und Bot-Keys~/.hermes/.envNur mit --migrate-secrets; danach Rotation erwägen
Approval/AllowlistHermes Command AllowlistAlte Freigaben weiterhin angemessen?
Nicht abbildbare ElementeMigrationsarchivManuell entscheiden, nicht vergessen

Nach dem Import systematisch validieren

  1. 01

    Migrationsbericht lesen

    Anzahl importierter, übersprungener und konfliktbehafteter Elemente dokumentieren.

  2. 02

    Archiv prüfen

    Dateien ohne direkte Hermes-Entsprechung bewusst entscheiden; kein stilles Vergessen.

  3. 03

    Neue Session starten

    Importierte Skills und Memory werden in einer neuen Session wirksam.

  4. 04

    Provider testen

    Mit hermes status, hermes auth oder hermes doctor jeden benötigten Zugang prüfen.

  5. 05

    Messenger getrennt testen

    Testnutzer, Allowlist, Pairing, Home Channel und Stop-Befehl validieren.

  6. 06

    Cron zunächst deaktiviert prüfen

    Prompt, Zeitplan, Ziel und potenzielle Aktionen lesen, bevor der Job wieder läuft.

  7. 07

    Parallelbetrieb kurz halten

    Nur so lange shadowen, wie für Vergleich nötig; doppelte Nachrichten und Aktionen vermeiden.

Secrets bewusst rotieren statt nur kopieren

Die Migration kann bekannte Key-Typen aus mehreren OpenClaw-Quellen auflösen. Das ist bequem, ändert aber nicht Alter oder Berechtigungsumfang. Ein Plattformwechsel ist ein guter Anlass, API- und Bot-Tokens neu auszustellen, zu benennen und alte zu widerrufen.

  • Nur benötigte Secrets migrieren; unbekannte Keys nicht in ein Sammelfeld kopieren.
  • Nach erfolgreichem Cutover alte Tokens widerrufen.
  • Secret-Dateien mit restriktiven Rechten und getrenntem Backup behandeln.
  • Keine SecretRefs aus Datei- oder Exec-Quellen blind in Klartext umwandeln.
  • Provider-Key und Messenger-Token getrennt testen und rotieren.

Cutover und Aufräumen ohne Rückweg zu verbauen

Wenn repräsentative Aufgaben, Messenger und Cron bestanden haben, stoppe OpenClaw, starte den produktiven Hermes-Gateway und beobachte mindestens einen vollständigen Betriebszyklus. Erst danach dürfen alte Verzeichnisse archiviert werden. Hermes bietet dafür einen Cleanup-Befehl, der Reste umbenennt, damit keine Zustandsverwechslung entsteht.

Nach bestätigter Migration
hermes claw cleanup

Häufige Fragen

Kann Hermes OpenClaw automatisch importieren?

Ja. hermes claw migrate erkennt aktuelle und ältere OpenClaw-/Clawdbot-/Moltbot-Verzeichnisse und erstellt vor Anwendung eine Vorschau.

Werden API-Keys automatisch migriert?

Nein. Secrets erfordern immer explizit --migrate-secrets, auch beim Full-Preset.

Werden OpenClaw-Skills übernommen?

Ja, aus mehreren Workspace- und Shared-Skill-Orten. Sie landen unter ~/.hermes/skills/openclaw-imports/; Konflikte können übersprungen, überschrieben oder umbenannt werden.

Muss WhatsApp neu verbunden werden?

Die offizielle Migrationsdokumentation weist darauf hin, dass QR-basierte WhatsApp-Verbindungen neu gepairt werden müssen.

Kann ich zurück zu OpenClaw?

Ja, wenn du vorab ein vollständiges Backup behältst, alte Tokens nicht sofort widerrufst und den Parallelbetrieb kontrolliert gestaltest. Nach endgültigem Cutover sollten alte Zugänge aus Sicherheitsgründen entzogen werden.

Quellen, Methodik und Aktualität

Dieser Beitrag wurde aus praktischer Arbeit mit Hermes Agent und den unten verlinkten Primärquellen erstellt. Produktstände ändern sich schnell; Versions- und Befehlsangaben wurden zuletzt am geprüft.

  1. Migrate from OpenClaw – Nous Research
  2. CLI Commands – hermes claw – Nous Research
  3. Hermes Agent Quickstart – Nous Research
  4. Hermes Agent GitHub – Nous Research