Configuração Inválida — Erro YAML OpenClaw
Como resolver erros de configuração no arquivo YAML ou variáveis de ambiente. Sintaxe e validação.
⏱️ 2 min de leitura
Configuração Inválida
Erro ao carregar ou parsear arquivo de configuração:
YAML parse error
Invalid configuration
Missing required field: xxx
Configuration validation failed
- Sintaxe YAML errada - Indentação ou caracteres inválidos
- Campo obrigatório faltando - Configuração incompleta
- Tipo errado - String onde deveria ser número
- Encoding errado - Arquivo não está em UTF-8
- Variável não expandida - ${VAR} não substituída
# Instalar yamllint
pip install yamllint
# Validar arquivo
yamllint ~/.openclaw/config.yaml
# Ou usar Python
python -c "import yaml; yaml.safe_load(open('config.yaml'))"
# ERRADO - indentação inconsistente
gateway:
port: 3000
ssl: true # Espaço extra!
# CORRETO
gateway:
port: 3000
ssl: true
# ERRADO - caractere especial sem aspas
password: p@ss:word!
# CORRETO
password: "p@ss:word!"
# Ou com aspas simples
password: 'p@ss:word!'
# ERRADO - porta como string
port: "3000"
# CORRETO - porta como número
port: 3000
# ERRADO - booleano como string
enabled: "true"
# CORRETO
enabled: true
# Usando variáveis
telegram:
token: ${TELEGRAM_BOT_TOKEN}
# Verificar se está definida
echo $TELEGRAM_BOT_TOKEN
# Definir variável faltante
export TELEGRAM_BOT_TOKEN="seu_token_aqui"
# Ver encoding do arquivo
file config.yaml
# Converter para UTF-8 se necessário
iconv -f ISO-8859-1 -t UTF-8 config.yaml > config_utf8.yaml
mv config_utf8.yaml config.yaml
# Copiar configuração de exemplo
cp ~/.openclaw/config.example.yaml ~/.openclaw/config.yaml
# Ou gerar nova configuração
openclaw config init
# Validar configuração
openclaw config validate
# Ver configuração atual
openclaw config show
# Ver campos obrigatórios
openclaw config schema
# ~/.openclaw/config.yaml
gateway:
port: 3000
host: "0.0.0.0"
ssl:
enabled: false
telegram:
enabled: true
token: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz"
whatsapp:
enabled: true
session_path: "./sessions/whatsapp"
logging:
level: "info"
file: "./logs/openclaw.log"
cache:
enabled: true
ttl: 3600
- Use um editor com validação YAML (VS Code + extensão)
- Mantenha backup da configuração funcionando
- Use variáveis de ambiente para secrets
- Valide antes de aplicar mudanças