jzOcb/config-guard

Was macht config-guard?

Verhindert, dass KI-Agenten OpenClaw zum Absturz bringen, indem Konfigurationsänderungen validiert werden. Automatische Backups, Schema-Validierung und automatischer Rollback.

Funktionen

• Automatische Backups: Vor jeder Konfigurationsänderung wird automatisch ein Backup der aktuellen Konfiguration erstellt.
• Schema-Validierung: Jede Änderung wird gegen ein vordefiniertes JSON-Schema validiert, um Fehler zu vermeiden.
• Automatischer Rollback: Wenn eine Änderung das Schema nicht besteht oder zu einem Fehler führt, wird automatisch auf die letzte stabile Konfiguration zurückgesetzt.

Verwendung

1. Aktivieren: config-guard enable – Aktiviert den Schutz für die angegebene Konfigurationsdatei.
2. Deaktivieren: config-guard disable – Deaktiviert den Schutz, erhält aber vorhandene Backups.
3. Status prüfen: config-guard status – Zeigt an, ob der Schutz aktiv ist und wie viele Backups vorhanden sind.

Konfiguration

Die Fähigkeit kann über folgende Umgebungsvariablen oder eine Konfigurationsdatei gesteuert werden:

• CONFIG_PATH – Pfad zur OpenClaw-Konfigurationsdatei (Standard: /etc/openclaw/config.yml).
• BACKUP_DIR – Verzeichnis für Backups (Standard: /var/backups/openclaw).
• SCHEMA_PATH – Pfad zur JSON-Schemadatei (Standard: /etc/openclaw/config-schema.json).

Schema-Definition

Erstellen Sie eine JSON-Schemadatei am angegebenen Pfad, um die erlaubte Konfigurationsstruktur zu definieren. Beispiel:

{
  "type": "object",
  "properties": {
    "server": {
      "type": "object",
      "properties": {
        "port": { "type": "integer", "minimum": 1024 },
        "host": { "type": "string" }
      },
      "required": ["port", "host"]
    },
    "database": {
      "type": "object",
      "properties": {
        "url": { "type": "string" },
        "poolSize": { "type": "integer", "minimum": 1 }
      },
      "required": ["url"]
    }
  },
  "required": ["server", "database"]
}

Logging

Alle Aktionen werden in /var/log/config-guard.log protokolliert. Verwenden Sie tail -f /var/log/config-guard.log, um Ereignisse in Echtzeit zu verfolgen.

Fehlerbehebung

• Konfiguration wird nicht validiert: Überprüfen Sie, ob CONFIG_PATH und SCHEMA_PATH korrekt gesetzt sind.
• Backup fehlgeschlagen: Stellen Sie sicher, dass das BACKUP_DIR beschreibbar ist und genügend Speicherplatz vorhanden ist.
• Rollback wird nicht ausgelöst: Prüfen Sie, ob die Schema-Datei gültig ist und den Änderungen entspricht.

Unterstützte Plattformen

• Claude Code
• Cursor
• Codex CLI
• Andere KI-Agenten, die OpenClaw konfigurieren

Lizenz

MIT