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.

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 Comuns1. 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 → Use claude-3-haiku
  • gpt-4-0314 → Use gpt-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íveisAnthropic (Claude)
AliasNome Completo
opusclaude-3-opus-20240229
sonnetclaude-3-5-sonnet-20241022
haikuclaude-3-haiku-20240307
OpenAI (GPT)
AliasNome Completo
gpt-4gpt-4-turbo-preview
gpt-4ogpt-4o
gpt-3.5gpt-3.5-turbo
Ollama (Local)
# Listar modelos instalados
ollama list

# Instalar modelo
ollama pull llama3.1
Solução1. 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
Próximos Passos