← Voltar aos tutoriais

Conectar Google Workspace

Pré-requisitos (ambos os métodos)

1

Crie Credenciais OAuth do Google Cloud

Este passo é feito no seu próprio navegador — nada para fazer na instância MyClaw ainda.

  1. Abra Google Cloud Console → APIs & Services → Credentials.
  2. Clique + CREATE CREDENTIALS → OAuth client ID → Application type: Desktop app.
  3. Clique Create → Download JSON. Salve o arquivo client_secret_xxx.json — você precisará dele a seguir.
Abrir Google Cloud Console

Você também deve configurar a tela de consentimento OAuth e adicionar-se como usuário de teste em APIs & Services → OAuth consent screen. Sem isso, a autorização falhará.

2

Ative a API do Gmail e a API do Google Calendar

Clique em cada link abaixo e pressione Ativar. Leva apenas alguns segundos cada.

Só precisa do calendário? Ative apenas a API do Calendar (e use --services calendar nos próximos passos).

Sem comandos necessários. Faça tudo pela janela de chat (Telegram / WebChat).

B.1

Peça ao OpenClaw para instalar o gog

OpenClaw
Você
Instale o gog para mim
OpenClaw
Instalando... ✅ gog v0.11.0 instalado!
B.2

Envie o arquivo de credenciais

OpenClaw
Você
client_secret_xxx.json
Conecte meu Gmail e Calendar
OpenClaw
Recebi o arquivo de credenciais, configurando... ✅ Credenciais importadas. Qual é o seu endereço Gmail?
B.3

Forneça seu e-mail e receba o link de autorização

OpenClaw
Você
seu@gmail.com
OpenClaw
Por favor, abra este link no seu navegador para autorizar: https://accounts.google.com/o/oauth2/auth?... Após autorizar, a página redirecionará para 127.0.0.1 e mostrará um erro — isso é normal. Copie a URL completa da barra de endereço e envie para mim.
B.4

Cole a URL de callback

OpenClaw
Você
http://127.0.0.1:42845/oauth2/callback?state=xxx&code=xxx...
OpenClaw
✅ Gmail + Calendar conectados! Agora você pode simplesmente dizer: • "Verifique meus e-mails recentes" • "Crie uma reunião para amanhã às 15h"

É isso — três mensagens e você está conectado.

O que você pode fazer agora

FuncionalidadeBasta dizer
📧 Verificar e-mail"Verifique meus e-mails recentes" / "Algum e-mail de xxx?"
📧 Enviar e-mail"Envie um e-mail para a@b.com sobre..."
📅 Ver agenda"O que tem na minha agenda esta semana?"
📅 Criar eventos"Agende uma reunião para sexta às 14h"
📧 Rascunhar e-mails"Escreva uma resposta para aquele e-mail"

Solução de Problemas

Q: "Access blocked" ou "App not verified" durante a autorização

A: Você não se adicionou como usuário de teste na tela de consentimento OAuth. Volte ao Passo 1, abra OAuth consent screen → Test users e adicione seu endereço Gmail.

Q: Erro 403 accessNotConfigured

A: A API não está ativada. Volte ao Passo 2 e certifique-se de que tanto a API do Gmail quanto a API do Calendar mostram "Enabled".

Q: URL de callback expirada

A: Basta refazer o passo de autorização — é rápido. Diga ao OpenClaw "reautorize" e ele fornecerá um link novo.

Q: Erro no TTY available for keyring no WebSSH

A: Prefixe o comando com GOG_KEYRING_PASSWORD="anypassword", ex.:

GOG_KEYRING_PASSWORD="mypass123" gog auth add your@gmail.com ...