shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

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.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

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