Google Workspace Integration

This guide explains how to integrate Google Workspace with OpenClaw Ultra using GoG CLI.

Supported Services

Service	Capabilities
Gmail	Read, send, search, organize emails
Calendar	Events, schedules, reminders
Drive	File management, sharing, search
Docs	Create, edit, format documents
Sheets	Spreadsheet operations, data queries
Slides	Create and edit presentations
Contacts	Manage and sync contacts
Tasks	Create and track tasks

Prerequisites

Item	Requirement
OpenClaw Ultra	Installed and configured
Google Account	Active Gmail/Workspace account

Step 1: Install GoG CLI in OpenClaw Ultra

1. Open OpenClaw Ultra and start a new chat
2. Ask the agent to install GoG CLI:

   Install GoG CLI for Windows

3. The agent will help you download from the official release and add it to your system PATH
4. Verify installation:

   gog --version

Step 2: Create OAuth Client

1. Visit Google Cloud Console
2. Create a new project
3. Enable required APIs (Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, Tasks) - whatever you actually need
4. Configure OAuth consent screen for "External"
5. Create a Desktop app OAuth client at OAuth clients
6. Download the JSON file and save it to a safe location

Step 3: Authenticate in OpenClaw Ultra

1. In the chat, provide the OAuth JSON file path and authenticate:

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

2. A browser window will open for authorization
3. Grant the requested permissions
4. The agent will confirm when all services are connected

Step 4: Start Managing Google Workspace

Now you can use natural language in the chat:

Gmail

• Check my unread emails from today
• Send an email to [email protected] about the meeting
• Search emails about project updates

Calendar

• Schedule a meeting tomorrow at 2 PM
• Show my calendar for this week
• Create an event titled Team Review

Drive

• Upload this file to my Drive
• Find documents about Q4 planning
• Share the report with [email protected]

Docs

• Create a new document titled Meeting Notes
• Edit the last document I created

Sheets

• Show data from Sheet1 A1 to D20
• Create a spreadsheet for budget tracking

Slides

• Create a presentation from this markdown
• Update the weekly status slides

Contacts

• Show contacts from Acme Corp
• Add a new contact for Jane Doe

Tasks

• Create a task to review the proposal
• Show my tasks for this week

Security Tips

WARNING

• Only grant necessary permissions
• Review connected apps regularly in your Google Account
• Revoke access when no longer needed

Troubleshooting

Issue	Solution
Authentication failed	Re-run authentication in chat
Commands not working	Verify GoG CLI installation
Sync errors	Check internet connection and retry