Connecting OpenClaw with Google Workspace: A Practical Guide | Cody

Google Workspace is a collection of services — Gmail, Calendar, Drive, Docs — rather than a single API. Connecting OpenClaw to it means deciding which services you want, enabling each API separately, and handling OAuth for each.

How OpenClaw Integrations Work

OpenClaw is a self-hosted AI assistant that runs on your own server — typically an EC2 instance — and connects to Slack. It uses Claude under the hood to process requests. Out of the box, OpenClaw doesn't ship with pre-built connections to third-party tools. Instead, integrations are built using the skills system: markdown files in ~/.openclaw/skills/ that give Claude instructions for a particular domain, combined with HTTP tool calls to any API you expose to it.

In practice, adding a real integration means: getting API credentials from the third-party service, building or configuring a small proxy/endpoint that OpenClaw can call, and writing a skill file that tells Claude how to use it. For some tools this is an afternoon of work. For others — like Google Workspace — it's considerably more involved.

Connecting OpenClaw with Google Workspace: Step by Step

Step 1: Create a Google Cloud Project and Enable APIs

In Google Cloud Console, create a project and enable the APIs you need: Gmail API, Google Calendar API, Google Drive API. Each must be enabled individually. Then create OAuth 2.0 credentials or a Service Account depending on whether you need user-specific access or workspace-wide access.

Step 2: Handle Domain-Wide Delegation (If Needed)

For a service account to access Gmail or Calendar on behalf of workspace users, you need to configure Domain-Wide Delegation in Google Admin console and grant the service account access to the specific OAuth scopes. This is an admin-level action and requires a Google Workspace admin.

Step 3: Build Separate Proxy Endpoints and a Combined Skill File

Build proxy endpoints for each service you're integrating — they have separate API base URLs and different response shapes. Write ~/.openclaw/skills/google-workspace.md explaining what's available across Gmail, Calendar, and Drive so Claude knows which service to query for which type of question.

Challenges and Caveats

This Is Multiple Integrations in One

Google Workspace isn't a single API — it's 5–10 separate APIs, each with their own rate limits, scopes, and response formats. Building a coherent integration across all of them is a significant project.

Gmail Scopes Are Sensitive

Gmail API scopes are classified as sensitive or restricted. If your OAuth app accesses Gmail for non-personal use, Google may require an app verification process before it can be used by more than a small number of test users.

Skip All of This — Use Cody Instead

Cody has Google Workspace integration built in — Calendar, Gmail, and Drive accessible from Slack without Cloud projects, domain delegation, or OAuth configuration.

Get started with Cody →

Related Guides

Need the model-flexible version? See: How to Connect Google Workspace to OpenClaw: Setup, Models, and Workflow Guide.