How do I install the Openclaw Config Validator skill?

Run npx skillmds@latest add diegosouzapw/openclaw-config-validator in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openclaw Config Validator safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openclaw Config Validator?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openclaw Config Validator free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openclaw Config Validator?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openclaw Config Validator by diegosouzapw

Name: Openclaw Config Validator
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

Openclaw Config Validator

Validate, analyze, and explain OpenClaw configuration files. Use when users need to check config.json for errors, understand what a config field does, compare configs, or safely modify OpenClaw configuration. Triggers on config validation requests, schema questions, or config editing tasks.

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

OpenClaw Config Validator

Skill para validar, analisar e explicar configurações do OpenClaw.

Fonte da Verdade

O schema oficial está em:

Runtime (validação): ~/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw/dist/config/zod-schema*.js
Labels: dist/config/schema.js
Repo (referência): https://github.com/openclaw/openclaw

Nota: A validação sempre usa o schema local (versão instalada) para garantir precisão.

Scripts Disponíveis

schema-analyzer.js

node scripts/schema-analyzer.js analyze <config.json>    # Analisa estrutura
node scripts/schema-analyzer.js validate <config.json>   # Valida schema
node scripts/schema-analyzer.js labels                   # Lista todos os labels
node scripts/schema-analyzer.js explain <field.path>     # Explica um campo

config-diff.js

node scripts/config-diff.js report <config.json>   # Relatório completo
node scripts/config-diff.js diff <config.json>     # Diferenças do padrão

check-update.js

node scripts/check-update.js check-update   # Verifica campos novos no GitHub

Verifica se há campos novos no schema do repositório comparado à versão local instalada.

auto-fix.js

node scripts/auto-fix.js fix <config.json> --dry-run   # Preview de correções
node scripts/auto-fix.js fix <config.json> --apply     # Aplica correções

Corrige automaticamente:

"true" → true (strings para boolean)
"123" → 123 (strings para number)
Enums inválidos → sugere valor correto
Detecta campos renomeados/obsoletos

migrate.js

node scripts/migrate.js migrate <config.json> --from=0.16.0 --to=0.17.0
node scripts/migrate.js migrate <config.json> --from=0.16.0 --to=0.17.0 --output=config-v17.json

Migra config entre versões do OpenClaw:

Detecta breaking changes
Renomeia campos automaticamente
Adiciona novos campos com valores padrão
Gera relatório de mudanças

Validações Automáticas

Seções desconhecidas (possivelmente obsoletas)
Canais sem tipo definido
Gateway remoto sem token
Campos de segurança expostos
Valores de enum inválidos

Como Usar

Para validar uma config:

Rode schema-analyzer.js validate no arquivo
Analise erros e warnings
Use auto-fix.js --dry-run para ver correções possíveis
Aplique correções com auto-fix.js --apply
Re-valide

Para migrar entre versões:

Use check-update.js para ver novos campos disponíveis
Use migrate.js --from=X --to=Y --dry-run para preview
Aplique com --output para não sobrescrever o original

Para entender um campo:

Use schema-analyzer.js explain <campo>
Ou consulte os labels em schema.js

Para modificar configs com segurança:

Valide a config atual primeiro
Faça backup
Use auto-fix para correções seguras
Aplique mudanças incrementais
Re-valide após cada mudança

Referências

Schema Reference - Documentação completa
Roadmap - Melhorias futuras planejadas

---name: openclaw-config-validatordescription: Validate, analyze, and explain OpenClaw configuration files. Use when users need to check config.json for errors, understand what a config field does, compare configs, or safely modify OpenClaw configuration. Triggers on config validation requests, schema questions, or config editing tasks.---# OpenClaw Config ValidatorSkill para validar, analisar e explicar configurações do OpenClaw.## Fonte da VerdadeO schema oficial está em:- **Runtime** (validação): `~/.nvm/versions/node/v24.13.0/lib/node_modules/openclaw/dist/config/zod-schema*.js`- **Labels**: `dist/config/schema.js`- **Repo** (referência): https://github.com/openclaw/openclaw> **Nota**: A validação sempre usa o schema local (versão instalada) para garantir precisão.## Scripts Disponíveis### schema-analyzer.js```bashnode scripts/schema-analyzer.js analyze <config.json> # Analisa estruturanode scripts/schema-analyzer.js validate <config.json> # Valida schemanode scripts/schema-analyzer.js labels # Lista todos os labelsnode scripts/schema-analyzer.js explain <field.path> # Explica um campo```### config-diff.js```bashnode scripts/config-diff.js report <config.json> # Relatório completonode scripts/config-diff.js diff <config.json> # Diferenças do padrão```### check-update.js```bashnode scripts/check-update.js check-update # Verifica campos novos no GitHub```Verifica se há campos novos no schema do repositório comparado à versão local instalada.### auto-fix.js```bashnode scripts/auto-fix.js fix <config.json> --dry-run # Preview de correçõesnode scripts/auto-fix.js fix <config.json> --apply # Aplica correções```Corrige automaticamente:- `"true"` → `true` (strings para boolean)- `"123"` → `123` (strings para number)- Enums inválidos → sugere valor correto- Detecta campos renomeados/obsoletos### migrate.js```bashnode scripts/migrate.js migrate <config.json> --from=0.16.0 --to=0.17.0node scripts/migrate.js migrate <config.json> --from=0.16.0 --to=0.17.0 --output=config-v17.json```Migra config entre versões do OpenClaw:- Detecta breaking changes- Renomeia campos automaticamente- Adiciona novos campos com valores padrão- Gera relatório de mudanças## Validações Automáticas- Seções desconhecidas (possivelmente obsoletas)- Canais sem tipo definido- Gateway remoto sem token- Campos de segurança expostos- Valores de enum inválidos## Como Usar**Para validar uma config:**1. Rode `schema-analyzer.js validate` no arquivo2. Analise erros e warnings3. Use `auto-fix.js --dry-run` para ver correções possíveis4. Aplique correções com `auto-fix.js --apply`5. Re-valide**Para migrar entre versões:**1. Use `check-update.js` para ver novos campos disponíveis2. Use `migrate.js --from=X --to=Y --dry-run` para preview3. Aplique com `--output` para não sobrescrever o original**Para entender um campo:**1. Use `schema-analyzer.js explain <campo>`2. Ou consulte os labels em schema.js**Para modificar configs com segurança:**1. Valide a config atual primeiro2. Faça backup3. Use auto-fix para correções seguras4. Aplique mudanças incrementais5. Re-valide após cada mudança## Referências- [Schema Reference](references/schema-reference.md) - Documentação completa- [Roadmap](ROADMAP.md) - Melhorias futuras planejadas

Frequently asked questions