---
title: "Erro Timeout — Operação Demorou Demais"
url: "https://openclaw.ia.br/erros/timeout/"
markdown_url: "https://openclaw.ia.br/erros/timeout.MD"
description: "Como resolver erros de timeout no OpenClaw. Causas, configurações e soluções."
date: ""
author: ""
---

# Erro Timeout — Operação Demorou Demais

Como resolver erros de timeout no OpenClaw. Causas, configurações e soluções.


# Erro: Timeout

A operação demorou demais e foi cancelada. Veja como resolver.

## O Que Significa

```
Error: Request timed out after 30000ms
Error: Operation timed out
Error: Gateway timeout
```

O OpenClaw esperou uma resposta por tempo demais e desistiu para não travar.

## Causas Comuns

### 1. Resposta Longa da IA

Pediu algo muito complexo que demora para processar.

### 2. API Lenta

Servidores da Anthropic/OpenAI sobrecarregados.

### 3. Conexão Instável

Problemas de rede entre você e as APIs.

### 4. Integração Demorada

Skill ou integração fazendo operação lenta.

### 5. Comando Pesado

Executando comando que demora (ex: build grande).

## Soluções

### Aumentar Timeout

```yaml
# config.yaml
timeouts:
  api: 60000      # 60s para APIs
  exec: 300000    # 5min para comandos
  webhook: 10000  # 10s para webhooks
```

### Dividir Requisição

Em vez de:
```
"Analise detalhadamente todos os 50 arquivos do projeto"
```

Faça:
```
"Analise os 10 arquivos mais importantes do projeto"
```

### Usar Modelo Mais Rápido

```yaml
# Para tarefas grandes, use modelo rápido
models:
  default: claude-3-5-sonnet
  fast: claude-3-haiku  # Muito mais rápido
```

### Verificar Conexão

```bash
# Testar latência para API
curl -o /dev/null -s -w "%{time_total}\n" https://api.anthropic.com

# Se > 2s, problema de rede
```

### Verificar Status das APIs

- **Anthropic:** https://status.anthropic.com
- **OpenAI:** https://status.openai.com

### Usar Background para Comandos Longos

```
"Execute build em background e me avise quando terminar"
```

## Timeouts Recomendados

| Operação | Timeout |
|----------|---------|
| Chat simples | 30s |
| Chat complexo | 60s |
| Geração longa | 120s |
| Comando exec | 300s |
| Upload de arquivo | 60s |
| Webhook | 10s |

## Configuração Avançada

### Por Tipo de Operação

```yaml
timeouts:
  chat:
    simple: 30000
    complex: 60000
  exec:
    default: 60000
    long_running: 300000
```

### Retry com Backoff

```yaml
retry:
  enabled: true
  max_attempts: 3
  backoff:
    initial: 1000
    multiplier: 2
    max: 10000
```

## Quando é Normal

Algumas operações são naturalmente lentas:

- Análise de código grande
- Geração de conteúdo longo
- Builds e deploys
- Operações de banco de dados

Para esses casos, aumente o timeout ou use operações assíncronas.

## Debug

```bash
# Ver onde está demorando
DEBUG=* openclaw gateway start

# Logs com timing
openclaw logs | grep -i "ms\|timeout"
```

## Próximos Passos

- [Otimização de performance](/guias/performance/)
- [Rate Limited](/erros/rate-limited/)
- [Troubleshooting](/troubleshooting/)