Gmail Não Conecta ao OpenClaw
Resolva problemas de conexão entre Gmail e OpenClaw: OAuth, permissões, tokens expirados.
Sintomas
O Gmail não conecta ao OpenClaw, OAuth falha ou emails não são lidos/enviados.
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
🔴 Token OAuth expirado
Prioridade: Alta
Reautorize: openclaw auth gmail --refresh. Tokens expiram a cada 7 dias em modo development.
🔴 Permissões insuficientes
Prioridade: Alta
Verifique se os escopos incluem gmail.readonly e gmail.send. Reconfigure com openclaw auth gmail --scopes full.
🟡 2FA bloqueando
Prioridade: Média
Use App Password: Google Account → Security → App passwords → gere para OpenClaw.
🟡 Conta Google Workspace
Prioridade: Média
Admin precisa autorizar o app: Admin Console → Security → API controls → Manage third-party app access.
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
Artigos Relacionados
- Troubleshooting Geral — índice de todos os problemas
- Guia de Instalação — reinstalar pode resolver problemas persistentes
- FAQ Técnico — perguntas frequentes técnicas
- Guia de Segurança — configurações de segurança