OpenClaw Backups erstellen: Daten in Sekunden sichern

Kennst du das? Du hast Stunden damit verbracht, dein Setup perfekt zu konfigurieren, und plötzlich passiert das Unerwartete. Ohne eine Sicherung deiner Daten fängst du wieder bei Null an. Damit dir das bei OpenClaw erspart bleibt, gibt es ein eingebautes Tool, das dir den Rücken freihält.

openclaw backup

Erstelle ein lokales Backup-Archiv für den OpenClaw State, die Config, Credentials, Sessions und optional Workspaces.

openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

Hinweise

• Das Archiv enthält eine manifest.json Datei mit den aufgelösten Quellpfaden und dem Archiv-Layout.
• Der Standard-Output ist ein mit einem Zeitstempel versehenes .tar.gz Archiv im aktuellen Arbeitsverzeichnis.
• Wenn sich das aktuelle Arbeitsverzeichnis innerhalb eines gesicherten Quellbaums befindet, weicht OpenClaw für den Standard-Speicherort des Archivs auf dein Home-Verzeichnis aus.
• Bestehende Archivdateien werden niemals überschrieben.
• Output-Pfade innerhalb der State- oder Workspace-Bäume werden abgelehnt, um Selbsteinschlüsse zu verhindern.
• openclaw backup verify <archive> validiert, dass das Archiv genau ein Root-Manifest enthält, lehnt Traversal-Style Pfade ab und prüft, ob jedes im Manifest deklarierte Payload im Tarball existiert.
• openclaw backup create --verify führt diese Validierung sofort nach dem Schreiben des Archivs aus.
• openclaw backup create --only-config sichert nur die aktive JSON Config-Datei.

Was gesichert wird

openclaw backup create plant die Backup-Quellen deiner lokalen OpenClaw-Installation:

• Das State-Verzeichnis, das vom lokalen State-Resolver von OpenClaw zurückgegeben wird (normalerweise ~/.openclaw).
• Der Pfad der aktiven Config-Datei.
• Das Verzeichnis für OAuth / Credentials.
• Workspace-Verzeichnisse, die aus der aktuellen Config ermittelt werden, sofern du nicht --no-include-workspace übergibst.

Wenn du --only-config verwendest, überspringt OpenClaw den State, die Credentials sowie die Workspace-Suche und archiviert lediglich den Pfad der aktiven Config-Datei.

OpenClaw bereinigt die Pfade (Canonicalization), bevor das Archiv erstellt wird. Wenn die Config, die Credentials oder ein Workspace bereits innerhalb des State-Verzeichnisses liegen, werden sie nicht als separate Top-Level-Quellen dupliziert. Fehlende Pfade werden übersprungen.

Das Archiv speichert die Dateiinhalte dieser Quellbäume. Die eingebettete manifest.json zeichnet die aufgelösten absoluten Quellpfade sowie das für jedes Asset verwendete Archiv-Layout auf.

Verhalten bei ungültiger Konfiguration

openclaw backup umgeht absichtlich den normalen Config-Preflight, damit es dir auch bei einer Wiederherstellung helfen kann. Da die Suche nach Workspaces von einer gültigen Config abhängt, bricht openclaw backup create sofort ab, wenn die Config-Datei zwar existiert, aber ungültig ist und das Workspace-Backup aktiviert bleibt.

Falls du in dieser Situation dennoch ein partielles Backup erstellen möchtest, führe diesen Befehl aus:

openclaw backup create --no-include-workspace

Dadurch bleiben State, Config und Credentials im Fokus, während die Workspace-Suche komplett übersprungen wird.

Wenn du nur eine Kopie der Config-Datei selbst benötigst, funktioniert --only-config auch bei einer fehlerhaften Config, da hierfür kein Parsing der Config für die Workspace-Suche nötig ist.

Größe und Performance

OpenClaw erzwingt keine eingebaute maximale Backup-Größe oder ein Größenlimit pro Datei.

Praktische Limits ergeben sich aus der lokalen Maschine und dem Ziel-Dateisystem:

• Verfügbarer Speicherplatz für den temporären Schreibvorgang plus das finale Archiv.
• Zeitaufwand, um große Workspace-Bäume zu durchlaufen und in ein .tar.gz zu komprimieren.
• Zeit für den Rescan des Archivs, wenn du openclaw backup create --verify nutzt oder openclaw backup verify ausführst.
• Verhalten des Dateisystems am Zielpfad. OpenClaw bevorzugt einen Hard-Link-Schritt ohne Überschreiben und nutzt einen exklusiven Kopiervorgang, falls Hard-Links nicht unterstützt werden.

Große Workspaces sind meist der Hauptgrund für massive Archive. Wenn du ein kleineres oder schnelleres Backup willst, verwende --no-include-workspace.

Für das kleinste Archiv verwendest du --only-config.

AI Setup Assistant

Nächste Schritte

• OpenClaw Restore Guide
• Managing Credentials