Awesome-omni-skill 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.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/openclaw-config-validator" ~/.claude/skills/diegosouzapw-awesome-omni-skill-openclaw-config-validator && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/data-ai/openclaw-config-validator" ~/.openclaw/skills/diegosouzapw-awesome-omni-skill-openclaw-config-validator && rm -rf "$T"

manifest: skills/data-ai/openclaw-config-validator/SKILL.md

source content

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