OpenClaw Config VS Code Extension

DX-first VS Code support for openclaw.json with schema validation, smart diagnostics, quick fixes, and guided configuration workflows.

Who This Is For

Teams maintaining openclaw.json files in real projects.
Integrators who need safe config edits with fast feedback.
Developers who want guardrails for schema sync, secrets, bindings, and dynamic fields.

pnpm install
pnpm compile
pnpm test:unit
pnpm test:integration

Then launch the extension in VS Code from this repo:

Schema autocomplete and validation for **/openclaw.json.
Zod shadow diagnostics layered on top of schema diagnostics.
Integrator diagnostics for missing agent/account references and secret hygiene.
One-click quick fixes for common config issues.
Hybrid autocomplete: static schema suggestions + dynamic key/value suggestions for wildcard/plugin contexts.
Dynamic subfield completion from schema, UI hints, and optional plugin metadata (including value hints).
Explain workflows (hover + command) for contextual field guidance.
Normalize command for stable ordering and $schema insertion.
Live schema sync with cache TTL, host/repo allowlists, and SHA-256 verification.

Command	ID	Typical Use
OpenClaw: New Config	`openclawConfig.newConfig`	Create a starter `openclaw.json`
OpenClaw: Refresh Schema Now	`openclawConfig.refreshSchemaNow`	Force sync and revalidation
OpenClaw: Insert Section Snippet	`openclawConfig.insertSectionSnippet`	Insert guided section snippets
OpenClaw: Explain Selection	`openclawConfig.explainSelection`	Open markdown explain view for current path
OpenClaw: Normalize Config	`openclawConfig.normalizeConfig`	Normalize and save config with stable structure
OpenClaw: Show Schema Status	`openclawConfig.showSchemaStatus`	Inspect source, commit, sync state, policy result

Setting	Purpose	Default
`openclawConfig.zodShadow.enabled`	Toggle zod shadow diagnostics	`true`
`openclawConfig.sync.ttlHours`	Sync cache TTL in hours	`6`
`openclawConfig.sync.manifestUrl`	Remote manifest source	GitHub raw manifest URL
`openclawConfig.sync.allowedHosts`	Host allowlist for sync URLs	`["raw.githubusercontent.com"]`
`openclawConfig.sync.allowedRepositories`	Repository allowlist for artifact URLs	`["jorekai/openclaw-config-vscode"]`
`openclawConfig.codeActions.enabled`	Toggle OpenClaw quick fixes	`true`
`openclawConfig.integrator.strictSecrets`	Elevate secret hygiene to errors	`false`
`openclawConfig.integrator.explainOnHover`	Show explain text on hover	`true`
`openclawConfig.plugins.metadataUrl`	Optional remote plugin hint registry	`""`
`openclawConfig.plugins.metadataLocalPath`	Workspace-local plugin hint file	`.openclaw/plugin-hints.json`

Full settings reference: docs/configuration.md

I Want To...	Go Here
Get productive in minutes	`docs/getting-started.md`
Learn every command in detail	`docs/commands.md`
Configure sync/security/plugin hints safely	`docs/configuration.md`
Understand diagnostics and quick fixes	`docs/diagnostics-and-quick-fixes.md`
Follow practical day-to-day flows	`docs/workflows.md`
Debug failures quickly	`docs/troubleshooting.md`
Understand internals and module layout	`docs/architecture.md`
Contribute safely	`docs/contributing.md`
Operate/release with incident procedures	`docs/runbook.md`
Plan launch sequencing and gates	`docs/release-roadmap.md`
Run feature-complete and release gates	`docs/release-checklist.md`

pnpm compile
pnpm lint
pnpm test:unit
pnpm test:integration
pnpm sync:schema

This repository includes a GitHub Pages documentation pipeline powered by VitePress.

Local preview:

pnpm install
pnpm docs:dev