openclaw-config-validator

name	openclaw-config-validator
description	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 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:

1. Rode schema-analyzer.js validate no arquivo
2. Analise erros e warnings
3. Use auto-fix.js --dry-run para ver correções possíveis
4. 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íveis
2. Use migrate.js --from=X --to=Y --dry-run para preview
3. 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 primeiro
2. Faça backup
3. Use auto-fix para correções seguras
4. Aplique mudanças incrementais
5. Re-valide após cada mudança

Referências

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