Konfigurations-Backups

Was sind Konfigurations-Backups?

Konfigurations-Backups sind automatische Schnappschüsse der openclaw.json-Konfigurationsdatei deiner Instanz. Sie sichern deine LLM-Einstellungen, Kanal-Konfiguration, Persönlichkeit, Fähigkeiten, Zeitgesteuerte Jobs und alle anderen Einstellungen in dieser Datei.

Das ist eine kostenlose Funktion, die in jeder Instanz enthalten ist. Kein Add-on oder Abo nötig.

Konfigurations-Backups unterscheiden sich vom Backup Add-on. Das Backup Add-on erstellt vollständige Server-Snapshots (Daten, Chatverlauf, Dateien). Konfigurations-Backups speichern nur die Konfigurationsdatei. Sie sind leichtgewichtig, schnell und laufen automatisch.

Was wird gesichert?

Enthalten	Details
LLM-Einstellungen	Anbieter, Modell, API-Schlüssel, Fallback-Modelle, Task-Modelle
Kanal-Konfiguration	Telegram-, Discord-, Slack-, WhatsApp-Tokens und Einstellungen
Persönlichkeit	System-Prompt, Agenten-Konfiguration
Fähigkeiten	Installierte Skills und deren Konfiguration
Zeitgesteuerte Jobs	Geplante Aufgaben
Gateway-Einstellungen	Auth-Modus, Bind-Modus, Proxy-Einstellungen
Umgebungsvariablen	Eigene Env-Variablen aus der Konfiguration

Was wird nicht gesichert?

Nicht enthalten	Stattdessen verwenden
Chatverlauf	Backup Add-on
Hochgeladene Dateien	Backup Add-on
Eigene Pakete	Backup Add-on
Pairing-Daten	Nach Wiederherstellung erneut koppeln

Backup-Zeitplan

Automatische Backups laufen zweimal täglich um 05:00 und 17:00 UTC. Jede laufende Instanz bekommt eine eigene Backup-Aufgabe in der Warteschlange. Wenn deine Instanz während eines Backup-Fensters gestoppt oder nicht erreichbar ist, wird das Backup für diesen Zyklus übersprungen.

Aufbewahrungsrichtlinie

Konfigurations-Backups folgen einer gestaffelten Aufbewahrungsrichtlinie:

Stufe	Aufbewahrung
Letzte 7 Tage	Alle Backups behalten (~14 insgesamt bei 2x/Tag)
14-Tage-Marke	1 Backup behalten (nächstes an 14 Tagen)
31-Tage-Marke	1 Backup behalten (nächstes an 31 Tagen)
Älter als 37 Tage	Automatisch gelöscht

Manuelle Backups werden nie automatisch gelöscht. Sie bleiben, bis du sie selbst entfernst.

Manuelles Backup erstellen

Du kannst jederzeit ein manuelles Backup über das Dashboard erstellen:

1. Öffne deine Instanz
2. Gehe zu Einstellungen > Konfig-Backups
3. Klicke auf Backup erstellen
4. Optional eine Beschreibung eingeben (z.B. "Vor LLM-Anbieterwechsel")

Manuelle Backups sind nützlich, bevor du größere Änderungen an deiner Konfiguration vornimmst. Falls etwas schiefgeht, kannst du den vorherigen Stand wiederherstellen.

Es gibt ein Limit von einem manuellen Backup pro Minute pro Instanz.

Backup-Vorschau

Klicke bei einem Backup auf Vorschau, um den Inhalt zu sehen. Die Vorschau zeigt die vollständige Konfiguration mit maskierten sensiblen Werten:

• API-Schlüssel erscheinen als sk-a...1234
• Bot-Tokens erscheinen als 1234...5678
• Passwörter und Geheimnisse sind maskiert

So kannst du überprüfen, was ein Backup enthält, bevor du es wiederherstellst, ohne deine Zugangsdaten preiszugeben.

Wiederherstellung aus einem Backup

1. Gehe zu Einstellungen > Konfig-Backups
2. Finde das Backup, das du wiederherstellen möchtest
3. Klicke auf das Wiederherstellen-Symbol
4. Lies die Warnung sorgfältig
5. Gib den Instanznamen zur Bestätigung ein
6. Klicke auf Konfiguration wiederherstellen

Die Wiederherstellung läuft als Hintergrund-Aufgabe. Deine Instanz wird mit der wiederhergestellten Konfiguration neu gestartet. Das dauert normalerweise unter einer Minute.

Was passiert bei einer Wiederherstellung

1. Die gespeicherte Konfiguration wird per SSH auf deine Instanz übertragen
2. OpenClaws Doctor prüft die Konfiguration
3. Das Gateway startet neu, um die Änderungen zu übernehmen
4. Gesundheitschecks überprüfen, ob die Instanz funktioniert

Wichtige Hinweise

• Die Wiederherstellung überschreibt deine aktuelle Konfiguration. Alle Änderungen nach dem Backup-Zeitpunkt gehen verloren.
• Deine Instanz startet kurz neu. Verbundene Messenger-Sitzungen müssen sich möglicherweise neu verbinden.
• Die Wiederherstellung ist nicht umkehrbar. Erstelle vorher ein manuelles Backup deiner aktuellen Konfiguration.
• API-Schlüssel werden unverändert wiederhergestellt. Wenn du Schlüssel seit dem Backup rotiert hast, enthält die wiederhergestellte Konfiguration die alten (möglicherweise ungültigen) Schlüssel.

Sicherheit

Konfigurations-Backups enthalten sensible Daten (API-Schlüssel, Bot-Tokens). Alle Backup-Daten werden in der Datenbank verschlüsselt gespeichert. In der Vorschau werden Geheimnisse maskiert, bevor sie an deinen Browser gesendet werden. Die vollständige unmaskierte Konfiguration wird nur bei Wiederherstellungen verwendet.

Konfigurations-Backups finden

Öffne dein Instanz-Dashboard und gehe zu Einstellungen > Konfig-Backups. Der Tab zeigt alle verfügbaren Backups sortiert nach Datum (neueste zuerst), mit Typ-Badges (Auto/Manuell), Beschreibungen, Dateigrößen und Aktions-Buttons.

Fehlerbehebung

Keine Backups sichtbar

• Automatische Backups starten innerhalb von 12 Stunden nach Erstellung der Instanz
• Deine Instanz muss laufen, damit Backups erstellt werden
• Wenn die Instanz während beider täglicher Backup-Fenster nicht erreichbar war, wurden keine Backups erstellt

Wiederherstellung fehlgeschlagen

• Deine Instanz muss laufen, um eine Konfiguration wiederherzustellen
• Prüfe das Aktivitätsprotokoll auf Fehlerdetails
• Wenn das Backup ungültige API-Schlüssel enthält, verbinden sich deine Kanäle nach der Wiederherstellung möglicherweise nicht. Aktualisiere die Schlüssel im Dashboard.
• Versuche die Wiederherstellung aus einem anderen Backup

Vorschau zeigt maskierte Werte

Das ist beabsichtigt. API-Schlüssel und Tokens werden in Vorschauen aus Sicherheitsgründen maskiert. Die tatsächlichen Werte bleiben im Backup erhalten und werden korrekt wiederhergestellt.

Verwandte Dokumentation

• Backup Add-on: Vollständige Server-Snapshots (Daten + Konfiguration + Dateien)
• Konfigurationseditor: Konfiguration direkt bearbeiten
• Instanz neu aufsetzen: Zurücksetzen auf Werkseinstellungen (löscht alles)