openclaw backup

Erstelle ein lokales Backup-Archiv f\u00fcr OpenClaw-State, Konfiguration, Anmeldeinformationen, 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\u00e4lt eine manifest.json-Datei mit den aufgel\u00f6sten Quellpfaden und dem Archiv-Layout.
  • Standardausgabe ist ein zeitgestempeltes .tar.gz-Archiv im aktuellen Arbeitsverzeichnis.
  • Liegt das aktuelle Arbeitsverzeichnis innerhalb eines gesicherten Quellbaums, weicht OpenClaw auf dein Home-Verzeichnis als Standard-Archivort aus.
  • Bestehende Archivdateien werden nie \u00fcberschrieben.
  • Ausgabepfade innerhalb der Quell-State/Workspace-B\u00e4ume werden abgelehnt, um Selbsteinschluss zu vermeiden.
  • openclaw backup verify <archive> pr\u00fcft, ob das Archiv genau ein Root-Manifest enth\u00e4lt, lehnt Traversal-artige Archivpfade ab und \u00fcberpr\u00fcft, ob jeder im Manifest deklarierte Payload im Tarball existiert.
  • openclaw backup create --verify f\u00fchrt diese Validierung direkt nach dem Schreiben des Archivs durch.
  • openclaw backup create --only-config sichert nur die aktive JSON-Konfigurationsdatei.

Was gesichert wird

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

  • Das State-Verzeichnis, das vom lokalen OpenClaw State-Resolver zur\u00fcckgegeben wird, \u00fcblicherweise ~/.openclaw
  • Der aktive Config-Dateipfad
  • Das OAuth-/Anmeldeinformationen-Verzeichnis
  • Workspace-Verzeichnisse, die aus der aktuellen Konfiguration erkannt werden, es sei denn, du \u00fcbergibst --no-include-workspace

Mit --only-config \u00fcberspringt OpenClaw State, Anmeldeinformationen und Workspace-Erkennung und archiviert nur den aktiven Config-Dateipfad.

OpenClaw kanonisiert Pfade vor dem Erstellen des Archivs. Wenn Config, Anmeldeinformationen oder ein Workspace bereits innerhalb des State-Verzeichnisses liegen, werden sie nicht als separate Top-Level-Backup-Quellen dupliziert. Fehlende Pfade werden \u00fcbersprungen.

Der Archiv-Payload speichert Dateiinhalte aus diesen Quellb\u00e4umen, und die eingebettete manifest.json zeichnet die aufgel\u00f6sten absoluten Quellpfade sowie das verwendete Archiv-Layout f\u00fcr jedes Asset auf.

Verhalten bei ung\u00fcltiger Konfiguration

openclaw backup umgeht absichtlich den normalen Config-Preflight, damit es auch bei der Wiederherstellung helfen kann. Da die Workspace-Erkennung von einer g\u00fcltigen Konfiguration abh\u00e4ngt, bricht openclaw backup create jetzt schnell ab, wenn die Config-Datei existiert aber ung\u00fcltig ist und Workspace-Backup noch aktiviert ist.

Wenn du in dieser Situation trotzdem ein Teilbackup willst, f\u00fchre erneut aus:

openclaw backup create --no-include-workspace

Das beh\u00e4lt State, Config und Anmeldeinformationen im Scope, w\u00e4hrend die Workspace-Erkennung komplett \u00fcbersprungen wird.

Wenn du nur eine Kopie der Config-Datei selbst brauchst, funktioniert --only-config auch bei fehlerhafter Config, da es nicht auf das Parsen der Config f\u00fcr die Workspace-Erkennung angewiesen ist.

Gr\u00f6\u00dfe und Performance

OpenClaw erzwingt keine eingebaute maximale Backup-Gr\u00f6\u00dfe oder Dateigr\u00f6\u00dfenbegrenzung.

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

  • Verf\u00fcgbarer Speicherplatz f\u00fcr das tempor\u00e4re Archiv-Schreiben plus das finale Archiv
  • Zeit zum Durchlaufen gro\u00dfer Workspace-B\u00e4ume und deren Komprimierung in ein .tar.gz
  • Zeit zum erneuten Scannen des Archivs bei Verwendung von openclaw backup create --verify oder openclaw backup verify
  • Dateisystemverhalten am Zielpfad. OpenClaw bevorzugt einen No-Overwrite-Hardlink-Publish-Schritt und f\u00e4llt auf exklusives Kopieren zur\u00fcck, wenn Hardlinks nicht unterst\u00fctzt werden

Gro\u00dfe Workspaces sind \u00fcblicherweise der Haupttreiber der Archivgr\u00f6\u00dfe. F\u00fcr ein kleineres oder schnelleres Backup verwende --no-include-workspace.

F\u00fcr das kleinste Archiv verwende --only-config.

Weiter
Overview
arrow_forward