An automated utility for validating OpenClaw configuration fields against official Zod schemas to ensure configuration integrity.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install config-field
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install config-field using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Config Field Validator?
The Config Field Validator is a specialized tool designed to maintain the integrity of your configuration files. It validates entries in the openclaw.json file against the official Zod schema, covering over 136 field definitions including agents, channels, and logging settings. By integrating this into your workflow, you ensure that every configuration change is syntactically correct and schema-compliant.
As a core component within the ecosystem of Openclaw Skills, this tool automates the lifecycle of schema management. It detects your current version, fetches the appropriate TypeScript schema from GitHub, and parses it to provide real-time validation. This prevents runtime errors and simplifies the process of managing complex AI agent environments.
Config Field Validator Use Cases
- Verifying the existence and validity of a field before making manual edits to the configuration.
- Debugging system errors caused by incorrectly formatted or invalid configuration values.
- Streamlining the migration of configuration files during version upgrades to ensure continued compatibility.
- Reviewing and auditing existing setups to ensure all fields align with current schema standards.
How Config Field Validator Works
- Identifies the local version of the framework to determine the required schema version.
- Synchronizes the local cache by downloading the matching TypeScript schema directly from the official repository.
- Parses the Zod schema to extract precise field definitions and validation constraints.
- Performs validation on specific dot-notation paths or the entire configuration file to report errors or confirm compliance.
Config Field Validator Setup
To begin using this validator within your environment, use the provided Python scripts to sync your schema and validate fields.
# Sync the schema to match your current version
python3 scripts/sync_schema.py --status
# Validate a specific configuration field
python3 scripts/validate_field.py agents.defaults.model.primary
# Validate an entire configuration file
python3 scripts/validate_config.py ~/.config/openclaw/openclaw.json
Config Field Validator Data Schema & Taxonomy
The skill manages its internal state and cached schemas within the local user configuration directory. This structure ensures that validation is fast and can happen offline once the initial sync is complete.
| Directory/File | Purpose |
|---|---|
schema/ |
Stores the downloaded TypeScript schema files from GitHub. |
cache/ |
Contains the parsed schema definitions for rapid lookup. |
schema-fields.md |
A human-readable reference of all valid configuration fields. |
Config Field Validator Advanced Features
- Automated schema synchronization that ensures your validation logic always matches your installed version.
- Support for deep dot-notation paths, allowing for precise validation of nested agent and channel settings.
- Comprehensive field info commands that provide detailed metadata and usage requirements for any specific field.
- Forced re-sync capabilities to recover from corrupted caches or to update to the latest Openclaw Skills definitions manually.
SKILL.md
Loading
Related Openclaw Skills
Earl Display Control
A comprehensive control suite for managing the VisuoSpatial Sketchpad dashboard, including server management, kiosk browser deployment, and agent state updates.
Zoomin Scraper
An automated browser-based scraper specifically designed to extract dynamic documentation content from Zoomin Software portals.
jpocr
A localized Japanese OCR solution for high-accuracy text extraction from vertical and horizontal printed documents.
TikTok Viral Marketing
A specialized AI agent skill for sourcing and managing TikTok creators to execute viral marketing campaigns and trending challenges.
CamoFox MCP for OpenClaw
A production-ready anti-detection browser automation toolkit providing 41 specialized tools for Openclaw Skills agents.
Polymarket FastLoop Trader
A high-frequency trading agent that automates Polymarket sprint market positions using real-time price signals from centralized exchanges.
Featured*
