Agent Skill
2/7/2026

config-guardian

Validate and safeguard OpenClaw config updates (openclaw.json or openclaw config set/apply). Use this skill whenever changing gateway config, models, channels, agents, tools, sessions, or routing. Enforces backup, schema validation, and safe rollback before restarts.

O
openclaw
1074GitHub Stars
1Views
npx skills add openclaw/skills

SKILL.md

Nameconfig-guardian
DescriptionValidate and safeguard OpenClaw config updates (openclaw.json or openclaw config set/apply). Use this skill whenever changing gateway config, models, channels, agents, tools, sessions, or routing. Enforces backup, schema validation, and safe rollback before restarts.

name: config-guardian description: Safe OpenClaw config updates with automatic backup, validation, and rollback. For agent use - prevents invalid config updates.

Config Guardian

Overview

For Agent use only. Safe config updates with automatic backup, validation, and rollback. Prevents the agent from updating non-existent keys or invalid values.

When to Use

Use this skill every time you need to update openclaw.json. Prevents:

  • Updating non-existent config keys
  • Using invalid values
  • Breaking the gateway with bad config

Workflow: Atomic Apply (Default)

For all config changes - handles everything in one command:

./scripts/atomic_apply.sh <config_path> <new_value>
# Example: ./scripts/atomic_apply.sh "agents.defaults.model.primary" "minimax-portal/MiniMax-M2.5"

What it does:

  1. Creates timestamped backup automatically
  2. Applies change via openclaw config set <path> <value>
  3. Validates with openclaw doctor --non-interactive
  4. Auto-rollback if validation fails
  5. Trap ensures rollback even on crash

Backup location:

~/.openclaw/config-guardian-backups/

Guardrails

  • Never restart or apply config without explicit user approval
  • Always use atomic_apply.sh
  • If validation fails -> config auto-rolled back, don't force it

Scripts

ScriptPurpose
atomic_apply.shDefault - all-in-one safe apply
validate_config.shValidate via OpenClaw doctor
restore_config.shManual restore from backup
Skills Info
Original Name:config-guardianAuthor:openclaw