Erro de Autenticação no Gemini

Sintomas

O OpenClaw não consegue se autenticar com a API do Gemini, retornando erro 401 ou 403.

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🔴 API key inválida

Prioridade: Alta

Gere nova key em aistudio.google.com/apikey. Copie completa (sem espaços) para config.yaml.

🔴 Billing não ativado

Prioridade: Alta

Para Gemini 1.5 Pro, billing deve estar ativo no Google Cloud Console.

🟡 Região não suportada

Prioridade: Média

Gemini pode não estar disponível na sua região. Use VPN ou configure proxy.

🟢 Key com restrições

Prioridade: Baixa

Se criou com restrições de IP/referer, remova ou adicione o IP do seu servidor.

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