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 Aktualisieren eines Plugins.

Aus einem anderen Agentensystem importieren

Mitgelieferte Migrations-Provider übernehmen Anweisungen, MCP-Server, Skills, Modellkonfigurationen und (nach ausdrücklicher Zustimmung) API-Schlüssel in OpenClaw. Pläne werden vor jeder Änderung als Vorschau angezeigt, Geheimnisse werden in Berichten unkenntlich gemacht und die Anwendung wird durch eine verifizierte Sicherung abgesichert.

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 die Hermes-Konfiguration, Provider, MCP-Server, den 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 erhalten:

  • Konfiguration — openclaw.json und alle Gateway-Einstellungen.
  • Authentifizierung — die agentenspezifische Datei auth-profiles.json (API-Schlüssel und OAuth) sowie sämtliche Kanal- oder Provider-Zustände 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 die 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 einzeln.

  • 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 entpacken 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 Rückgriff auf Umgebungsvariablen (TELEGRAM_BOT_TOKEN oder DISCORD_BOT_TOKEN) verwendet, überprüfen Sie, ob die migrierte .env-Datei 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 dem Doctor-Prozess nicht zur Verfügung steht.

    Häufige Fallstricke

    Abweichendes 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. Authentifizierungsprofile für Modelle befinden sich unter agents/<agentId>/agent/auth-profiles.json, Kanal- und Provider-Zustände unter credentials/. 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 Zugangsdaten 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 Sitzungen und 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, Kanalzugangsdaten und weitere Provider-Zustände. Speichern Sie Sicherungen verschlüsselt, vermeiden Sie unsichere Übertragungswege 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 vorhandene Sitzungen an.
    • [ ] Die Arbeitsbereichsdateien (Speicher, Konfigurationen) sind vorhanden.

    Ein Plugin direkt aktualisieren

    Direkte Plugin-Aktualisierungen behalten dieselbe Plugin-ID und dieselben Konfigurationsschlüssel bei, können jedoch den auf dem Datenträger gespeicherten Zustand in die aktuelle Verzeichnisstruktur verschieben. Pluginspezifische Aktualisierungsanleitungen befinden sich bei den jeweiligen Kanälen:

    • Matrix-Migration: Einschränkungen bei der Wiederherstellung des verschlüsselten Zustands, Verhalten automatischer Snapshots und Befehle zur manuellen Wiederherstellung.

    Verwandte Themen

    Was this useful?
    On this page

    On this page