OpenClaw Backup Skill-Anleitung

OpenClaw Backup Skill Übersicht

Der Backup Skill gibt Ihrem OpenClaw-Agenten die Fähigkeit, Ihre gesamte Konfiguration zu sichern und wiederherzustellen — Skills, Befehle, Einstellungen, MCP-Integrationen, Kontexte und Vorlagen — mit einer einzigen Anfrage in natürlicher Sprache. Wenn Sie jemals ein funktionierendes Setup nach einem fehlgeschlagenen Update oder einem falsch konfigurierten Skill verloren haben, ist dies das Sicherheitsnetz, das Sie brauchen.

OpenClaw-Konfigurationen sind über mehrere Verzeichnisse und Dateien unter ~/.claude/ verteilt. Manuell zu verfolgen, was sich wann geändert hat, ist mühsam und fehleranfällig. Der OpenClaw Backup Skill automatisiert den gesamten Prozess: Er erstellt zeitgestempelte tar.gz-Archive, unterstützt selektive Backup-Modi und kann Ihr Setup über Git, rsync oder Cloud-Speicher wie Dropbox und Google Drive zwischen Geräten synchronisieren.

Typischer Workflow:

1. Bitten Sie OpenClaw, Ihr aktuelles Setup vor der Installation eines neuen Skills zu sichern.
2. Der Agent verpackt Ihre Konfiguration in ein zeitgestempeltes Archiv unter ~/openclaw-backups/.
3. Wenn etwas schiefgeht, bitten Sie OpenClaw, vom neuesten Backup wiederherzustellen — Ihr funktionierendes Setup ist in Sekunden zurück.

Dieser Skill ergänzt sich natürlich mit dem Config Guardian Skill, der Konfigurationsänderungen in Echtzeit validiert, und dem 1Password Skill für die sichere Verwaltung von API-Tokens in Ihren Backups.

Voraussetzungen für den Backup Skill

Bevor Sie den Backup Skill installieren, stellen Sie sicher, dass Sie haben:

• OpenClaw installiert und laufend (v1.0+)
• Ausreichend Festplattenspeicher für Backup-Archive (typischerweise 5–50 MB pro Snapshot je nach Skill-Anzahl)
• clawhub CLI installiert für Skill-Verwaltung
• Git (optional) — nur erforderlich, wenn Sie versionskontrollierten Backup-Verlauf möchten

Überprüfen Sie Ihr Setup:

# OpenClaw-Version prüfen
openclaw --version

# Verfügbaren Festplattenspeicher prüfen
df -h ~/openclaw-backups

# clawhub CLI prüfen
clawhub --version

Backup Skill Installationsanleitung

Installieren Sie den Backup Skill mit einem einzigen Befehl:

npx clawhub@latest install backup

Installation überprüfen:

clawhub list

Sie sollten backup in der Liste der installierten Skills sehen. Installieren Sie mit clawhub CLI für das schnellste Setup.

Backup Skill Konfiguration

Der Backup Skill funktioniert sofort mit sinnvollen Standardeinstellungen. Sie können das Verhalten über Umgebungsvariablen anpassen.

Umgebungsvariablen einrichten

# Benutzerdefiniertes Backup-Verzeichnis (Standard: ~/openclaw-backups)
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# Maximale Anzahl aufzubewahrender Backups (Standard: 7)
export OPENCLAW_BACKUP_RETENTION=7

# Automatische Backups vor Updates aktivieren (Standard: true)
export OPENCLAW_BACKUP_AUTO=true

Was gesichert wird

Der Skill archiviert standardmäßig folgende Verzeichnisse und Dateien:

| Pfad | Inhalt | |------|--------| | ~/.claude/skills/ | Installierte Skill-Definitionen | | ~/.claude/commands/ | Benutzerdefinierte Befehle | | ~/.claude/settings.json | Agenten-Einstellungen und Präferenzen | | ~/.claude/mcp/ | MCP-Server-Konfigurationen | | ~/.claude/contexts/ | Sitzungskontexte | | ~/.claude/templates/ | Benutzerdefinierte Vorlagen |

Cache- und Logdateien werden automatisch ausgeschlossen — sie werden beim Start neu generiert und würden nur das Archiv aufblähen.

Wichtig: Backup-Archive können API-Tokens, Geheimnisse und Zugangsdaten enthalten, die in Ihren Einstellungen oder MCP-Konfigurationen gespeichert sind. Bewahren Sie Backups an einem sicheren Ort auf und committen Sie sie niemals in öffentliche Repositories.

Backup Skill Verwendungsbeispiele

1. Vollständiges Backup erstellen

Sie: "Sichere mein gesamtes OpenClaw-Setup bevor ich den neuen Kubernetes Skill installiere."

