OpenClaw Google Workspace Skill: Connect Gmail, Calendar, Drive

The OpenClaw Google Workspace skill is consistently the most-downloaded skill on ClawHub, and for good reason. It gives your AI agent the ability to read and send email, manage calendar events, search and create Google Drive files, and draft Google Docs — all from a single conversational interface. This guide walks through installation, OAuth setup, and the most useful commands.

What the Google Workspace Skill Can Do

Gmail:

• Read unread emails with summaries
• Search your inbox by sender, subject, or date range
• Draft and send emails based on plain-language instructions
• Label, archive, and delete messages

Google Calendar:

• View upcoming events
• Create new events with attendees, location, and video links
• Find free time slots for meetings
• Cancel or reschedule events

Google Drive:

• Search files and folders by name or content
• Create new Google Docs, Sheets, or Slides
• Share files with specific people or via link
• Read content from existing documents

Prerequisites

• OpenClaw instance (any hosting method)
• Google Workspace or personal Google account
• Google Cloud project with OAuth 2.0 credentials enabled

Step 1: Create Google OAuth Credentials

1. Go to Google Cloud Console
2. Create a new project (or select existing)
3. Navigate to APIs & Services > Credentials
4. Click Create Credentials > OAuth 2.0 Client ID
5. Application type: Desktop app
6. Download the credentials JSON file

You also need to enable these APIs for your project:

• Gmail API
• Google Calendar API
• Google Drive API
• Google Docs API

Step 2: Install the Skill

/skills install google-workspace-official

When prompted, provide the path to your credentials JSON file.

Step 3: Authenticate

/skills auth google-workspace-official

This opens a browser window for OAuth consent. Grant the permissions listed — typically read/write access to Gmail, Calendar, and Drive. A refresh token is stored securely in your OpenClaw instance.

Step 4: Test the Connection

Try a few commands to verify everything works:

"What are my unread emails from today?"
"What do I have on my calendar this week?"
"Search my Drive for the Q1 report"

Practical Workflows

Morning briefing: "Give me a summary of unread emails, today's calendar events, and any new Drive files shared with me overnight."

Email triage: "Find all emails about Project Phoenix from last week and summarise the key action items."

Meeting scheduling: "Schedule a 30-minute call with alex@company.com sometime next Tuesday afternoon. Create a Google Meet link."

Document creation: "Create a Google Doc called 'Q2 OKRs' with a table structure for objectives and key results. Share it with the team@company.com group."

Privacy and Data Handling

The Google Workspace skill sends API requests to Google on your behalf using your own OAuth tokens. nacre.sh never receives or stores your Google data — all API calls go directly from your agent instance to Google's servers.

Frequently Asked Questions

Does this work with Google Workspace for Business accounts?

Yes, but your Google Workspace administrator may need to configure domain-wide delegation or approve the OAuth scopes for your account.

What happens if my OAuth token expires?

The skill automatically refreshes tokens using the stored refresh token. If the refresh token itself expires (which happens after certain security events), run /skills auth google-workspace-official again.

Can I limit which Gmail labels the skill can access?

The current skill requests broad Gmail read/write access. If you want more granular control, you'll need to create a custom skill using the official skill's source as a template.