OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Migrationsleitfaden

OpenClaw unterstützt drei Migrationspfade: den Import aus einem anderen Agentensystem, das Verschieben einer bestehenden Installation auf einen neuen Rechner und das direkte Upgrade eines Plugins.

Aus einem anderen Agentensystem importieren

Mitgelieferte Migrations-Provider übernehmen Anweisungen, MCP-Server, Skills, die Modellkonfiguration und (optional) API-Schlüssel in OpenClaw. Pläne werden vor jeder Änderung in einer Vorschau angezeigt, und Geheimnisse werden in Berichten unkenntlich gemacht. Das eigenständige openclaw migrate wird durch eine verifizierte Sicherung abgesichert; bei einem neuen Onboarding werden lokale Artefakte stattdessen bereitgestellt und verifiziert, bevor sie veröffentlicht werden, wobei die Konfiguration vor jeder unumkehrbaren externen Aktivierung festgeschrieben wird.

Migration von Claude

Importieren Sie den Zustand von Claude Code und Claude Desktop, einschließlich CLAUDE.md, MCP-Servern, Skills und Projektbefehlen.
Migration von Hermes

Importieren Sie Hermes-Konfiguration, Provider, MCP-Server, Speicher, Skills und unterstützte .env-Schlüssel.

Der CLI-Einstiegspunkt ist openclaw migrate. Das Onboarding kann ebenfalls eine Migration anbieten, wenn es eine bekannte Quelle erkennt (openclaw onboard --flow import).

OpenClaw auf einen neuen Rechner verschieben

Kopieren Sie das Zustandsverzeichnis (standardmäßig ~/.openclaw/) und Ihren Arbeitsbereich, um Folgendes zu bewahren:

  • Konfiguration — openclaw.json und alle Gateway-Einstellungen.
  • Authentifizierung — agentenspezifische auth-profiles.json (API-Schlüssel plus OAuth) sowie jeglicher Kanal- oder Provider-Zustand unter credentials/.
  • Sitzungen — Gesprächsverlauf und Agentenzustand.
  • Kanalzustand — WhatsApp-Anmeldung, Telegram-Sitzung und Ähnliches.
  • Arbeitsbereichsdateien — MEMORY.md, USER.md, Skills und Prompts.

Migrationsschritte

  • Gateway anhalten und Sicherung erstellen

    Halten Sie auf dem alten Rechner das Gateway an, damit sich Dateien während des Kopierens nicht ändern, und erstellen Sie anschließend ein Archiv:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Wenn Sie mehrere Profile verwenden (beispielsweise ~/.openclaw-work), archivieren Sie jedes separat.

  • OpenClaw auf dem neuen Rechner installieren

    Installieren Sie die CLI (und bei Bedarf Node) auf dem neuen Rechner. Es ist unproblematisch, wenn das Onboarding ein neues ~/.openclaw/ erstellt — Sie überschreiben es im nächsten Schritt.

  • Zustandsverzeichnis und Arbeitsbereich kopieren

    Übertragen Sie das Archiv über scp, rsync -a oder ein externes Laufwerk und extrahieren Sie es anschließend:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Vergewissern Sie sich, dass versteckte Verzeichnisse enthalten waren und die Dateieigentümerschaft dem Benutzer entspricht, der das Gateway ausführen wird.

  • Doctor ausführen und überprüfen

    Führen Sie auf dem neuen Rechner Doctor aus, um Konfigurationsmigrationen anzuwenden und Dienste zu reparieren:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • Wenn Telegram oder Discord den standardmäßigen Umgebungsvariablen-Fallback verwendet (TELEGRAM_BOT_TOKEN oder DISCORD_BOT_TOKEN), prüfen Sie, ob die migrierte .env im Zustandsverzeichnis diese Schlüssel enthält, ohne die geheimen Werte auszugeben:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    openclaw doctor warnt außerdem, wenn für ein aktiviertes standardmäßiges Telegram- oder Discord-Konto kein Token konfiguriert ist und die entsprechende Umgebungsvariable für den Doctor-Prozess nicht verfügbar ist.

    Häufige Fallstricke

    Nicht übereinstimmendes Profil oder Zustandsverzeichnis

    Wenn das alte Gateway --profile oder OPENCLAW_STATE_DIR verwendet hat und das neue nicht, erscheinen Kanäle als abgemeldet und Sitzungen sind leer. Starten Sie das Gateway mit demselben Profil oder Zustandsverzeichnis, das Sie migriert haben, und führen Sie anschließend openclaw doctor erneut aus.

    Nur openclaw.json kopieren

    Die Konfigurationsdatei allein reicht nicht aus. Modell-Authentifizierungsprofile befinden sich unter agents/<agentId>/agent/auth-profiles.json, während Kanal- und Provider-Zustände unter credentials/ gespeichert sind. Migrieren Sie stets das gesamte Zustandsverzeichnis.

    Berechtigungen und Eigentümerschaft

    Wenn Sie die Dateien als root kopiert oder den Benutzer gewechselt haben, kann das Gateway die Anmeldedaten möglicherweise nicht lesen. Stellen Sie sicher, dass das Zustandsverzeichnis und der Arbeitsbereich dem Benutzer gehören, der das Gateway ausführt.

    Remote-Modus

    Wenn Ihre Benutzeroberfläche auf ein entferntes Gateway verweist, befinden sich die Sitzungen und der Arbeitsbereich auf dem entfernten Host. Migrieren Sie den Gateway-Host selbst, nicht Ihren lokalen Laptop. Siehe FAQ.

    Geheimnisse in Sicherungen

    Das Zustandsverzeichnis enthält Authentifizierungsprofile, Kanalanmeldedaten und weitere Provider-Zustände. Speichern Sie Sicherungen verschlüsselt, vermeiden Sie unsichere Übertragungskanäle und rotieren Sie Schlüssel, wenn Sie eine Offenlegung vermuten.

    Prüfliste zur Verifizierung

    Prüfen Sie auf dem neuen Rechner Folgendes:

    • [ ] openclaw status zeigt an, dass das Gateway ausgeführt wird.
    • [ ] Die Kanäle sind weiterhin verbunden (keine erneute Kopplung erforderlich).
    • [ ] Das Dashboard lässt sich öffnen und zeigt die vorhandenen Sitzungen an.
    • [ ] Die Arbeitsbereichsdateien (Speicher, Konfigurationen) sind vorhanden.

    Ein Plugin direkt aktualisieren

    Direkte Plugin-Upgrades behalten dieselbe Plugin-ID und dieselben Konfigurationsschlüssel bei, können aber den auf dem Datenträger gespeicherten Zustand in das aktuelle Layout verschieben. Pluginspezifische Upgrade-Anleitungen befinden sich bei den jeweiligen Kanälen:

    • Matrix-Migration: Einschränkungen bei der Wiederherstellung verschlüsselter Zustände, automatisches Snapshot-Verhalten und manuelle Wiederherstellungsbefehle.

    Verwandte Themen

    Was this useful?
    On this page

    On this page