Zum Hauptinhalt springen

​
OpenClaw auf einen neuen Rechner migrieren

Diese Anleitung verschiebt ein OpenClaw-Gateway auf einen neuen Rechner, ohne das Onboarding erneut durchführen zu müssen.

​
Was migriert wird

Wenn Sie das Zustandsverzeichnis (~/.openclaw/ standardmäßig) und Ihren Workspace kopieren, bleiben folgende Dinge erhalten:
  • Konfiguration — openclaw.json und alle Gateway-Einstellungen
  • Authentifizierung — auth-profiles.json pro Agent (API-Schlüssel + OAuth) sowie jeder Kanal-/Provider-Zustand unter credentials/
  • Sitzungen — Konversationsverlauf und Agent-Zustand
  • Kanalzustand — WhatsApp-Anmeldung, Telegram-Sitzung usw.
  • Workspace-Dateien — MEMORY.md, USER.md, Skills und Prompts
Führen Sie openclaw status auf dem alten Rechner aus, um den Pfad Ihres Zustandsverzeichnisses zu bestätigen. Benutzerdefinierte Profile verwenden ~/.openclaw-<profile>/ oder einen Pfad, der über OPENCLAW_STATE_DIR gesetzt ist.

​
Migrationsschritte

1

Gateway stoppen und Backup erstellen

Stoppen Sie auf dem alten Rechner das Gateway, damit sich Dateien während des Kopierens nicht ändern, und archivieren Sie dann:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Wenn Sie mehrere Profile verwenden (z. B. ~/.openclaw-work), archivieren Sie jedes separat.
2

OpenClaw auf dem neuen Rechner installieren

Installieren Sie die CLI (und Node, falls nötig) auf dem neuen Rechner. Es ist in Ordnung, wenn das Onboarding ein frisches ~/.openclaw/ erstellt — Sie überschreiben es im nächsten Schritt.
3

Zustandsverzeichnis und Workspace kopieren

Übertragen Sie das Archiv per scp, rsync -a oder über ein externes Laufwerk und entpacken Sie es dann:
cd ~
tar -xzf openclaw-state.tgz
Stellen Sie sicher, dass versteckte Verzeichnisse eingeschlossen wurden und der Eigentümer der Dateien mit dem Benutzer übereinstimmt, der das Gateway ausführen wird.
4

Doctor ausführen und prüfen

Führen Sie auf dem neuen Rechner Doctor aus, um Konfigurationsmigrationen anzuwenden und Services zu reparieren:
openclaw doctor
openclaw gateway restart
openclaw status

​
Häufige Stolperfallen

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 State-Dir, das Sie migriert haben, und führen Sie dann openclaw doctor erneut aus.
Die Konfigurationsdatei allein reicht nicht aus. Modell-Auth-Profile befinden sich unter agents/<agentId>/agent/auth-profiles.json, und Kanal-/Provider-Zustand liegt weiterhin unter credentials/. Migrieren Sie immer das gesamte Zustandsverzeichnis.
Wenn Sie als Root kopiert oder Benutzer gewechselt haben, kann das Gateway die Anmeldedaten möglicherweise nicht lesen. Stellen Sie sicher, dass das Zustandsverzeichnis und der Workspace dem Benutzer gehören, der das Gateway ausführt.
Wenn Ihre UI auf ein Remote-Gateway zeigt, besitzt der Remote-Host Sitzungen und Workspace. Migrieren Sie den Gateway-Host selbst, nicht Ihren lokalen Laptop. Siehe FAQ.
Das Zustandsverzeichnis enthält Auth-Profile, Kanal-Anmeldedaten und anderen Provider-Zustand. Speichern Sie Backups verschlüsselt, vermeiden Sie unsichere Übertragungskanäle und rotieren Sie Schlüssel, wenn Sie eine Offenlegung vermuten.

​
Checkliste zur Verifizierung

Prüfen Sie auf dem neuen Rechner:
  • openclaw status zeigt, dass das Gateway läuft
  • Kanäle sind noch verbunden (kein erneutes Pairing erforderlich)
  • Das Dashboard öffnet sich und zeigt vorhandene Sitzungen
  • Workspace-Dateien (Speicher, Konfigurationen) sind vorhanden