Resolver Erro 'Model Not Found' no OpenClaw — 3 Soluções Rápidas
Erro 'model not found' no OpenClaw? 3 soluções: verificar nome do modelo, checar API key e atualizar configuração. Inclui tabela de nomes corretos para Claude, GPT-4, Gemini e Ollama.
⏱️ 2 min de leitura
Erro: Model Not Found
O OpenClaw não encontrou o modelo de IA configurado. Veja como resolver.
O Que Significa
Error: Model 'claude-4' not found
Error: Invalid model identifier
Error: Model not available for your API tier
O modelo especificado não existe ou não está disponível.
Causas Comuns
1. Nome Incorreto
Modelos têm nomes específicos:
# Não Incorreto
model: claude-4
model: gpt4
model: claude-sonnet
# Sim Correto
model: claude-3-5-sonnet-20241022
model: gpt-4-turbo-preview
model: claude-3-opus-20240229
2. Modelo Descontinuado
Modelos antigos são removidos:
claude-instant→ Useclaude-3-haikugpt-4-0314→ Usegpt-4-turbo
3. Tier da API
Alguns modelos requerem tier específico:
- Opus requer Tier 2+ na Anthropic
- GPT-4 requer tier pago na OpenAI
4. Provider Errado
Modelo de um provider com key de outro:
# Não Claude com key OpenAI
provider: openai
model: claude-3-sonnet
# Sim Correto
provider: anthropic
model: claude-3-5-sonnet-20241022
Modelos Disponíveis
Anthropic (Claude)
| Alias | Nome Completo |
|---|---|
| opus | claude-3-opus-20240229 |
| sonnet | claude-3-5-sonnet-20241022 |
| haiku | claude-3-haiku-20240307 |
OpenAI (GPT)
| Alias | Nome Completo |
|---|---|
| gpt-4 | gpt-4-turbo-preview |
| gpt-4o | gpt-4o |
| gpt-3.5 | gpt-3.5-turbo |
Ollama (Local)
# Listar modelos instalados
ollama list
# Instalar modelo
ollama pull llama3.1
Solução
1. Verificar Nome
# Ver modelo atual
cat ~/.openclaw/config.yaml | grep model
2. Usar Alias
# config.yaml - use aliases simples
model: sonnet # Em vez do nome completo
3. Atualizar Configuração
# config.yaml
provider: anthropic
model: claude-3-5-sonnet-20241022 # Nome exato
# Ou com alias
models:
default: sonnet
fast: haiku
smart: opus
4. Verificar API Key
# Testar se key tem acesso ao modelo
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "content-type: application/json" \
-d '{"model":"claude-3-5-sonnet-20241022","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
Fallback
Configure modelo de backup:
models:
default: claude-3-5-sonnet-20241022
fallback: claude-3-haiku-20240307