🦞OpenClaw Guide
← All Integrations
📅

Google Calendar

Easy⏱️ 10-15 minutes

Your calendar, handled by AI

OpenClaw Google Calendar Integration

Your calendar is the single source of truth for your day. But managing it — checking availability, creating events, prepping for meetings — takes more time than it should. The OpenClaw Google Calendar integration puts your schedule at your fingertips through natural conversation.

What You Can Do

Check Your Schedule

bash
You: What's on my calendar today?Assistant: You have 3 events:• 10:00 AM — Weekly standup (30 min)• 2:00 PM — Client call: Acme Corp (1 hour)• 4:30 PM — 1:1 with Sarah (30 min)You have a 90-minute gap from 12:30 to 2pm — good time for focused work.

Find Availability

bash
You: When am I free Thursday afternoon?Assistant: Thursday afternoon you're free from 1pm to 5pm — no events scheduled.

Create Events

bash
You: Schedule a team sync every Monday at 9am starting next weekAssistant: Done. Recurring event created: "Team Sync" every Monday 9:00–9:30 AM.

Meeting Prep

bash
You: I have a call with Acme in 20 minutes, brief meAssistant: Acme Corp call at 2pm:• Last email: yesterday, re: contract terms• Previous meeting: Jan 15 — discussed pricing• Notes from last call: they want annual billing option

Daily Briefings Set up a morning cron job so OpenClaw sends you a daily schedule briefing at 7am automatically.

Setup Guide

Prerequisites

  • OpenClaw installed (Cloud or self-hosted)
  • A Google account (free Gmail or Workspace both work)
  • The gog skill installed

Step 1: Install the gog skill

bash
clawdhub install gog

Step 2: Enable Google Calendar API

  1. Go to console.cloud.google.com
  2. Create a project or select existing
  3. Navigate to APIs & Services → Enable APIs
  4. Search for and enable Google Calendar API
  5. Create OAuth 2.0 credentials (Desktop app type)
  6. Download the credentials JSON file

Step 3: Configure OpenClaw

Add to your ~/.openclaw/config.yaml:

yaml
skills:  gog:    enabled: true    credentials: ~/.openclaw/google-credentials.json    scopes:      - calendar  # Google Calendar access

Step 4: Authenticate

bash
gog auth

A browser window opens. Sign in with your Google account and grant calendar permissions. Done.

Step 5: Test

bash
gog calendar today

You should see today's events. Now you can ask OpenClaw anything about your calendar.

Automation Ideas

Daily Morning Briefing

Set up a cron job to receive your day's schedule every morning:

yaml
crons:  - schedule: "0 7 * * *"    prompt: "Give me today's schedule and flag anything I need to prepare for"    channel: telegram

Meeting Prep Reminders

Automate pre-meeting context delivery:

yaml
crons:  - schedule: "*/15 * * * *"  # Every 15 minutes    prompt: "Check if I have a meeting in the next 20 minutes. If so, give me a quick brief on who it's with and what we discussed last time."    channel: telegram

Weekly Planning

Every Sunday evening, get a preview of the coming week:

yaml
crons:  - schedule: "0 18 * * 0"    prompt: "Give me a summary of next week's calendar and flag any conflicts or busy days"    channel: telegram

Advanced Usage

Multi-Calendar Support

OpenClaw can access multiple calendars in your account — personal, work, shared team calendars.

Natural Language Event Creation

No need for exact formats. OpenClaw understands:

  • "Lunch with Mike next Tuesday at noon"
  • "Doctor appointment Friday 3pm for 45 minutes"
  • "Quarterly review — block off next Friday morning"

Timezone Intelligence

OpenClaw is timezone-aware. If you're traveling, just mention your location and it adjusts.

Privacy & Security

  • OAuth 2.0 only — your Google password is never shared with OpenClaw
  • Tokens stored locally and encrypted
  • Revoke access anytime at myaccount.google.com/permissions
  • Self-hosted users: all data stays on your server

Troubleshooting

