OpenClaw auf einen neuen Rechner umziehen

Ein neuer Rechner bedeutet meistens viel Arbeit, bis alle Tools wieder so laufen wie vorher. Besonders nervig ist es, wenn du mühsam konfigurierte Umgebungen verliert oder das Onboarding komplett neu durchlaufen musst, nur weil die Hardware wechselt.

Wenn du dein OpenClaw Gateway umziehst, willst du sicherstellen, dass alle Sessions, API-Keys und dein Agent-Gedächtnis erhalten bleiben. Dieser Guide zeigt dir den direkten Weg, wie du alles ohne Datenverlust migrierst.

Voraussetzungen

Bevor du startest, stelle sicher, dass du folgende Informationen und Zugänge hast:

Zugriff auf die alte Maschine
Das identifizierte State Directory ($OPENCLAW_STATE_DIR)
Den Pfad zu deinem Workspace
Die neue Maschine mit installierter CLI (und Node.js)

Quick Start (5 Minuten Migration)

Folge diesen Schritten für den empfohlenen Migrationspfad.

Schritt 0 — Backup erstellen (alte Maschine)

Stoppe zuerst das Gateway auf der alten Maschine, damit keine Dateien während des Kopierens verändert werden:

openclaw gateway stop

Identifiziere deine Pfade mit openclaw status. Erstelle danach Archive für den State und den Workspace:

# Pfade anpassen, falls du Profile oder benutzerdefinierte Orte nutzt
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace

Schritt 1 — OpenClaw auf der neuen Maschine installieren

Installiere die CLI auf deinem neuen Rechner. Es ist kein Problem, wenn das automatische Onboarding einen frischen Ordner unter ~/.openclaw/ erstellt – diesen überschreibst du im nächsten Schritt.

Schritt 2 — Daten übertragen

Kopiere sowohl das State Directory (Standard: ~/.openclaw/) als auch deinen Workspace auf die neue Maschine. Nutze dafür Tools wie scp, rsync oder ein externes Laufwerk. Achte darauf, dass versteckte Ordner eingeschlossen sind und die Dateiberechtigungen für deinen User stimmen.

Schritt 3 — Doctor ausführen

Auf der neuen Maschine führst du diesen Befehl aus:

openclaw doctor

Das Tool repariert Services, führt Konfigurations-Migrationen durch und prüft auf Fehler. Danach kannst du alles starten:

openclaw gateway restart
openclaw status

Fehlerbehebung

Hier sind häufige Probleme, die beim Umzug auftreten können:

Profile / State-Dir Mismatch Wenn du auf dem alten Rechner ein --profile genutzt hast, das neue Gateway aber das Standardprofil lädt, fehlen Sessions und Channels. Starte das Gateway mit dem exakt gleichen Profilnamen wie zuvor und führe openclaw doctor erneut aus.

Nur die openclaw.json kopiert Die Datei openclaw.json reicht nicht aus. Viele Provider speichern Daten unter:

$OPENCLAW_STATE_DIR/credentials/
$OPENCLAW_STATE_DIR/agents/<agentId>/ Kopiere immer den kompletten Ordner.

Berechtigungen und Ownership Falls du Daten als Root kopiert hast, kann das Gateway eventuell nicht auf Credentials zugreifen. Stelle sicher, dass dein aktueller User Besitzer aller Dateien im State Directory und Workspace ist.

Remote vs. Local Mode Wenn deine UI auf ein Remote Gateway zeigt, liegen die Daten auf dem Remote Host. Ein Umzug deines Laptops ändert nichts an den Daten des Gateways. In diesem Fall musst du den Gateway-Host migrieren.

Secrets in Backups Dein State Directory enthält API-Keys und Session-Tokens. Behandle Backups wie Produktions-Secrets: Verschlüssele sie und rotiere Keys, falls du vermutest, dass die Daten ungeschützt übertragen wurden.

Hast du Fragen zum Setup? Nutze den AI Setup Assistant.

Nächste Schritte

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.