AgentSkillsCN

openclaw-config-validator

当用户需要检查 config.json 文件是否存在错误、了解某个配置字段的具体作用、对比不同配置，或安全地修改 OpenClaw 配置时，可使用此功能进行验证。可通过配置验证请求、模式疑问，或配置编辑任务进行触发。

SKILL.md
--- frontmatter
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

bash
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

bash
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

bash
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

bash
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

bash
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