Uma das coisas mais poderosas que o OpenClaw pode fazer é gerenciar seu email. Ele pode escanear sua caixa de entrada, dizer o que realmente precisa de atenção, rascunhar respostas e até enviá-las (com sua aprovação).
Este guia explica a integração com Gmail do zero.
O Que Você Poderá Fazer
Uma vez conectado, você pode pedir ao OpenClaw coisas como:
"Resuma os últimos 10 emails do meu time"
"Rascunhe uma resposta para o email da Maria sobre o cronograma do projeto"
"Encontre todos os emails não lidos da última semana sobre notas fiscais"
É como ter um assistente que lê seu email para você e mostra o que importa.
Pré-requisitos
- OpenClaw instalado e rodando (guia de instalação aqui)
- Uma conta Google (Gmail pessoal ou Google Workspace)
- ~10 minutos para o setup OAuth
Passo 1: Criar um Projeto Google Cloud
Acesse console.cloud.google.com e faça login com a conta Google que deseja conectar.
Clique no dropdown de projeto (canto superior esquerdo), depois "Novo Projeto". Nomeie algo como "OpenClaw Gmail" e crie.
No seu novo projeto, vá para "APIs e Serviços" → "Biblioteca". Pesquise "Gmail API" e clique Ativar.
Passo 2: Configurar Credenciais OAuth
Vá para "APIs e Serviços" → "Tela de consentimento OAuth". Escolha "Externo" (a menos que tenha Workspace, então "Interno"). Preencha os campos obrigatórios—nome do app, email de suporte, email do desenvolvedor. Salve e continue pelos escopos (você adicionará depois).
Vá para "Credenciais" → "Criar Credenciais" → "ID do cliente OAuth". Escolha "App para desktop" como tipo de aplicativo. Nomeie "OpenClaw" e crie.
Clique no botão de download (JSON) na sua nova credencial. Salve este arquivo—você precisará dele para o OpenClaw.
Mantenha este arquivo seguro. O JSON de credenciais dá acesso ao seu Gmail. Não faça commit no git ou compartilhe publicamente.
Passo 3: Conectar ao OpenClaw
Agora diga ao OpenClaw para usar essas credenciais. A forma mais fácil:
O OpenClaw vai guiar você pelo resto—onde colocar o arquivo de credenciais, executar o fluxo OAuth e testar a conexão.
Passo 4: Autorizar Acesso
Na primeira vez que o OpenClaw tentar acessar o Gmail, ele vai dar uma URL para visitar. Este é o fluxo OAuth:
- Clique no link que o OpenClaw fornece
- Faça login com sua conta Google
- Você verá um aviso sobre app não verificado—clique "Avançado" e depois "Ir para OpenClaw (não seguro)"
- Conceda as permissões solicitadas
- Copie o código de autorização de volta para o OpenClaw
Por que "não seguro"? O Google mostra esse aviso para apps que não passaram pelo processo de verificação deles. Como é sua própria integração privada, tudo bem. Você está autorizando seu próprio app a acessar seu próprio email.
Testar
Uma vez conectado, tente estes:
Se o OpenClaw listar seus emails recentes, você está pronto. Agora você pode começar a construir fluxos de trabalho reais.
Ideias de Fluxos de Trabalho
Triagem Matinal de Email
"Verifique minha caixa de entrada. Me diga quais emails precisam de resposta hoje vs. quais podem esperar. Ignore newsletters."
Auto-Rascunho de Respostas
"Para cada email do meu chefe esta semana, rascunhe uma resposta breve. Não envie—apenas me mostre os rascunhos."
Resumo Semanal
"Toda segunda às 9h, resuma emails importantes que recebi na semana passada e quaisquer que não respondi."
Rastreamento de Notas Fiscais
"Encontre todos os emails com anexos PDF de fornecedores este mês. Liste os valores se visíveis."
Notas de Segurança
- O OpenClaw não armazena seus emails. Ele os lê sob demanda quando você pede.
- Tokens OAuth são armazenados localmente no seu servidor, não enviados para nenhum outro lugar.
- Você pode revogar acesso a qualquer momento nas configurações de segurança da sua conta Google.
- Considere escopo somente leitura se não quiser que o OpenClaw envie emails—apenas modifique os escopos na sua tela de consentimento OAuth.
Solução de Problemas
Erro "Acesso bloqueado"
Certifique-se de que você se adicionou como usuário de teste na tela de consentimento OAuth (APIs e Serviços → Tela de consentimento OAuth → Usuários de teste).
Erro "Credenciais inválidas"
Re-baixe o JSON de credenciais e certifique-se de que o OpenClaw está apontando para o caminho de arquivo correto.
Token expirado
Tokens OAuth expiram. Se o OpenClaw parar de funcionar depois de um tempo, você pode precisar re-autorizar. Ele deve pedir automaticamente.
Precisa de ajuda? Entre na comunidade do Discord ou verifique a documentação oficial.