Integração com Google Workspace

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

Serviços suportados

Serviço	Capacidades
Gmail	Ler, enviar, pesquisar, organizar e-mails
Calendar	Eventos, horários, lembretes
Drive	Gestão de ficheiros, partilha, pesquisa
Docs	Criar, editar, formatar documentos
Sheets	Operações com folhas de cálculo, consultas de dados
Slides	Criar e editar apresentações
Contacts	Gerir e sincronizar contactos
Tasks	Criar e acompanhar tarefas

Pré-requisitos

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

Passo 1: Instalar o GoG CLI no OpenClaw Ultra

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

   Instalar GoG CLI para Windows

3. O agente vai ajudá-lo a descarregar da versão oficial e adicioná-lo ao PATH do sistema
4. Verificar a instalação:

   gog --version

Passo 2: Criar cliente OAuth

1. Visite o Google Cloud Console
2. Crie um novo projeto
3. Ative as APIs necessárias (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) — apenas as que realmente precisa
4. Configure o ecrã de consentimento OAuth para "Externo"
5. Crie um cliente OAuth de aplicação de desktop em Clientes OAuth
6. Descarregue o ficheiro JSON e guarde-o num local seguro

Passo 3: Autenticar no OpenClaw Ultra

1. No chat, forneça o caminho do ficheiro OAuth JSON 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 abrirá 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 gerir o Google Workspace

Agora pode usar linguagem natural no chat:

Gmail

• Verifica os meus e-mails não lidos de hoje
• Envia um e-mail para [email protected] sobre a reunião
• Pesquisa e-mails sobre atualizações do projeto

Calendar

• Agenda uma reunião amanhã às 14h
• Mostra o meu calendário desta semana
• Cria um evento intitulado Revisão da equipa

Drive

• Carrega este ficheiro para o meu Drive
• Encontra documentos sobre o planeamento do Q4
• Partilha o relatório com [email protected]

Docs

• Cria um novo documento intitulado Notas da reunião
• Edita o último documento que criei

Sheets

• Mostra os dados da folha Sheet1 de A1 a D20
• Cria uma folha de cálculo para controlo de orçamento

Slides

• Cria uma apresentação a partir deste markdown
• Atualiza as diapositivos de estado semanal

Contacts

• Mostra os contactos da Acme Corp
• Adiciona um novo contacto para Jane Doe

Tasks

• Cria uma tarefa para rever a proposta
• Mostra as minhas tarefas desta semana

Dicas de segurança

WARNING

• Conceda apenas as permissões necessárias
• Reveja regularmente as aplicações conectadas na sua conta Google
• Revogue o acesso quando já não for necessário

Resolução de problemas

Problema	Solução
Falha na autenticação	Volte a executar a autenticação no chat
Comandos não funcionam	Verifique a instalação do GoG CLI
Erros de sincronização	Verifique a ligação à internet e tente novamente