Erro Timeout — Operação Demorou Demais
Como resolver erros de timeout no OpenClaw. Causas, configurações e soluções.
⏱️ 2 min de leitura
Erro: Timeout
A operação demorou demais e foi cancelada. Veja como resolver.
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.
Pediu algo muito complexo que demora para processar.
Servidores da Anthropic/OpenAI sobrecarregados.
Problemas de rede entre você e as APIs.
Skill ou integração fazendo operação lenta.
Executando comando que demora (ex: build grande).
# config.yaml
timeouts:
api: 60000 # 60s para APIs
exec: 300000 # 5min para comandos
webhook: 10000 # 10s para webhooks
Em vez de:
"Analise detalhadamente todos os 50 arquivos do projeto"
Faça:
"Analise os 10 arquivos mais importantes do projeto"
# Para tarefas grandes, use modelo rápido
models:
default: claude-3-5-sonnet
fast: claude-3-haiku # Muito mais rápido
# Testar latência para API
curl -o /dev/null -s -w "%{time_total}\n" https://api.anthropic.com
# Se > 2s, problema de rede
- Anthropic: https://status.anthropic.com
- OpenAI: https://status.openai.com
"Execute build em background e me avise quando terminar"
| Operação | Timeout |
|---|---|
| Chat simples | 30s |
| Chat complexo | 60s |
| Geração longa | 120s |
| Comando exec | 300s |
| Upload de arquivo | 60s |
| Webhook | 10s |
timeouts:
chat:
simple: 30000
complex: 60000
exec:
default: 60000
long_running: 300000
retry:
enabled: true
max_attempts: 3
backoff:
initial: 1000
multiplier: 2
max: 10000
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.
# Ver onde está demorando
DEBUG=* openclaw gateway start
# Logs com timing
openclaw logs | grep -i "ms\|timeout"