OmeniaClaw backup

Erstellen Sie ein lokales Backup-Archiv für OmeniaClaw-Zustand, Konfiguration, Auth-Profile, Channel-/Provider-Anmeldedaten, Sitzungen und optional Workspaces.

OmeniaClaw backup createOmeniaClaw backup create --output ~/BackupsOmeniaClaw backup create --dry-run --jsonOmeniaClaw backup create --verifyOmeniaClaw backup create --no-include-workspaceOmeniaClaw backup create --only-configOmeniaClaw backup verify ./2026-03-09T00-00-00.000Z-OmeniaClaw-backup.tar.gz

Hinweise

• Das Archiv enthält eine Datei manifest.json mit den aufgelösten Quellpfaden und dem Archivlayout.
• Die Standardausgabe ist ein zeitgestempeltes .tar.gz-Archiv im aktuellen Arbeitsverzeichnis.
• Wenn sich das aktuelle Arbeitsverzeichnis innerhalb eines gesicherten Quellbaums befindet, weicht OmeniaClaw für den Standardspeicherort des Archivs auf Ihr Home-Verzeichnis aus.
• Vorhandene Archivdateien werden niemals überschrieben.
• Ausgabepfade innerhalb der Quell-Zustands-/Workspace-Bäume werden abgelehnt, um eine Selbsteinbindung zu vermeiden.
• OmeniaClaw backup verify <archive> prüft, dass das Archiv genau ein Root-Manifest enthält, lehnt Archivpfade im Traversal-Stil ab und prüft, dass jede im Manifest deklarierte Nutzlast im Tarball vorhanden ist.
• OmeniaClaw backup create --verify führt diese Validierung direkt nach dem Schreiben des Archivs aus.
• OmeniaClaw backup create --only-config sichert nur die aktive JSON-Konfigurationsdatei.

Was gesichert wird

OmeniaClaw backup create plant Backup-Quellen aus Ihrer lokalen OmeniaClaw-Installation:

• Das Zustandsverzeichnis, das vom lokalen Zustands-Resolver von OmeniaClaw zurückgegeben wird, normalerweise ~/.OmeniaClaw
• Der aktive Konfigurationsdateipfad
• Das aufgelöste Verzeichnis credentials/, wenn es außerhalb des Zustandsverzeichnisses existiert
• Workspace-Verzeichnisse, die aus der aktuellen Konfiguration ermittelt werden, es sei denn, Sie übergeben --no-include-workspace

Modell-Auth-Profile sind bereits Teil des Zustandsverzeichnisses unter agents/<agentId>/agent/auth-profiles.json, sodass sie normalerweise vom Zustands-Backup-Eintrag abgedeckt sind.

Wenn Sie --only-config verwenden, überspringt OmeniaClaw die Ermittlung von Zustand, Anmeldedatenverzeichnis und Workspaces und archiviert nur den aktiven Konfigurationsdateipfad.

OmeniaClaw kanonisiert Pfade, bevor das Archiv erstellt wird. Wenn sich Konfiguration, das Anmeldedatenverzeichnis oder ein Workspace bereits innerhalb des Zustandsverzeichnisses befinden, werden sie nicht als separate Backup-Quellen auf oberster Ebene dupliziert. Fehlende Pfade werden übersprungen.

Die Archivnutzlast speichert Dateiinhalte aus diesen Quellbäumen, und die eingebettete manifest.json zeichnet die aufgelösten absoluten Quellpfade sowie das für jedes Asset verwendete Archivlayout auf.

Während der Archiverstellung überspringt OmeniaClaw bekannte Dateien mit Live-Änderungen, die keinen Wiederherstellungswert haben, einschließlich aktiver Agent-Sitzungstranskripte, Cron-Ausführungsprotokolle, rollierender Protokolle, Zustellwarteschlangen, Socket-/PID-/Temporärdateien unter dem Zustandsverzeichnis und zugehöriger Temporärdateien langlebiger Warteschlangen. Das JSON-Ergebnis enthält skippedVolatileCount, damit Automatisierung erkennen kann, wie viele Dateien absichtlich ausgelassen wurden.

Installierte Plugin-Quell- und Manifestdateien unter dem extensions/-Baum des Zustandsverzeichnisses werden einbezogen, ihre verschachtelten node_modules/-Abhängigkeitsbäume jedoch übersprungen. Diese Abhängigkeiten sind neu erstellbare Installationsartefakte; verwenden Sie nach der Wiederherstellung eines Archivs OmeniaClaw plugins update <id> oder installieren Sie das Plugin mit OmeniaClaw plugins install <spec> --force neu, wenn ein wiederhergestelltes Plugin fehlende Abhängigkeiten meldet.

Verhalten bei ungültiger Konfiguration

OmeniaClaw backup umgeht absichtlich die normale Konfigurations-Vorprüfung, damit es auch bei der Wiederherstellung helfen kann. Da die Workspace-Ermittlung von einer gültigen Konfiguration abhängt, schlägt OmeniaClaw backup create jetzt früh fehl, wenn die Konfigurationsdatei existiert, aber ungültig ist und Workspace-Backups weiterhin aktiviert sind.

Wenn Sie in dieser Situation trotzdem ein teilweises Backup möchten, führen Sie erneut aus:

OmeniaClaw backup create --no-include-workspace

Dadurch bleiben Zustand, Konfiguration und das externe Anmeldedatenverzeichnis im Umfang, während die Workspace-Ermittlung vollständig übersprungen wird.

Wenn Sie nur eine Kopie der Konfigurationsdatei selbst benötigen, funktioniert --only-config auch bei fehlerhaft formatierter Konfiguration, da es für die Workspace-Ermittlung nicht auf das Parsen der Konfiguration angewiesen ist.

Größe und Leistung

OmeniaClaw erzwingt keine integrierte maximale Backup-Größe und kein Größenlimit pro Datei.

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

• Verfügbarer Speicherplatz für das temporäre Schreiben des Archivs plus das endgültige Archiv
• Zeit zum Durchlaufen großer Workspace-Bäume und zum Komprimieren in eine .tar.gz
• Zeit zum erneuten Scannen des Archivs, wenn Sie OmeniaClaw backup create --verify verwenden oder OmeniaClaw backup verify ausführen
• Dateisystemverhalten am Zielpfad. OmeniaClaw bevorzugt einen Veröffentlichungsschritt per Hardlink ohne Überschreiben und fällt auf exklusives Kopieren zurück, wenn Hardlinks nicht unterstützt werden

Große Workspaces sind in der Regel der Hauptfaktor für die Archivgröße. Wenn Sie ein kleineres oder schnelleres Backup möchten, verwenden Sie --no-include-workspace.

Für das kleinste Archiv verwenden Sie --only-config.

Verwandt

• CLI-Referenz