Collega Google Workspace
Prerequisiti (entrambi i metodi)
Crea credenziali OAuth Google Cloud
Questo passaggio viene fatto nel tuo browser — nulla da fare ancora sull'istanza MyClaw.
- Apri Google Cloud Console → APIs & Services → Credentials.
- Clicca + CREATE CREDENTIALS → OAuth client ID → Application type: Desktop app.
- Clicca Create → Download JSON. Salva il file client_secret_xxx.json — ti servirà dopo.
Devi anche configurare la schermata di consenso OAuth e aggiungerti come utente di test sotto APIs & Services → OAuth consent screen. Senza questo, l'autorizzazione fallirà.
Abilita Gmail API e Google Calendar API
Clicca ogni link qui sotto e premi Abilita. Richiede solo pochi secondi ciascuno.
Hai bisogno solo del calendario? Abilita solo la Calendar API (e usa --services calendar nei passaggi successivi).
Nessun comando necessario. Fai tutto dalla tua finestra chat (Telegram / WebChat).
Chiedi a OpenClaw di installare gog
Invia il file delle credenziali
Fornisci la tua email, ottieni il link di autorizzazione
Incolla l'URL di callback
Ecco fatto — tre messaggi e sei connesso.
Cosa puoi fare ora
| Funzionalità | Basta dire |
|---|---|
| 📧 Controlla email | "Controlla le mie email recenti" / "Ci sono email da xxx?" |
| 📧 Invia email | "Invia un'email a a@b.com riguardo a..." |
| 📅 Visualizza calendario | "Cosa ho in programma questa settimana?" |
| 📅 Crea eventi | "Programma una riunione per venerdì alle 14:00" |
| 📧 Bozze email | "Prepara una risposta a quell'email" |
Risoluzione problemi
Q: "Access blocked" o "App not verified" durante l'autorizzazione
A: Non hai aggiunto te stesso come utente di test nella schermata di consenso OAuth. Torna al Passo 1, apri OAuth consent screen → Test users, e aggiungi il tuo indirizzo Gmail.
Q: Errore 403 accessNotConfigured
A: L'API non è abilitata. Torna al Passo 2 e assicurati che sia Gmail API che Calendar API mostrino "Enabled".
Q: URL di callback scaduto
A: Basta rifare il passaggio di autorizzazione — è veloce. Dì a OpenClaw "re-authorize" e ti darà un link nuovo.
Q: Errore no TTY available for keyring in WebSSH
A: Anteponi al comando GOG_KEYRING_PASSWORD="anypassword", ad esempio:
GOG_KEYRING_PASSWORD="mypass123" gog auth add your@gmail.com ...