openclaw-config-validator

Validate and diagnose OpenClaw configuration files with detailed error reporting and security checks.

Features

• ✓ Validates openclaw.json structure and required fields
• ✓ Detects security misconfigurations
• ✓ Reports tool status and connectivity
• ✓ Provides actionable warnings and diagnostics
• ✓ JSON output for automation
• ✓ Zero dependencies

Installation

npm install -g openclaw-config-validator

Or use with npx:

npx openclaw-config-validator

Usage

Basic validation

openclaw-validate

Validate custom config

openclaw-validate --config /path/to/openclaw.json

JSON output (for scripting)

openclaw-validate --json | jq '.errors'

Strict mode (fail on warnings)

openclaw-validate --strict

Output Format

=== OpenClaw Config Validation Report ===
Path: /home/user/.openclaw/openclaw.json
Status: ✓ VALID

ERRORS:
  ✗ Missing required field: gateway

WARNINGS:
  ⚠ gateway.token is missing (may use env var)

INFO:
  ℹ Gateway URL: http://localhost:18789
  ℹ Configured tools: 12

JSON Output Example

{
  "valid": true,
  "errors": [],
  "warnings": ["gateway.token is missing"],
  "info": ["Gateway URL: http://localhost:18789"],
  "config_path": "/home/user/.openclaw/openclaw.json"
}

Exit Codes

• 0 - Valid configuration (or valid with warnings in normal mode)
• 1 - Invalid configuration, or warnings in --strict mode

Security Checks

The validator checks for:

• Disabled security features (exec-sandbox)
• Unrestricted agent-to-agent access
• Missing credentials
• Tool availability issues

License

MIT