Integrazione Google Workspace

Questa guida spiega come integrare Google Workspace con OpenClaw Ultra utilizzando GoG CLI.

Servizi Supportati

Servizio	Funzionalità
Gmail	Leggere, inviare, cercare, organizzare email
Calendar	Eventi, programmi, promemoria
Drive	Gestione file, condivisione, ricerca
Docs	Creare, modificare, formattare documenti
Sheets	Operazioni fogli di calcolo, query dati
Slides	Creare e modificare presentazioni
Contacts	Gestire e sincronizzare contatti
Tasks	Creare e tracciare attività

Prerequisiti

Elemento	Requisito
OpenClaw Ultra	Installato e configurato
Account Google	Account Gmail/Workspace attivo

Passaggio 1: Installare GoG CLI in OpenClaw Ultra

1. Apri OpenClaw Ultra e avvia una nuova chat
2. Chiedi all'agente di installare GoG CLI:

   Installa GoG CLI per Windows

3. L'agente ti aiuterà a scaricare dalla versione ufficiale e aggiungerlo al PATH di sistema
4. Verifica l'installazione:

   gog --version

Passaggio 2: Creare un Client OAuth

1. Visita Google Cloud Console
2. Crea un nuovo progetto
3. Abilita le API richieste (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) - secondo necessità
4. Configura la schermata di consenso OAuth per "Esterno"
5. Crea un client OAuth applicazione desktop in Client OAuth
6. Scarica il file JSON e salvalo in un luogo sicuro

Passaggio 3: Autenticare in OpenClaw Ultra

1. Nella chat, fornisci il percorso del file JSON OAuth e autentica:

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

2. Si aprirà una finestra del browser per l'autorizzazione
3. Concedi le autorizzazioni richieste
4. L'agente confermerà quando tutti i servizi saranno connessi

Passaggio 4: Iniziare a Gestire Google Workspace

Ora puoi usare il linguaggio naturale nella chat:

Gmail

• Controlla le mie email non lette di oggi
• Invia un'email a [email protected]关于 riunione
• Cerca email sugli aggiornamenti del progetto

Calendar

• Programma una riunione domani alle 14:00
• Mostra il mio calendario di questa settimana
• Crea un evento intitolato Revisione del Team

Drive

• Carica questo file sul mio Drive
• Trova documenti sulla pianificazione del Q4
• Condividi il rapporto con [email protected]

Docs

• Crea un nuovo documento intitolato Note della Riunione
• Modifica l'ultimo documento che ho creato

Sheets

• Mostra dati da Sheet1 A1 a D20
• Crea un foglio di calcolo per il tracciamento del budget

Slides

• Crea una presentazione da questo markdown
• Aggiorna le slide di stato settimanali

Contacts

• Mostra contatti di Acme Corp
• Aggiungi un nuovo contatto per Jane Doe

Tasks

• Crea un'attività per rivedere la proposta
• Mostra le mie attività di questa settimana

Consigli di Sicurezza

WARNING

• Concedi solo le autorizzazioni necessarie
• Rivedi regolarmente le app connesse nel tuo Account Google
• Revoca l'accesso quando non è più necessario

Risoluzione dei Problemi

Problema	Soluzione
Autenticazione fallita	Riautenticare nella chat
I comandi non funzionano	Verificare l'installazione di GoG CLI
Errori di sincronizzazione	Controllare la connessione Internet e riprovare