Integração do Google Workspace

Este guia explica como integrar o Google Workspace com o OpenClaw Ultra usando GoG CLI.

Serviços Suportados

Serviço	Capacidades
Gmail	Ler, enviar, pesquisar, organizar e-mails
Calendar	Eventos, agendas, lembretes
Drive	Gerenciamento de arquivos, compartilhamento, pesquisa
Docs	Criar, editar, formatar documentos
Sheets	Operações de planilhas, consultas de dados
Slides	Criar e editar apresentações
Contacts	Gerenciar e sincronizar contatos
Tasks	Criar e acompanhar tarefas

Pré-requisitos

Item	Requisito
OpenClaw Ultra	Instalado e configurado
Conta Google	Conta ativa do Gmail/Workspace

Passo 1: Instalar GoG CLI no OpenClaw Ultra

1. Abra o OpenClaw Ultra e inicie um novo chat
2. Peça ao agente para instalar GoG CLI:

   Instalar GoG CLI para Windows

3. O agente ajudará você a baixar do lançamento oficial e adicionar ao PATH do sistema
4. Verifique a instalação:

   gog --version

Passo 2: Criar Cliente OAuth

1. Visite Google Cloud Console
2. Crie um novo projeto
3. Ative as APIs necessárias (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) - conforme necessário
4. Configure a tela de consentimento OAuth para "Externo"
5. Crie um cliente OAuth de aplicativo de desktop em Clientes OAuth
6. Baixe o arquivo JSON e salve em um local seguro

Passo 3: Autenticar no OpenClaw Ultra

1. No chat, forneça o caminho do arquivo JSON OAuth e autentique:

   gog auth credentials /path/to/your/client_secret.json
   gog auth add [email protected] --services gmail,calendar,drive,docs,sheets,slides,contacts,tasks

2. Uma janela do navegador será aberta para autorização
3. Conceda as permissões solicitadas
4. O agente confirmará quando todos os serviços estiverem conectados

Passo 4: Começar a Gerenciar Google Workspace

Agora você pode usar linguagem natural no chat:

Gmail

• Verificar meus e-mails não lidos de hoje
• Enviar um e-mail para [email protected] sobre a reunião
• Pesquisar e-mails sobre atualizações do projeto

Calendar

• Agendar uma reunião amanhã às 14h
• Mostrar meu calendário desta semana
• Criar um evento intitulado Revisão da Equipe

Drive

• Enviar este arquivo para meu Drive
• Encontrar documentos sobre planejamento do Q4
• Compartilhar o relatório com [email protected]

Docs

• Criar um novo documento intitulado Notas da Reunião
• Editar o último documento que criei

Sheets

• Mostrar dados de Sheet1 A1 a D20
• Criar uma planilha para acompanhamento de orçamento

Slides

• Criar uma apresentação a partir deste markdown
• Atualizar os slides de status semanais

Contacts

• Mostrar contatos da Acme Corp
• Adicionar um novo contato para Jane Doe

Tasks

• Criar uma tarefa para revisar a proposta
• Mostrar minhas tarefas desta semana

Dicas de Segurança

WARNING

• Conceda apenas as permissões necessárias
• Revise os aplicativos conectados regularmente na sua Conta Google
• Revogue o acesso quando não for mais necessário

Solução de Problemas

Problema	Solução
Autenticação falhou	Reautenticar no chat
Comandos não funcionam	Verificar instalação do GoG CLI
Erros de sincronização	Verificar conexão com internet e tentar novamente