Erro 429 na API do Claude (Rate Limit)

Sintomas

O OpenClaw recebe erro 429 (Too Many Requests) ao usar a API do Claude.

Se você está enfrentando esse problema, siga as soluções abaixo em ordem de probabilidade.

Diagnóstico Rápido

Antes de tentar as soluções, colete informações:

# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version

Soluções🔴 Limite de requisições excedido

Prioridade: Alta

Free tier: 5 req/min, Tier 1: 50 req/min. Verifique seu tier em console.anthropic.com.

🔴 Retry automático

Prioridade: Alta

Configure anthropic_retry_count: 3 e anthropic_retry_delay: 5 no config.yaml.

🟡 Usar modelo menor para triagem

Prioridade: Média

Use Haiku para triagem inicial e Sonnet para respostas complexas: model_routing: true.

🟡 Cache de respostas

Prioridade: Média

Ative cache para perguntas frequentes: response_cache: true e cache_ttl: 3600.

Ainda Com Problemas?

Se nenhuma solução acima resolveu:

Colete logs detalhados: openclaw logs --level debug --tail 200 > debug.log
Verifique a versão: openclaw --version — considere atualizar para a última versão
Busque na comunidade: Discord do OpenClaw — outros usuários podem ter resolvido
Abra uma issue: GitHub Issues com logs e passos para reproduzir

📄 Mais em Troubleshooting