🤖HermesBlog
Hermes-Praxisleitfäden · Teil 248/9/2026

Migration von OpenClaw

Migration von OpenClaw – leicht verständlicher Leitfaden basierend auf offiziellen Dokumenten

Der Umzug in ein neues Zuhause ist stressig – aber stell dir vor, eine Umzugsfirma würde deine Kartons packen, alles beschriften und sogar deine Möbel die Treppe hochtragen. Genau das macht das Migrationswerkzeug von Hermes Agent, wenn du von OpenClaw (oder seinen älteren Verwandten Clawdbot und Moldbot) wechselst. Kein manuelles Kopieren, keine verlorenen Erinnerungen, keine Tränen.

guide-migrate-openclaw

Was macht das Migrationswerkzeug?

Stell dir hermes claw migrate wie dein persönliches Umzugsteam vor. Es liest alles aus deiner alten OpenClaw-Installation (normalerweise in ~/.openclaw/) und legt es ordentlich in deinem neuen Hermes-Zuhause (~/.hermes/) ab. Es kümmert sich um:

  • Persönlichkeit und Anweisungen – Deine SOUL.md-Datei (der “Charakter” deines Agents) wird direkt kopiert.
  • Arbeitsbereichsregeln – Die AGENTS.md-Datei (wie sich dein Agent in Projekten verhalten soll) wandert an den von dir gewählten Ort.
  • Langzeitgedächtnis – Deine MEMORY.md-Datei wird in einzelne Einträge zerlegt, mit vorhandenen Erinnerungen zusammengeführt und dedupliziert, damit du keine Wiederholungen bekommst.

Der einfache Einstieg

Öffne dein Terminal und führe diesen einen Befehl aus:

hermes claw migrate

Das Werkzeug zeigt dir eine Vorschau von allem, was es verschieben möchte. Prüfe die Liste, tippe “yes” zur Bestätigung ein, und fertig. So einfach ist das.

Erst mal nur gucken?

Wenn du bei Änderungen nervös bist, mach zuerst einen Probelauf:

hermes claw migrate --dry-run

Das zeigt dir den kompletten Plan, ohne etwas anzufassen. Stell es dir vor wie einen Rundgang durch deine neue Wohnung, bevor du den Mietvertrag unterschreibst.

API-Schlüssel umziehen (optional, aber wichtig)

Standardmäßig kopiert die Migration keine API-Schlüssel (wie OpenAI- oder Anthropic-Zugangsdaten). Wenn du die auch mitnehmen willst, musst du das explizit sagen:

hermes claw migrate --preset full --migrate-secrets --yes

Das --migrate-secrets-Flag ist dein Sicherheitsschalter – es stellt sicher, dass Schlüssel niemals stillschweigend ohne dein Wissen verschoben werden.

Was, wenn etwas schiefgeht?

Hermes hat deinen Rücken. Bevor es Änderungen vornimmt, erstellt es ein Backup-Zip deines aktuellen ~/.hermes/-Ordners. Wenn etwas komisch wirkt, kannst du alles wiederherstellen mit:

hermes import

Das Backup liegt unter ~/.hermes/backups/pre-migration-*.zip. Es ist wie ein “Vorher”-Foto deiner Wohnung – du kannst immer alles zurücklegen.

Ein paar Extra-Tipps

  • Legacy-Nutzer: Wenn du von ~/.clawdbot/ oder ~/.moltbot/ kommst, keine Sorge – Hermes erkennt diese Ordner automatisch.
  • Konflikte? Wenn Hermes Dateien findet, die bereits existieren, weigert es sich standardmäßig, sie zu überschreiben. Du kannst es mit --overwrite erzwingen oder Konflikte mit --skill-conflict rename umbenennen lassen.
  • Multi-Provider-Setups: Wenn du vorher mehrere KI-Anbieter genutzt hast, bündelt hermes setup --portal alles in einem einzigen OAuth-Login mit Zugriff auf über 300 Modelle.

Das Fazit

Migration muss kein Kopfschmerz sein. Mit hermes claw migrate bekommst du eine Vorschau, ein Sicherheits-Backup und eine saubere Übertragung von Persönlichkeit, Erinnerungen und Regeln deines Agents – alles in einem einzigen Befehl.

Praxistipp: Führe zuerst hermes claw migrate --dry-run aus, prüfe die Liste sorgfältig und starte dann die echte Migration. Bewahre das Backup-Zip mindestens eine Woche lang an einem sicheren Ort auf. Dein zukünftiges Ich wird es dir danken.


📖 Offizielle Dokumentation

この記事は Hermes Agent のOffizielle Dokumentationに基づいています:Offizielle Dokumentation › guides/migrate-from-openclaw