Der Agent erstellt ein zeitgestempeltes Archiv (z.B. openclaw-2026-03-13_1045.tar.gz) mit allen Konfigurationsdateien. Nach Abschluss meldet er Archivpfad, Dateigröße und Elementanzahl.

2. Selektives Skills-Only-Backup

Sie: "Sichere nur meine installierten Skills, ich möchte testen, einige zu entfernen."

Der Agent führt ein reines Skill-Backup durch und archiviert nur das ~/.claude/skills/-Verzeichnis. Das ist schneller und erzeugt eine kleinere Datei, wenn Sie nur Skill-Definitionen schützen müssen.

3. Aus einem Backup wiederherstellen

Sie: "Nach dem Update ist etwas kaputt. Stelle aus meinem neuesten Backup wieder her."

Der Agent listet verfügbare Backups auf, zeigt das neueste mit Zeitstempel und Inhalt an und bittet vor der Wiederherstellung um Bestätigung. Er prüft zunächst die Archivintegrität, stoppt dann den Agenten, ersetzt die aktuelle Konfiguration und startet neu — Ihr funktionierendes Setup ist zurück.

4. Backups auflisten und verwalten

Sie: "Zeige mir alle meine Backups und wie viel Platz sie belegen."

Der Agent listet alle Archive in Ihrem Backup-Verzeichnis nach Datum sortiert mit Dateigrößen auf. Er markiert Backups, die den Aufbewahrungszeitraum überschreiten, und bietet an, sie aufzuräumen.

5. Backups zu einem Remote synchronisieren

Sie: "Push mein neuestes Backup in mein Git-Backup-Repository."

Der Agent committet das neueste Archiv in Ihr konfiguriertes Git-Repository und pusht es zum Remote. Dies ermöglicht Versionsverlauf und Multi-Geräte-Zugriff — klonen Sie das Repository auf einem anderen Rechner und stellen Sie aus jedem Snapshot wieder her.

Backup Sicherheit und Best Practices

Backup-Archive enthalten Ihre vollständige OpenClaw-Konfiguration, die sensible Daten enthalten kann. Befolgen Sie diese Richtlinien für Ihre Sicherheit:

• Sensible Backups verschlüsseln. Wenn Ihre Konfiguration API-Schlüssel oder Tokens enthält, verschlüsseln Sie Archive vor der Cloud-Speicherung. Verwenden Sie gpg oder Ihren Secret-Manager.
• Dateiberechtigungen einschränken. Backup-Dateien nur für Ihren Benutzer lesbar halten: chmod 700 ~/openclaw-backups.
• Backups niemals in öffentliche Repos committen. Fügen Sie ~/openclaw-backups/ zu Ihrer globalen .gitignore hinzu.
• Alte Backups rotieren. Setzen Sie OPENCLAW_BACKUP_RETENTION für automatische Bereinigung alter Archive. Sieben Backups sind ein vernünftiger Standard.
• Wiederherstellungen regelmäßig verifizieren. Testen Sie den Wiederherstellungsprozess, bevor Sie ihn wirklich brauchen. Stellen Sie in ein temporäres Verzeichnis wieder her, um die Archivintegrität zu bestätigen.
• Config Guardian zusammen mit Backup verwenden. Config Guardian validiert Änderungen in Echtzeit, während Backup Point-in-Time-Recovery bietet. Zusammen bilden sie ein vollständiges Sicherheitsnetz. Prüfen Sie die Sicherheits-Checkliste für allgemeine OpenClaw-Sicherheitsrichtlinien.

Häufige Backup-Fehler beheben

"No backups found in ~/openclaw-backups"

Das Backup-Verzeichnis ist leer oder existiert nicht.

1. Bestätigen Sie, dass das Verzeichnis existiert:

ls -la ~/openclaw-backups

2. Wenn Sie den Pfad angepasst haben, prüfen Sie, ob OPENCLAW_BACKUP_DIR korrekt gesetzt ist:

echo $OPENCLAW_BACKUP_DIR

3. Bitten Sie OpenClaw, das erste Backup zu erstellen: "Sichere jetzt meine Konfiguration."

"Permission denied when creating backup archive"

Das Backup-Verzeichnis ist nicht beschreibbar.

# Berechtigungen korrigieren
chmod 700 ~/openclaw-backups

# Oder fehlendes Verzeichnis erstellen
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

Das Archiv wurde während der Speicherung oder Übertragung beschädigt.

1. Archivintegrität testen:

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. Wenn beschädigt, versuchen Sie das vorherige Backup in der Aufbewahrungsliste.
3. Für Git-synchronisierte Backups prüfen Sie, ob ein älterer Commit ein intaktes Archiv hat: git log --oneline im Backup-Repository.