Integrazione con Google Workspace

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

Servizi supportati

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

Prerequisiti

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

Passo 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 ad aggiungerlo al PATH di sistema
4. Verifica l'installazione:

   gog --version

Passo 2: Creare un client OAuth

1. Visita Google Cloud Console
2. Crea un nuovo progetto
3. Abilita le API necessarie (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) — solo quelle di cui hai bisogno
4. Configura la schermata di consenso OAuth su "Esterno"
5. Crea un client OAuth app desktop in Client OAuth
6. Scarica il file JSON e salvalo in un luogo sicuro

Passo 3: Autenticare in OpenClaw Ultra

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

   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 i permessi richiesti
4. L'agente confermerà quando tutti i servizi saranno connessi

Passo 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] riguardo la riunione
• Cerca email sugli aggiornamenti del progetto

Calendar

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

Drive

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

Docs

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

Sheets

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

Slides

• Crea una presentazione da questo markdown
• Aggiorna le diapositive dello stato settimanale

Contacts

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

Tasks

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

Suggerimenti di sicurezza

WARNING

• Concedi solo i permessi necessari
• Rivedi regolarmente le app connesse nel tuo account Google
• Revoca l'accesso quando non è più necessario

Risoluzione dei problemi

Problema	Soluzione
Autenticazione fallita	Riesegui l'autenticazione nella chat
I comandi non funzionano	Verifica l'installazione di GoG CLI
Errori di sincronizzazione	Controlla la connessione Internet e riprova