OpenClaw auf eine neue Maschine migrieren

Diese Anleitung migriert ein OpenClaw Gateway von einer Maschine auf eine andere ohne das Onboarding zu wiederholen.

Konzeptionell ist es einfach:

Kopiere das Status-Verzeichnis ($OPENCLAW_STATE_DIR, Standard: ~/.openclaw/) — enthält Config, Auth, Sessions und Channel-Status.
Kopiere deinen Workspace (Standard ~/.openclaw/workspace/) — enthält Agenten-Dateien (Memory, Prompts usw.).

Aber es gibt häufige Fallstricke bei Profilen, Berechtigungen und unvollständigen Kopien.

Bevor du anfängst

Die meisten Installationen nutzen den Standard:

Es kann anders sein, wenn du --profile <name> oder OPENCLAW_STATE_DIR=/some/path verwendest.

Dein Workspace ist dort, wo Dateien wie MEMORY.md, USER.md und memory/*.md leben.

Wenn du beides kopierst, bleiben erhalten: Gateway-Konfiguration, Auth-Profile, Session-Verlauf, Channel-Status und Workspace-Dateien.

Wenn du nur den Workspace kopierst: Sessions, Credentials und Channel-Logins gehen verloren.

openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw

Kopiere beides per scp, rsync -a oder externem Laufwerk.

openclaw doctor
openclaw gateway restart
openclaw status

Profil-/Status-Verzeichnis-Mismatch: Verwende dasselbe Profil/Status-Verzeichnis wie auf der alten Maschine.
Nur openclaw.json kopiert: Das reicht nicht. Migriere immer den gesamten $OPENCLAW_STATE_DIR-Ordner.
Berechtigungen/Besitz: Stelle sicher, dass Status-Verzeichnis + Workspace dem Benutzer gehören, der das Gateway ausführt.
Secrets in Backups: $OPENCLAW_STATE_DIR enthält Secrets. Behandle Backups wie Produktions-Secrets.

Auf der neuen Maschine überprüfen: