Google Workspace
Your Google life, conversational
The Fastest Way: HeraClaw Cloud ā”
Skip the Google Cloud Console, OAuth consent screens, and API configuration. HeraClaw Cloud comes with Google Workspace integration pre-configured and ready to connect in 60 seconds.
Why HeraClaw Cloud for Google Workspace?
ā Ready in 60 seconds - No Google Cloud project creation, no OAuth app registration ā Pre-configured OAuth flow - Just click "Connect Google Account" and authorize ā All Google services enabled - Gmail, Calendar, Drive, Docs, Sheets, Contacts work immediately ā Automatic token refresh - We handle OAuth token expiration automatically ā Professional support - If Gmail API changes or breaks, we fix it ā Enterprise security - SOC 2 compliant, secure token storage
How it works:
- Sign up at heraclaw.ai (takes 60 seconds)
- Go to Integrations ā Google Workspace
- Click 'Connect Google Account'
- Authorize access in Google's OAuth screen
- Done! Ask your assistant about emails, calendar, or files
Get Started: Start with HeraClaw Cloud ā
Complete Guide to OpenClaw + Google Workspace
Google Workspace powers productivity for 3+ billion users worldwide. Gmail, Calendar, Drive, Docs, Sheets, and Contacts aren't just apps - they're the operating system of modern knowledge work. The OpenClaw integration brings your entire Google ecosystem into natural conversation, eliminating the 28% of workday time lost to email and the 20% lost searching for information.
This comprehensive guide covers everything from basic email summarization to advanced multi-tool automation workflows. Whether you're a solo entrepreneur managing your digital life or an enterprise team coordinating across time zones, you'll discover how conversational AI transforms Google Workspace productivity.
Why AI + Google Workspace Changes Everything
The average knowledge worker:
- Receives 120+ emails per day
- Attends 8+ meetings per week
- Searches for files 8-10 times daily
- Context-switches every 3 minutes
- Spends 2.5 hours daily on email alone
With OpenClaw, you simply ask for what you need. No context switching, no manual searching, no repetitive tasks.
Traditional workflow:
- Open Gmail in browser
- Scan through 47 unread emails
- Identify 3 that need immediate attention
- Draft replies
- Check calendar for conflicts
- Search Drive for relevant docs
- Attach files to emails
- Send replies
- Create tasks for follow-ups
Total time: 35+ minutes
OpenClaw workflow:
You: What needs my attention in email?Assistant: 3 urgent items:1. Mike (Acme Corp) asking for Q2 pricing - needs response by EOD2. Sarah requesting approval for vendor contract - attached PDF3. IT Security alert - suspicious login attempt flaggedWant me to draft responses or take any actions?You: Draft a reply to Mike with standard enterprise pricing, I'll meet his deadlineAssistant: Here's the draft:[Email draft with pricing details from your CRM]Send now or edit first?Total time: 3 minutes
Core Capabilities
Gmail - Email Intelligence
Smart Inbox Summarization
Get AI-generated briefings that understand priority:
You: Summarize my unread emailAssistant: 23 unread emails since yesterday:š“ Urgent (3):- Client escalation from Acme Corp (CEO sent personally)- Production incident report from DevOps (resolved, needs review)- Contract needs signature by EOD Fridayš” Action Needed (8):- 2 meeting invites awaiting response- 3 PR reviews requested- Budget approval request from Marketing- Expense report needs submission- Conference talk proposal deadline Fridayšµ FYI / Can Wait (12):- 5 newsletters (TechCrunch, Product Hunt, etc.)- 3 automated reports- 4 team updates / announcementsWhat do you want to tackle first?The assistant understands:
- Sender importance (CEO vs automated system)
- Urgency indicators ("URGENT", "EOD", deadlines)
- Action requirements (needs reply vs informational)
- Your typical patterns (what you usually prioritize)
Natural Language Email Search
Forget Gmail's search operators. Just ask:
"Find the email where Sarah sent the contract last month"ā Found: Contract_v3.pdf from Sarah Chen on March 12"Show me all emails about the website redesign project"ā Found 47 emails across 3 threads, filtered by relevance"Did anyone email about the Q2 planning meeting?"ā Yes, Mike sent the agenda on Tuesday (link to email)"Find receipts from Amazon in the last 30 days"ā 5 order confirmations found, total spent: $487.32No more from:sarah subject:contract after:2024/03/01 syntax memorization.
AI-Powered Email Drafting
Describe your intent, get professional prose:
You: Draft a reply to Mike saying we can meet Thursday 2pm, ask for the agenda beforehandAssistant:Subject: Re: Meeting Request - Thursday 2pm worksHi Mike,Thursday at 2pm works well for me. Before we meet, would you mind sending over the agenda so I can prepare accordingly?Looking forward to it.Best,[Your name]---Want me to send this or would you like to make changes?The assistant writes in your voice by learning from your sent email patterns.
Advanced: Batch Operations for Inbox Zero
You: Archive all promotional emails older than 30 daysAssistant: Found 247 promotional emails from the last 30+ days.Top senders:- Amazon (87 emails)- LinkedIn (34 emails)- Newsletters (126 emails)Archive all 247?You: Yes, archive themAssistant: Done. Archived 247 emails. Inbox: 23 ā 11Other batch operations:
- "Mark all newsletters as read"
- "Delete all automated reports older than 90 days"
- "Move all receipts to the Expenses label"
- "Unsubscribe from anything I haven't opened in 6 months"
Email-to-Task Automation
You: Create tasks from my unread emails that need actionAssistant: Created 5 tasks:ā Reply to Mike about pricing (due: today)ā Review Sarah's contract (due: Friday)ā Approve marketing budget (due: this week)ā Submit expense report (due: next Monday)ā Respond to 2 meeting invites (due: today)Added to your Todoist / Linear / Notion (whichever you use).Google Calendar - Schedule Intelligence
Conversational Schedule Queries
Ask about your calendar naturally:
"What's my week look like?"ā 14 meetings scheduled: - Mon: 3 meetings (10am standup, 2pm design review, 4pm 1:1) - Tue: 2 meetings - Wed: 4 meetings (busiest day) - Thu: 3 meetings - Fri: 2 meetings Busiest: Wednesday 10am-5pm solid"When am I free Thursday afternoon?"ā Thursday afternoon availability: - 1:30-2:00pm (30 min) - 3:30-5:00pm (90 min)"Do I have any meetings before noon tomorrow?"ā Yes, 2 meetings: - 9:00am: Team standup (30 min) - 10:30am: Client call with Acme Corp (60 min)Smart Scheduling with Availability Awareness
You: Find 30 minutes with Sarah and Mike next weekAssistant: Checking Sarah and Mike's calendars...Best options (all 3 free):1. Tuesday 2:00pm2. Wednesday 10:30am3. Thursday 3:00pmWhich works for you?You: Tuesday 2pm, create the meetingAssistant: Created "Strategy Sync" for Tuesday 2:00-2:30pm- Invited: sarah@company.com, mike@company.com- Location: Video call (link added)- Calendar event: https://calendar.google.com/...All participants confirmed available.Natural Language Event Creation
No forms, no date pickers. Just speak:
"Schedule a team standup every Monday at 9am"ā Created recurring event "Team Standup" - Every Monday 9:00-9:30am - Invited: [Your team] - Started: Next Monday"Add dentist appointment next Thursday at 3pm"ā Created "Dentist Appointment" - April 17, 3:00-4:00pm - Reminder: 1 hour before"Block focus time tomorrow 9am to noon"ā Created "Focus Time (No Meetings)" - Marked as busy - Declined incoming meeting requests automaticallyDaily Briefing with Context
You: Good morning, give me the rundownAssistant: Good morning! Here's your Friday, April 9:š
Calendar (3 meetings):10:00am - Team Standup (30 min)- Agenda: Sprint progress, blockers- Attendees: 8 engineers- Last week's notes: [link]2:00pm - Client Strategy Call (60 min)- Client: Acme Corp- Attendees: You, Sarah, Mike, + 3 from Acme- Context: Discussing Q2 partnership expansion- Recent emails: Mike sent agenda yesterday- Relevant docs: Acme_Proposal_v3.docx in Drive4:00pm - 1:1 with Sarah (30 min)- Last 1:1: 2 weeks ago- Topics discussed last time: Q2 roadmap, hiring- Action items from last time: All complete āš§ Email highlights:- 8 unread, 2 flagged urgent- DevOps sent incident report (reviewed and resolved)- Contract from legal needs signature by EODā ļø Heads up:- Q4 report due Monday (draft in Drive is 60% complete)- Your 10am has no agenda yet - want me to add usual standup format?- Acme Corp meeting in 6 hours - reviewed prep materials?Anything you want to prepare for?Google Drive - File Intelligence
Natural Language File Search
Find anything without navigating folders:
"Find the Q4 budget spreadsheet"ā Found: Q4_Budget_2024_Final_v2.xlsx Modified: 3 days ago by Sarah Location: Finance > 2024 > Q4 Link: [direct link]"Show me presentations from last month"ā Found 7 presentations: 1. Product_Roadmap_March.pptx (March 28) 2. Q1_Board_Review.pptx (March 15) 3. Sales_Kickoff_Deck.pptx (March 8) ..."Find anything Sarah shared with me this week"ā 4 files shared by Sarah: - Contract_Draft.pdf (Tuesday) - Meeting_Notes_Apr8.docx (Wednesday) - Budget_Update.xlsx (Yesterday) - Design_Mockups.fig (Today)Document Summarization
Read and understand document contents:
You: Summarize the project proposal docAssistant: Summary of "Website_Redesign_Proposal.docx":**Overview:** Complete redesign of company website targeting Q2 launch**Key Points:**- Budget: $75K (design $30K, dev $40K, misc $5K)- Timeline: 12 weeks (April 15 - July 8)- Team: 2 designers, 3 developers, 1 PM- Tech stack: Next.js, Tailwind CSS, headless CMS**Phases:**1. Discovery & wireframes (2 weeks)2. Visual design (3 weeks)3. Development (5 weeks)4. QA & launch (2 weeks)**Success Metrics:**- 50% improvement in page load time- 30% increase in conversion rate- Mobile-first responsive design**Risks:**- Dependency on design approval timeline- CMS migration may reveal edge cases- Resource contention with mobile app project**Next Steps:**- Stakeholder approval needed by April 12- Kickoff meeting April 15Want me to extract action items or create tasks from this?File Organization
"Move all invoices from January to the Archive folder"ā Found 23 invoices with "January" or "Jan 2024" in name Moving to /Archive/2024/Invoices/... Done. 23 files moved."Create a folder called 'Q2 Planning' and move all files with Q2 in the name there"ā Created /Q2 Planning/ Found 17 files matching "Q2" Moved 17 files. Link: [folder link]Google Docs & Sheets - Content Queries
Document Reading and Q&A
You: What were the action items from the meeting notes doc?Assistant: From "Team_Meeting_Apr8.docx":Action Items:1. Sarah - Finalize Q2 roadmap by Friday ā (marked complete)2. Mike - Review vendor contracts (due April 12)3. You - Approve marketing budget (due this week)4. DevOps - Complete security audit (due April 15)5. Design - Share mobile mockups for feedback (no due date)3 of 5 complete. 2 still pending.Spreadsheet Queries
"What's the total in column D of the sales tracker?"ā Sales_Tracker_Q1.xlsx Column D (Revenue): $847,392 (Sum of 47 rows, last updated yesterday)"Show me the top 5 customers by revenue in the spreadsheet"ā Top 5 customers: 1. Acme Corp - $145K 2. TechStart Inc - $98K 3. Global Industries - $87K 4. StartupCo - $76K 5. Enterprise LLC - $65K"What's our average deal size this quarter?"ā Average deal size: $12,847 (Based on 67 closed deals in Q1_Sales_Tracker.xlsx)Quick Updates
"Add a row to the expenses sheet: $150 for office supplies today"ā Added to Expenses_2024.xlsx: Row 47: April 9, Office Supplies, $150.00, General New total: $8,472"Update cell B12 in the budget sheet to $25000"ā Updated Q2_Budget.xlsx Cell B12: $18,500 ā $25,000 Total recalculated: $247,000Real-World Workflow Examples
Morning Routine - The Daily Briefing
You: Good morning, brief meAssistant: Good morning! Friday, April 9, 2026š
Today's Calendar:- 10:00am: Team standup (usual crew)- 2:00pm: Client call with Acme Corp (prep needed)- 4:00pm: 1:1 with Sarahš§ Email Priorities (8 unread):š“ Urgent:- Contract signature needed by EOD (from Legal)- Client escalation from Acme Corp CEO (!) š” Action needed:- 2 meeting invites to respond to- Budget approval request (Marketing)- PR review requested (GitHub)šµ FYI:- 3 newsletters (can archive?)š Drive Activity:- Sarah updated Q2_Budget.xlsx (2 hours ago)- New file shared: Acme_Contract_Final.pdfā ļø Heads Up:- Acme call in 6 hours - agenda in Drive, contract ready for discussion- Q4 report due Monday (currently 60% complete)- Your standup has no agenda - add the usual format?What's your priority this morning?You: Handle the contract signature first, then prep me for the Acme callAssistant: ā Contract signed and returned to legal@company.comAcme Corp Call Prep:**Context:**- Client since Feb 2024 ($145K/year)- Recent emails: CEO escalated question about Q2 pricing (yesterday)- Contract: Renewal discussion, potential expansion**Their Team (from calendar invite):**- John Smith (CEO)- Sarah Johnson (Head of Product)- Mike Chen (CFO)**Our Team:**- You- Sarah (from our Product)- Mike (our Sales)**Agenda** (from Acme_Meeting_Agenda.docx):1. Q1 performance review2. Q2 pricing discussion3. Feature roadmap alignment4. Contract renewal terms**Documents ready:**- Acme_Contract_Final.pdf (in Drive)- Acme_Q1_Performance.xlsx (metrics)- Q2_Pricing_Enterprise.pptx (updated yesterday)**Recommended talking points:**- Q1 performance: +23% usage vs forecast (strong adoption)- Q2 pricing: CEO asked about volume discount - prepared 15% off for annual commitment- Feature requests: They want SSO (on roadmap for Q3)- Renewal: Current contract expires June 30 - propose early renewal with expanded seats**Potential objections:**- Price increase concerns (be ready with ROI data)- SSO timeline (can we accelerate to Q2?)Open the performance deck now or anything else?Email Triage - Smart Inbox Management
You: Clean up my email, I need inbox zeroAssistant: Starting email triage...**Newsletters (18 found):**- TechCrunch, Product Hunt, Morning Brew, etc.- Keep unread or archive?You: Summarize this week's, archive the restAssistant: This week's newsletter highlights:**TechCrunch:**- OpenAI released new embeddings model (12% better performance)- Anthropic announced Claude Opus 4.6 (new frontier model)- YC Winter 2024 batch: 3 AI dev tools in top 10**Product Hunt:**- Top launch: AI code review tool (4,200 upvotes)- AI video editor trending (workflow automation angle)- "AI agent" category now official on PH**Morning Brew:**- Fed signals rate cuts coming Q2 2024- Tech layoffs down 60% vs 2023- Enterprise SaaS spending reboundingā Archived 18 newsletters, kept summaries**Automated Reports (7 found):**- Weekly metrics, build notifications, uptime reports- Action needed?You: Delete any older than 7 days, summarize this week's metricsAssistant:ā Deleted 5 old reportsThis week's metrics:- MRR: $847K (+3.2% WoW)- Active users: 12,847 (+1.8%)- Churn: 2.1% (target: <3%)- Support tickets: 47 (down from 63 last week)- Uptime: 99.97%- Build status: All green ā**Remaining items (12):**- 2 require response (meeting invites)- 3 are FYI (team updates)- 4 need action (approvals, reviews)- 3 are from clients (need attention)Want me to handle meeting invites and draft responses to client emails?You: Yes, accept both meeting invites if I'm free, draft replies to clientsAssistant:ā Accepted both meetings (no conflicts)Client email drafts ready:1. **To: Acme Corp (John)**Re: Q2 Pricing Question[Professional response with pricing details]Send or edit?2. **To: TechStart Inc (Sarah)**Re: Feature Request - SSO Integration[Response explaining Q3 roadmap for SSO]Send or edit?3. **To: Global Industries (Mike)** Re: Invoice Question[Clarification about billing cycle]Send or edit?You: Send all threeAssistant: ā Sent 3 emails to clients**Inbox Status:**- Started with: 47 unread- Now: 4 remaining (all require your personal attention)- Time saved: ~45 minutesThe 4 remaining emails are team approvals that need your decision. Want to review those now?Meeting Preparation - Context Assembly
You: I have a call with Acme Corp in 30 minutes, prep meAssistant: Acme Corp Call Prep - 28 minutes until meeting**Meeting Details:**- Time: 2:00-3:00pm today- Attendees: You, Sarah, Mike (our side) + 3 from Acme- Location: Zoom (link in calendar)- Agenda: Q2 planning discussion**Recent Context:**š§ **Last 5 emails with Acme** (past 2 weeks):1. April 7: John (CEO) asked about Q2 pricing ā You responded yesterday2. April 3: Sarah (their Product) sent feature requests (SSO, SAML)3. March 28: Mike (CFO) invoice question ā Resolved4. March 25: Contract renewal discussion started5. March 20: Q1 performance review (very positive)š **Relevant Drive Files:**- Acme_Contract_v3.pdf (updated April 5)- Acme_Q1_Performance.xlsx (metrics dashboard)- Q2_Pricing_Enterprise.pptx (your pricing deck)- Acme_Feature_Requests.docx (their wishlist)š
**Previous Meetings:**- Last call: March 20 (Q1 review)- Action items from last time: All completed ā- Their feedback: "Impressed with platform performance"**Key Numbers:**- Customer since: Feb 2024 (14 months)- Current MRR: $12,083- Active users: 247 (up from 180 at start)- Usage trend: +23% quarter-over-quarter- Contract expires: June 30, 2024**Their Current Plan:**- Enterprise tier- 250 seats- Annual contract- Custom SSO (pending - they want it Q2)**Likely Discussion Points:**1. **Q2 Pricing** - They asked about volume discount - Your response: 15% off for annual renewal + 100 more seats - Be prepared: They may negotiate for 20%2. **Feature Requests** - SSO/SAML (top priority for them) - Your roadmap: Q3 planned - Question: Can you accelerate to Q2?3. **Contract Renewal** - Expires in 82 days - Proposal: Early renewal (commit now, get discount) - Upsell opportunity: Additional 100 seats ($4K/month extra)4. **Performance Review** - Usage up 23% (good signal) - 2 support tickets last quarter (low, good) - NPS score from them: 9/10**Recommended Approach:**- Lead with Q1 success (usage growth, low support burden)- Address SSO timeline (commit to Q2 if possible)- Present pricing options (annual discount vs monthly flexibility)- Ask about expansion plans (their company growing?)**Potential Objections:**- "SSO is taking too long" ā Offer Q2 delivery if they commit today- "Price increase is steep" ā Show ROI: their team saves X hours/week- "We're evaluating competitors" ā Emphasize switching cost, current success**Quick Wins for This Call:**- Commit to SSO delivery date- Offer early renewal discount (time-limited)- Propose quarterly business reviews (deepen relationship)Open any of these docs now? Set any reminders for the call?You: Open the pricing deck and remind me to ask about their expansion plansAssistant: ā Opened Q2_Pricing_Enterprise.pptxā Reminder set: "Ask about Acme's expansion plans" (will notify during call)You're ready. Good luck! Want me to listen in and take notes?Project Status Update - Cross-Tool Synthesis
You: What's the status of the website redesign project?Assistant: Website Redesign Project Status - April 9, 2024**Overall:** 67% complete, slightly behind schedule**Timeline:**- Started: April 1 (9 days ago)- Target launch: July 8 (90 days total, 81 days remaining)- Current pace: On track if no more delays**Phase Breakdown:**ā
**Phase 1: Discovery & Wireframes** (Complete)- Completed: April 8 (on time)- Deliverable: Wireframes_v2.fig (in Drive)- Stakeholder approval: ā Approved April 9š **Phase 2: Visual Design** (In Progress - 40% done)- Started: April 9 (today)- Due: April 29 (20 days)- Progress: Homepage design 80%, product page 30%, about page 0%- Designer: Sarah (assigned)- Blockers: Waiting on brand guidelines update from Marketing- Latest update: "Homepage looking good, client feedback positive" (Sarah, 2 hours ago)ā³ **Phase 3: Development** (Not Started)- Scheduled: May 1 - June 4- Team: 3 developers assigned- Dependencies: Design phase must completeā³ **Phase 4: QA & Launch** (Not Started)- Scheduled: June 5 - July 8- QA lead: Mike (assigned)**Budget:**- Allocated: $75,000- Spent so far: $18,400 (24.5%)- Remaining: $56,600- Burn rate: Healthy (tracking ~25% spend at 25% timeline)**Team Activity** (from Drive, Email, Calendar):š **Recent Drive updates:**- Sarah uploaded Homepage_Design_v4.fig (3 hours ago)- Mike commented on wireframes doc (yesterday)- Product page wireframes updated (2 days ago)š§ **Recent emails:**- Sarah ā You: "Homepage ready for review" (today)- Marketing ā Team: "Brand guidelines delayed 1 week" (yesterday)- DevOps ā You: "Staging environment ready" (2 days ago)š
**Upcoming meetings:**- Design review: Tomorrow 10am- Stakeholder demo: Next Friday- Sprint planning: Monday April 15**Blockers** šØ:1. **Brand guidelines delay** (High impact) - Marketing pushed delivery from April 8 ā April 15 - Impact: Design phase may slip 1 week - Mitigation: Sarah working on other pages while waiting2. **Developer availability** (Medium impact) - One dev (John) on vacation May 1-10 - Impact: Development phase may need 5 extra days - Mitigation: Can we bring in contractor?**Risks:**- If design slips 1 week, entire project slips (no buffer built in)- CMS migration unknowns (may surface edge cases during dev)- Resource contention with mobile app project in June**Next Milestones:**- April 15: Brand guidelines from Marketing (delayed)- April 29: Visual design complete- May 1: Development kickoff- June 5: QA begins- July 8: Launch**Recommended Actions:**1. **Immediate:** Follow up with Marketing on brand guidelines (blocker)2. **This week:** Review Sarah's homepage design (she's waiting on feedback)3. **Next week:** Decide on contractor for May (cover John's vacation)4. **Ongoing:** Weekly status updates to stakeholders (currently ad-hoc)Want me to:- Draft an email to Marketing about the brand guidelines?- Schedule a status meeting with the team?- Create a task to review Sarah's design?- Update the project timeline based on current pace?Enterprise Considerations
Google Workspace vs Free Gmail
| Feature | Free Gmail | Google Workspace |
|---|---|---|
| Works with OpenClaw | ā Yes | ā Yes |
| Custom domain email | ā No | ā Yes |
| Admin controls | ā No | ā Yes |
| Shared drives | ā No | ā Yes |
| Advanced security | ā Limited | ā Full (2FA, SSO) |
| Storage | 15 GB free | 30 GB - Unlimited |
| OAuth app approval | Self-managed | Admin approves |
| Support | Community | 24/7 enterprise |
| SLA | None | 99.9% uptime |
Both work perfectly with OpenClaw. Workspace users may need IT admin approval for OAuth.
Multi-User Enterprise Deployment
For organizations with 10+ users:
Option 1: Shared Assistant (Most Common)
- One HeraClaw Cloud instance
- All employees authorize their Google accounts
- Shared knowledge base and skills
- Centralized billing
- IT admin oversight
Best for: Teams collaborating closely, shared context helpful
Option 2: Personal Assistants
- Each employee gets their own HeraClaw instance
- Isolated Google account access (privacy)
- Personalized configurations
- Individual billing or company-paid
Best for: Executives, roles requiring strict privacy
Option 3: Hybrid (Enterprise)
- Shared assistant for general tasks
- Personal assistants for leadership/sensitive roles
- Centralized management dashboard
- Usage analytics and compliance
Best for: Large organizations (100+ employees)
Google Workspace Admin Approval Process
If your organization uses Google Workspace, IT admins control which OAuth apps can be used.
HeraClaw Cloud (Easy):
- Send your IT admin this link: heraclaw.ai/security/google-workspace
- Admin reviews our OAuth scopes and security
- Admin approves HeraClaw in Google Workspace admin console
- All employees can now connect (one-time approval)
Typical approval time: 1-3 business days
Self-Hosted (Complex):
- You create a Google Cloud project
- Configure OAuth consent screen
- Submit for verification (if >100 users)
- Google reviews your app (7-14 days)
- Admin approves your custom OAuth app
Typical approval time: 2-4 weeks
Data Residency and Compliance
For regulated industries:
HeraClaw Cloud:
- Data processing in US-East or EU (your choice)
- SOC 2 Type II certified
- GDPR compliant
- HIPAA available (Business Associate Agreement)
- Google OAuth tokens encrypted at rest (AES-256)
Self-Hosted:
- Full control over data location
- You manage compliance
- OAuth tokens stored locally (you encrypt)
Setup Option 1: HeraClaw Cloud (Recommended)
Time required: 60 seconds Technical skill: None Cost: Included in HeraClaw Cloud subscription Best for: 98% of users
Steps:
1. Sign up for HeraClaw Cloud
- Visit heraclaw.ai
- Click "Sign In"
- Create your account (60 seconds, no credit card)
2. Navigate to Integrations
- Dashboard ā Integrations
- Find "Google Workspace"
- Click "Connect Google Account"
3. Google OAuth Authorization
- Google's authorization screen appears
- Select your Google account
- Review permissions:
- Read and send Gmail
- Access Google Calendar
- Access Google Drive files
- Read and write Google Docs
- Access Contacts
- Click "Allow"
4. Done!
- You're redirected back to HeraClaw
- Green checkmark appears
- Test it: Ask "What's on my calendar today?"
What You Get:
ā Instant Access - All Google services work immediately ā Automatic Token Refresh - We handle OAuth token expiration ā Professional Support - If Google API breaks, we fix it ā Security - SOC 2 compliant token storage ā Multi-Account - Connect multiple Google accounts (work + personal) ā No Maintenance - We handle Google API changes
Get Started: Start with HeraClaw Cloud ā
Setup Option 2: Self-Hosted (Advanced)
Time required: 20-30 minutes (first time) Technical skill: Intermediate Cost: Free (Google APIs are free) Best for: Technical users, compliance requirements
Prerequisites:
- OpenClaw installed and running
- Google account
- Basic understanding of OAuth 2.0
Step-by-Step Self-Hosted Setup
Step 1: Create Google Cloud Project
- Go to console.cloud.google.com
- Click "Select a Project" ā "New Project"
- Project name: "OpenClaw Integration" (or your choice)
- Click "Create"
- Wait 30 seconds for project creation
Step 2: Enable Required APIs
- In Google Cloud Console, go to "APIs & Services" ā "Library"
- Search and enable these APIs (click "Enable" for each):
- Gmail API
- Google Calendar API
- Google Drive API
- Google Docs API
- Google Sheets API
- People API (for Contacts)
This takes about 2 minutes total.
Step 3: Configure OAuth Consent Screen
- Go to "APIs & Services" ā "OAuth consent screen"
- User Type:
- External if using personal Gmail
- Internal if using Google Workspace (requires Workspace admin)
- Click "Create"
- Fill in the form:
- App name: "OpenClaw Assistant"
- User support email: your-email@gmail.com
- Developer contact: your-email@gmail.com
- Click "Save and Continue"
Step 4: Add OAuth Scopes
- Click "Add or Remove Scopes"
- Filter and add these scopes:
Gmail scopes:
https://www.googleapis.com/auth/gmail.modify(read and send email)https://www.googleapis.com/auth/gmail.labels(manage labels)
Calendar scopes:
https://www.googleapis.com/auth/calendar(full calendar access)
Drive scopes:
https://www.googleapis.com/auth/drive(full drive access)- Or more restrictive:
https://www.googleapis.com/auth/drive.readonly(read-only)
Docs/Sheets scopes:
https://www.googleapis.com/auth/documents(Google Docs)https://www.googleapis.com/auth/spreadsheets(Google Sheets)
Contacts scope:
https://www.googleapis.com/auth/contacts.readonly(read contacts)
- Click "Update" ā "Save and Continue"
Step 5: Add Test Users (If External)
If you chose "External" user type:
- Click "Add Users"
- Add your Gmail address
- Add any other users who'll use this (max 100 in testing mode)
- Click "Save and Continue"
Note: To remove the 100-user limit, you need to submit for Google verification (takes 1-2 weeks).
Step 6: Create OAuth Credentials
- Go to "APIs & Services" ā "Credentials"
- Click "Create Credentials" ā "OAuth client ID"
- Application type: Desktop app (most common) or Web application (if exposing OpenClaw over HTTP)
- Name: "OpenClaw Desktop"
- If Web application:
- Authorized redirect URIs:
http://localhost:8080/oauth/callback(or your OpenClaw URL)
- Authorized redirect URIs:
- Click "Create"
Step 7: Download Credentials
- A popup appears with Client ID and Client Secret
- Click "Download JSON"
- Save as
google_credentials.json - Keep this file secure - it's your OAuth app identity
Step 8: Configure OpenClaw
Edit ~/.openclaw/config.yaml (or ~/.config/openclaw/config.yaml):
integrations: google: enabled: true # Path to credentials JSON from Step 7 credentialsPath: "/path/to/google_credentials.json" # Where to store OAuth tokens (created automatically) tokensPath: "/Users/you/.openclaw/google_tokens.json" # Optional: Specific services to enable services: gmail: true calendar: true drive: true docs: true sheets: true contacts: true # Optional: Default Gmail query settings gmail: maxResults: 50 includeSpam: false # Optional: Calendar settings calendar: defaultReminderMinutes: 30 maxEvents: 50Step 9: Authenticate
Run the OpenClaw authentication flow:
openclaw auth googleOr if using a skill:
clawdhub install gog # Google OAuth Gateway skillgog authWhat happens:
- OpenClaw opens your browser
- Google OAuth screen appears
- Sign in with your Google account
- Review permissions
- Click "Allow"
- Browser shows "Authentication complete, you can close this window"
- OpenClaw saves tokens to
tokensPath
Step 10: Test the Connection
# Test Gmailopenclaw exec "What emails did I get today?"# Or with gog skillgog mail list --max 5# Test Calendargog calendar today# Test Drivegog drive search --query "budget"If it works, you'll see results. If not, check logs:
openclaw logs --tail 50Advanced Self-Hosted Configuration
Multiple Google Accounts
Connect both work and personal Gmail:
integrations: google: accounts: work: credentialsPath: "/path/to/work_credentials.json" tokensPath: "/path/to/work_tokens.json" services: gmail: true calendar: true personal: credentialsPath: "/path/to/personal_credentials.json" tokensPath: "/path/to/personal_tokens.json" services: gmail: true drive: trueThen query specific accounts:
"Check my work email""What's on my personal calendar?"Service-Specific Settings
integrations: google: gmail: # Default query settings maxResults: 100 includeSpam: false includeTrash: false # Auto-archive settings autoArchive: newsletters: true promotional: true olderThanDays: 30 calendar: # Default event duration (if not specified) defaultDurationMinutes: 30 # Reminder settings defaultReminders: - method: "popup" minutes: 30 # Working hours (for scheduling) workingHours: start: "09:00" end: "17:00" # Time zone timeZone: "America/New_York" drive: # Default folder for uploads defaultFolder: "OpenClaw" # File search settings maxResults: 50 includeShared: true includeTrashed: falseRead-Only Mode (Extra Security)
For maximum security, use read-only scopes:
integrations: google: gmail: readOnly: true # Can read email, cannot send drive: readOnly: true # Can search/read files, cannot modify calendar: readOnly: false # Still allow creating eventsUpdate OAuth scopes in Google Cloud Console to match.
Troubleshooting Self-Hosted
"Access Denied" During OAuth
Cause: APIs not enabled or OAuth consent screen incomplete
Fix:
- Go to Google Cloud Console ā APIs & Services ā Library
- Verify all required APIs are enabled (green checkmark)
- Go to OAuth consent screen ā ensure status is "Published" or "Testing"
- If "Testing", add your email to Test Users
"Redirect URI Mismatch" Error
Cause: OAuth callback URL doesn't match credentials configuration
Fix:
- Check the error message for the actual redirect URI
- Go to Google Cloud Console ā Credentials ā Edit your OAuth client
- Add the exact redirect URI from error to "Authorized redirect URIs"
- Common values:
- Desktop app:
http://localhostorurn:ietf:wg:oauth:2.0:oob - Web app:
http://localhost:8080/oauth/callback
- Desktop app:
"Invalid Grant" Error
Cause: OAuth token expired or revoked
Fix:
# Delete old tokensrm ~/.openclaw/google_tokens.json# Re-authenticateopenclaw auth google# orgog auth --reset"Quota Exceeded" Errors
Cause: Hit Gmail/Calendar/Drive API rate limits
Google's free tier limits:
- Gmail: 1 billion quota units/day (generous)
- Calendar: 1 million requests/day
- Drive: 20,000 requests/100 seconds per user
Fix:
- Normal usage never hits these limits
- If you do, you're likely polling too frequently
- Check for infinite loops in custom skills
- Add rate limiting to your queries
Emails/Events Not Showing
Cause: Wrong calendar or Gmail filters
Fix:
# Check which calendar is primarygog calendar list# Verify Gmail connectiongog mail list --max 1# Check logs for detailed errorsopenclaw logs | grep googleSlow Responses
Cause: Large mailbox or many Drive files
Fix:
- Use date filters: "emails from this week" not "all emails"
- Limit results:
maxResults: 20in config - Index your mailbox (some skills support local indexing)
Comparison: HeraClaw Cloud vs Self-Hosted
| Feature | HeraClaw Cloud | Self-Hosted |
|---|---|---|
| Setup time | 60 seconds | 20-30 minutes |
| Google Cloud project | Not needed | You create |
| OAuth configuration | Pre-configured | Manual setup |
| API quotas | Shared pool (large) | Your account limits |
| Token refresh | Automatic | You implement |
| Google API changes | We handle | Manual updates |
| Support | Professional | Community |
| Multi-account | Easy (click to add) | Manual config |
| Cost | Subscription | Free (API usage free) |
| Security | SOC 2 certified | DIY |
| Workspace approval | One-time admin approval | Per-user approval |
Frequently Asked Questions
Q: Is it safe to connect my Google account to an AI assistant?
A: Yes. OpenClaw uses Google's official OAuth 2.0 protocol - the same used by thousands of apps. You authorize specific permissions (read email, manage calendar, etc.) and can revoke access anytime from myaccount.google.com/permissions. HeraClaw Cloud is SOC 2 certified with encrypted token storage. Self-hosted gives you full control over where tokens are stored.
Q: Can it read my emails?
A: Only if you grant the Gmail API permission during OAuth. The scope gmail.modify allows reading and sending email. If you want read-only, use gmail.readonly scope in your Google Cloud project setup.
Q: Will it send emails without asking me?
A: Default behavior: OpenClaw asks for confirmation before sending. Example: "Draft ready, send now or edit first?" You can configure auto-send for specific workflows (like automated reports).
Q: What happens to my data?
HeraClaw Cloud:
- OAuth tokens encrypted at rest (AES-256)
- Email/calendar/file content processed in memory only
- No permanent storage of your Google data (we query Google APIs on-demand)
- SOC 2 Type II certified
- GDPR compliant
Self-hosted:
- OAuth tokens stored locally on your server (you control encryption)
- All data stays on your infrastructure
- You control logs and retention
Q: Does this work with personal Gmail or only Google Workspace?
A: Both work perfectly. Personal Gmail (@gmail.com) and Google Workspace (custom domain) are fully supported. Workspace users may need IT admin approval for OAuth apps.
Q: What if my company uses Google Workspace and IT blocks third-party apps?
HeraClaw Cloud: Send your IT admin heraclaw.ai/security/google-workspace. We provide security documentation for admin review. Most companies approve within 1-3 business days.
Self-hosted: You control the OAuth app (it's yours). IT admin approves your custom app, not a third party.
Q: Can I connect multiple Google accounts (work + personal)?
A: Yes. HeraClaw Cloud supports multiple Google accounts with easy switching. Self-hosted requires configuration (see Advanced Setup above).
Q: What Google services are supported?
A: Full support for:
- ā Gmail (read, send, search, labels, drafts)
- ā Google Calendar (events, availability, scheduling)
- ā Google Drive (search, upload, download, organize)
- ā Google Docs (read, edit, create)
- ā Google Sheets (read, edit, query)
- ā Google Contacts (read, search)
Partial/roadmap:
- ā³ Google Meet (join meetings via link - full integration coming)
- ā³ Google Forms (read responses)
- ā³ Google Slides (read, basic edit)
Q: Does it work offline?
A: No. Google APIs require internet connection. However, some skills support caching recently accessed data for faster responses.
Q: How fast are responses?
A: Typical latency:
- Gmail queries: 500ms - 2 seconds
- Calendar queries: 300ms - 1 second
- Drive searches: 1 - 3 seconds (depends on result count)
- Email sending: 1 - 2 seconds
Q: Are there any costs or limits?
Google API costs: FREE for normal usage. Google's free tier is extremely generous:
- Gmail: 1 billion quota units/day
- Calendar: 1 million requests/day
- Drive: 20,000 requests/100 seconds
You'll never hit these limits with normal assistant usage.
HeraClaw Cloud costs: See heraclaw.ai/pricing
Self-hosted costs: Free (you pay for your server/VPS)
Q: Can it create calendar events for other people?
A: Yes, if you have permission. The assistant can:
- Create events on your calendar and invite others
- Create events on shared calendars (if you have edit access)
- Check availability across multiple calendars (if shared with you)
Cannot: Create events on someone else's calendar unless they've shared edit access with you.
Q: What about Gmail filters and labels?
A: Fully supported. The assistant can:
- Apply existing labels
- Create new labels
- Search by label
- Set up filter rules (via conversation)
Example: "Label all emails from @acmecorp.com as 'Client - Acme'"
Q: Can it handle attachments?
A: Yes:
- Download attachments from Gmail
- Read attachments (PDFs, images, docs)
- Send emails with attachments from Drive
- Save attachments to Drive
Example: "Find invoices in my email from last month and save them to the Invoices folder in Drive"
Q: Does it understand email threads?
A: Yes. Gmail threads (conversations) are fully understood. The assistant can:
- Summarize entire email threads
- Reply to the latest message in a thread
- Find specific messages within long threads
Q: What if I revoke access?
A: Go to myaccount.google.com/permissions ā Find "OpenClaw" or "HeraClaw" ā Click "Remove Access". The assistant will immediately lose access and notify you. You can reconnect anytime.
Q: Can the assistant schedule meetings with people outside my organization?
A: Yes, as long as you can normally invite them to calendar events. The assistant creates events just like you would manually - external attendees get email invites.
Get Started
Recommended for 98% of users:
- 60-second setup
- No Google Cloud configuration
- Professional support
- Automatic updates
For advanced users only:
Questions? Email support@heraclaw.ai
Last updated: April 9, 2026
Features
Gmail Inbox Management
Summarize unread emails, draft replies in your voice, smart search with natural language, and batch operations for inbox zero.
Calendar Intelligence
Check your schedule, find availability across calendars, create events with natural language, and get daily briefings.
Drive Search & Access
Find files with natural language, get document summaries, and organize files ā no more folder diving.
Docs & Sheets Integration
Read document contents, query spreadsheet data, and make quick updates through conversation.
Contacts & Directory
Look up anyone's info, find the right person to email, and manage your address book.
Cross-App Intelligence
Meeting prep that pulls emails, docs, and calendar history for any contact or company.
Use Cases
Morning Briefing
Start each day with AI-generated summary: today's meetings, priority emails, deadlines, and items needing attention.
Email Triage
Let AI categorize your inbox: urgent, action needed, FYI. Handle newsletters, batch archive, and focus on what matters.
Meeting Preparation
Before any call, get context: recent emails with that person, relevant docs, past meeting notes, action items.
Smart Scheduling
Find times that work for everyone. 'Schedule 30 minutes with Sarah and Mike next week' checks all calendars.
Document Discovery
Find any file with natural language. 'The proposal we sent to Acme last quarter' finds it instantly.
Email Drafting
Dictate intent, get polished emails. 'Tell them we accept the terms but need the timeline extended' becomes professional prose.
Inbox Zero Automation
Batch process newsletters, archive old threads, and auto-label incoming mail based on content.
Travel & Logistics
Get flight confirmations, hotel bookings, and itineraries from emails, added to your calendar automatically.
Setup Guide
Requirements
- āGoogle account (personal or Workspace)
- āOAuth consent configuration
- āOpenClaw running on a server or Mac
Install the gog skill
Run 'clawdhub install gog' to get the Google Workspace integration.
Create OAuth credentials
Set up a Google Cloud project and create OAuth 2.0 credentials for desktop application.
Authenticate
Run 'gog auth' and follow the browser flow to grant access to your Google account.
Test the connection
Try 'gog mail list' or 'gog calendar events' to verify access.
Limitations
- ā ļøInitial OAuth setup requires some configuration
- ā ļøSome advanced features need Google Workspace (not free Gmail)
Frequently Asked Questions
Can I integrate Gmail and Google Drive with an AI assistant?
Yes ā OpenClaw connects to your full Google Workspace. Read and send Gmail, search and create Drive files, manage Calendar events, and edit Docs ā all from Telegram or WhatsApp without opening a browser.
How does the Gmail Google Drive integration work?
OpenClaw uses OAuth2 to connect to your Google account. Once authorized, you can ask your assistant to 'find that invoice from last week in Drive', 'send an email to John', or 'add a meeting Thursday at 3pm' ā it handles the API calls automatically.
Is it safe to connect Google account to an AI assistant?
OpenClaw uses standard OAuth2 ā the same protocol Gmail uses for third-party apps. You authorize specific scopes (read email, manage calendar, etc.) and can revoke access anytime from your Google Account settings. Your credentials are never stored in plain text.
What Google services does OpenClaw integrate with?
Gmail (read + send), Google Drive (search, upload, download), Google Calendar (read + create events), Google Docs (read + edit), and Google Contacts. All accessible from your messaging app of choice.
š„ Your AI should run your business, not just answer questions.
We'll show you how.Free to join.
Related Integrations
š Learn More
Setting Up API Keys for All Providers ā Complete Guide
Complete guide to configuring API keys and authentication for all OpenClaw providers including Anthropic, OpenAI, Google, OpenRouter, and OAuth-based services like Gmail. Covers multi-auth, token refresh issues, and proper config file structure.
How to Connect AI to Google Calendar with OpenClaw (2026)
Connect OpenClaw to Google Calendar: create events, check your schedule, and get reminders via WhatsApp or Telegram. Just say 'add meeting tomorrow at 3pm.'
OpenClaw vs Google Gemini
More than search ā real assistance
OpenClaw Workspace Templates: The Minimal SOUL.md and USER.md That Keep Your Tokens Low
## Every Line You Write Gets Sent to the API on Every Request
š 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 ā