OpenClaw Solução de Problemas — Guia de Configuração API Key

🔧 Solução de Problemas Comuns

Configurou a Chave de API mas há erro? Sem problema, aqui estão os problemas comuns.

Erros Comuns e Soluções

❌ 401 Unauthorized / Invalid API Key

Razão:Chave de API inválida ou expirada.

Verifique se a chave foi copiada completa (sem espaços ou caracteres faltantes)
Confirme que a chave não esteja desabilitada ou deletada
Confirme que baseUrl e Chave de API correspondam (não coloque a chave OpenAI no endereço Anthropic)
A chave de Plano de Programação deve usar baseUrl de Plano de Programação, não confunda

❌ 429 Too Many Requests / Rate Limited

Razão:As requisições são muito frequentes, excedeu o limite de velocidade.

Espere um pouco e tente novamente
Se frequentemente é limitado, considere atualizar para Plano de Programação (limite mais alto)
ou configure múltiplos provedores, distribua as requisições

❌ 402 Payment Required / Insufficient Balance

Razão:Saldo insuficiente.

Vá para a plataforma correspondente recarregar
Verifique se há faturas não pagas
Verifique se o limite gratuito já foi esgotado

❌ Connection Timeout / Network Error

Razão:Problema de Conexão de Rede.

Provedores internacionais (OpenAI, Anthropic, Gemini) podem precisar de VPN na China
Provedores China doméstica (DeepSeek, MiniMax, etc.) devem conectar diretamente sem problema
Verifique se baseUrl está correto, há erros de ortografia?
Tente curl Comando para testar conectividade

❌ 400 Bad Request / Invalid Model

Razão:Nome do modelo incorreto, ou sua conta não tem acesso a esse modelo.

Verifique se o nome do modelo na configuração de models está correto
Confirme se sua conta/plano suporta esse modelo
Consulte a lista de modelos disponíveis na página de cada provedor

Técnicas de Debugging

1. Verifique configuração atual:

cat ~/.openclaw/openclaw.json

2. Teste conectividade API:

# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-sua-chave"

# Teste OpenAI
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-sua-chave"

3. Ver logs OpenClaw:

openclaw logs

4. Reinicie gateway:

openclaw gateway restart

💡 Ainda não conseguiu resolver?A maioria dos problemas é causada por baseUrl incorreto ou Chave de API não copiada completamente. Compare cuidadosamente com os exemplos de configuração na página de cada provedor.