VS Code Extensions
OpenClaw JSON Schema

OpenClaw JSON Schema

by Chouzz

Live JSON Schema completion and validation for openclaw.json in VS Code.

Downloads

151

Rating

— (0)

Version

1.0.0

Last updated

Apr 11, 2026

License: MIT

OpenClaw JSON Schema brings a live JSON Schema for openclaw.json into VS Code: completion, hover docs, Problems-panel validation, and extra real-time checks while you edit.

Features

  • Dynamic schema — Runs openclaw config schema and wires the result into VS Code’s JSON language service.
  • IntelliSense — Key names, enums, and structure hints from your installed OpenClaw version.
  • Problems integration — Invalid keys and types surface in the Problems view.
  • AJV diagnostics — Additional validation as you type (e.g. invalid enum values) with configurable debounce.
  • Commands — Refresh schema on demand and inspect last refresh / error status.

How it works

  1. On activation, the extension runs openclaw config schema.
  2. The emitted JSON Schema is stored under the extension’s global storage path.
  3. json.schemas is updated so matching files (by default openclaw.json) use that schema.
  4. VS Code’s built-in JSON support handles completion, hovers, and schema-based errors.
  5. The extension layers AJV validation for faster, finer-grained feedback while editing.

Requirements

  • The OpenClaw CLI installed and available as openclaw on your PATH (or set a custom executable path in settings).
  • openclaw config schema must print valid JSON Schema to stdout.

Usage

After installation, the schema is refreshed automatically on startup (unless disabled). You can also:

Command Action
OpenClaw JSON Schema: Refresh Schema Re-fetch schema from the CLI and re-apply mappings.
OpenClaw JSON Schema: Show Status Show last successful refresh time, last error (if any), and file patterns.

Edit any openclaw.json that matches your file match globs to get completion and diagnostics.

Extension settings

Setting Description
openclawJsonSchema.openclawPath Executable used for openclaw (default: openclaw).
openclawJsonSchema.autoRefreshOnStartup Refresh schema when VS Code starts (default: true).
openclawJsonSchema.fileMatch Glob patterns for files that use the schema (default: openclaw.json, **/openclaw.json).
openclawJsonSchema.diagnosticsDebounceMs Delay before re-running AJV validation in ms (default: 80; use 0 for immediate updates).

Troubleshooting

  • CLI errors — If the command fails, you’ll see an error and can open the OpenClaw JSON Schema output channel for details.
  • Schema changed after upgrading OpenClaw — Run Refresh Schema once so completion and validation match the new CLI output.

License

MIT — see LICENSE.