---
title: "Erro Model Not Found — Modelo Não Encontrado"
url: "https://openclaw.ia.br/erros/model-not-found/"
markdown_url: "https://openclaw.ia.br/erros/model-not-found.MD"
description: "Como resolver erro de modelo não encontrado no OpenClaw. Configuração de modelos de IA."
date: ""
author: ""
---

# Erro Model Not Found — Modelo Não Encontrado

Como resolver erro de modelo não encontrado no OpenClaw. Configuração de modelos de IA.


# 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:

```yaml
# 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:
```yaml
# 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)

```bash
# Listar modelos instalados
ollama list

# Instalar modelo
ollama pull llama3.1
```

## Solução

### 1. Verificar Nome

```bash
# Ver modelo atual
cat ~/.openclaw/config.yaml | grep model
```

### 2. Usar Alias

```yaml
# config.yaml - use aliases simples
model: sonnet  # Em vez do nome completo
```

### 3. Atualizar Configuração

```yaml
# 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

```bash
# 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:

```yaml
models:
  default: claude-3-5-sonnet-20241022
  fallback: claude-3-haiku-20240307
```

## Próximos Passos

- [Comparativo de modelos](/modelos/comparativo/)
- [Configuração](/guias/configuracao/)
- [FAQ Técnico](/faq/tecnico/)