Events not showing

  • Run gog auth --reset to refresh authentication
  • Check Calendar API is enabled in Google Cloud Console
  • Verify the calendar is your primary or explicitly shared

Can't create events

  • Ensure you granted write permissions during OAuth
  • Check for calendar subscription vs. owned calendar (can't write to subscribed calendars)

Workspace users: Access denied

  • Your Google Workspace admin may need to approve the OAuth app
  • Ask them to whitelist the app in Google Admin Console

Features

Schedule Queries

Ask what's on your calendar today, this week, or any date. Get a clear view of your time.

Availability Finder

"When am I free Thursday?" — instantly see your open slots without opening Calendar.

Natural Language Event Creation

"Book team standup every Monday 9am" — OpenClaw creates and manages recurring events.

Daily Briefings

Automated morning schedule delivery to Telegram or WhatsApp before your day starts.

Meeting Prep

Before any call, get context: recent emails with that person, past notes, action items.

Multi-Calendar Support

Access personal, work, and shared team calendars all in one place.

Use Cases

Morning Briefing

Start every day with an automated schedule overview delivered to your phone before you get out of bed.

Quick Availability Check

Someone asks if you're free Friday — ask OpenClaw and reply instantly without opening your calendar.

Meeting Preparation

20 minutes before a call, get an AI brief on the person, recent emails, and past meeting context.

Voice-to-Event

Send a voice note about a new meeting and OpenClaw transcribes and creates the event.

Weekly Planning

Every Sunday, get a preview of the upcoming week and flag conflicts before they cause problems.

Setup Guide

Requirements

  • Google account (free Gmail or Google Workspace)
  • OpenClaw installed (Cloud or self-hosted)
  • gog skill installed via clawdhub
  • Google Calendar API enabled in Google Cloud Console
1

Install gog skill

Run: clawdhub install gog — this installs the Google integration skill for OpenClaw.

2

Enable Google Calendar API

Go to console.cloud.google.com, create a project, enable Google Calendar API, and create OAuth 2.0 credentials (Desktop app type).

3

Configure OpenClaw

Add gog skill config to ~/.openclaw/config.yaml with calendar scope enabled. Point it to your downloaded credentials JSON.

4

Authenticate

Run 'gog auth' — a browser window opens. Sign in and grant calendar permissions. Tokens are stored locally.

5

Test the connection

Run 'gog calendar today' or ask OpenClaw 'What's on my calendar today?' — you should see your events.

Configuration Example

skills:
  gog:
    enabled: true
    credentials: ~/.openclaw/google-credentials.json
    scopes:
      - calendar

# Optional: daily briefing cron
crons:
  - schedule: "0 7 * * *"
    prompt: "Give me today's schedule and flag anything I need to prepare for"
    channel: telegram

Limitations

  • ⚠️Cannot write to subscribed/external calendars (only owned calendars)
  • ⚠️Google Workspace users may need admin approval for OAuth app
  • ⚠️Real-time push notifications require webhook setup

Frequently Asked Questions

Does this work with free Gmail or only Google Workspace?

Both work. Free Gmail and Google Workspace accounts are fully supported. Workspace users may need their admin to approve the OAuth app first.

Can OpenClaw create and edit events, or just read them?

Both. OpenClaw can read your calendar, create new events, edit existing ones, and delete events — with your permission during setup.

Is my calendar data private?

Yes. OAuth 2.0 means your Google password is never shared. With self-hosted OpenClaw, all processing happens on your server. With Cloud, calendar data is processed to answer your query but never stored permanently.

Can it access shared team calendars?

Yes, as long as the calendar is shared with your Google account and you have the appropriate permissions.

Can I get automatic daily briefings?

Yes — set up a cron job in your OpenClaw config to deliver a schedule briefing to your Telegram or WhatsApp every morning.

🔥 Your AI should run your business, not just answer questions.

We'll show you how.Free to join.

Join Vibe Combinator →

🐙 Your AI should run your business.

Weekly live builds + template vault. We'll show you how to make AI actually work.Free to join.

Join Vibe Combinator →