OpenClaw Config Validator

The authoritative configuration validation and management toolkit for OpenClaw

openclaw-config-validator is a comprehensive skill that provides:

• 📚 Complete schema documentation for OpenClaw 2026.2.1
• ✅ Validation tools to check your configuration
• 🛡️ Safety guidelines to prevent common errors
• 🔍 Official JSON Schema from the OpenClaw project

# Clone into your OpenClaw skills directory
cd ~/.openclaw/workspace/skills
git clone https://github.com/yourusername/openclaw-config-validator.git

# Validate your current configuration
cd openclaw-config-validator
./scripts/schema-validate.sh

# Read the complete schema reference
cat reference/SCHEMA.md

• get-schema.sh - Extract runtime schema from your live configuration
• schema-validate.sh - Validate configuration and detect issues

• ⚠️ Risk levels marked for each configuration node
• 🚫 Forbidden fields list (fields that don't exist in OpenClaw)
• ✅ Pre-modification checklist - 7 steps to safe config changes
• 🔄 Rollback procedures - Recovery when things go wrong

The main documentation is in reference/SCHEMA.md:

# Quick lookup
cat reference/SCHEMA.md | grep -A 10 "gateway"

# Full read
cat reference/SCHEMA.md

• 🚨 Checklist - Must-read before any config changes
• 🚫 Forbidden Fields - What NOT to add
• 📋 Node Reference - Quick lookup for all 22 nodes

# Basic validation
./scripts/schema-validate.sh

# Detailed output
./scripts/schema-validate.sh --verbose

# Generate report
./scripts/schema-validate.sh --report

# See your current config structure
./scripts/get-schema.sh

# Save to file
./scripts/get-schema.sh > my-runtime-schema.md

# Install ajv-cli
npm install -g ajv-cli

# Validate with official schema
ajv validate \
  -s reference/openclaw-official-schema.json \
  -d ~/.openclaw/openclaw.json

This skill documents all 22 top-level nodes, including these additions:

// ❌ WRONG - web.braveApiKey doesn't exist
{
  "web": {
    "braveApiKey": "..."
  }
}

// ✅ CORRECT - use environment variable
// export BRAVE_API_KEY=... in your shell

// ❌ WRONG - gateway is read-only
{
  "gateway": {
    "port": 99999  // Don't change this!
  }
}

# Always backup first
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup.$(date +%s)

# Use jq for modifications
jq '.agents.defaults.model.primary = "new-model"' \
  ~/.openclaw/openclaw.json > /tmp/new.json

# Validate before applying
openclaw doctor

• OpenClaw Official Docs
• OpenClaw GitHub
• OpenClaw Discord

Contributions welcome! Please:

1. Follow the existing documentation style
2. Test changes with schema-validate.sh
3. Update SCHEMA.md if adding new nodes
4. Submit PR with clear description

MIT License - See LICENSE for details.

Schema is the boundary, not the permission.
Know where the boundary is.

Created by Galatea 🜁