Google Drive

The Fastest Way: HeraClaw Cloud ⚡

Skip the Google Cloud Console setup, OAuth configuration, and API credential management. HeraClaw Cloud comes with Google Drive integration pre-configured and ready to use in 60 seconds.

Why HeraClaw Cloud for Google Drive?

✅ Ready in 60 seconds - No Google Cloud project, no OAuth consent screen, no credential JSON files ✅ Pre-configured API access - Works immediately after authorization ✅ Always updated - We handle Google API changes and quota management automatically ✅ Professional support - If anything breaks, we fix it for you ✅ Secure by default - Enterprise-grade security, encrypted credentials, SOC 2 compliant ✅ Zero maintenance - No token refresh logic, no quota monitoring, no debugging

How it works:

1. Sign up at cloud.getopenclaw.ai (takes 60 seconds)
2. Go to Integrations → Google Drive
3. Click 'Connect to Google Drive'
4. Authorize access to your Drive
5. Done! Start asking questions about your files

Get Started: Start with HeraClaw Cloud →

Complete Guide to OpenClaw + Google Drive

Google Drive is the world's most popular cloud storage platform, with over 1 billion users storing 2+ trillion files. It's where individuals and businesses keep their most important documents, spreadsheets, presentations, and media. OpenClaw's Google Drive integration transforms your Drive into an intelligent knowledge base, making every file instantly searchable and analyzable through natural language.

Whether you're managing personal documents or coordinating a 10,000-person enterprise, this integration gives you AI-powered access to everything in your Drive. No more hunting through folders, no more opening dozens of files to find information - just ask and get instant answers.

Why Use Google Drive with OpenClaw?

Google Drive's ecosystem and OpenClaw's intelligence create unique value:

1. Universal File Format Support

OpenClaw can read and analyze virtually everything in your Drive:

• Google Workspace files: Docs, Sheets, Slides (native format, no export needed)
• Microsoft Office: Word (.docx), Excel (.xlsx), PowerPoint (.pptx)
• PDFs: Including scanned documents with OCR text extraction
• Images: Photos, screenshots, diagrams (visual analysis + OCR)
• Code files: Python, JavaScript, Java, any programming language
• Plain text: TXT, MD, CSV, JSON, XML, YAML
• Archives: ZIP files (extracts and analyzes contents)
• Audio: MP3, WAV (transcription)
• Video: MP4, MOV (frame analysis, caption extraction)

Upload anything to Drive, and OpenClaw can work with it.

2. Intelligent Search Across All Content

Google Drive's search is filename-based. OpenClaw searches inside your files:

Traditional Drive search:

Search: "Q4 revenue"Results: Files with "Q4" or "revenue" in the filename

OpenClaw semantic search:

Ask: "What was our Q4 revenue?"OpenClaw: Searches inside spreadsheets, presentations, and docsFinds: $2.4M revenue in "2025-financial-summary.xlsx" cell D47Responds: "Your Q4 2025 revenue was $2.4M, up 18% from Q3."

It understands meaning, not just keywords.

3. OCR and Scanned Document Processing

Have scanned PDFs or photos of documents? OpenClaw extracts text automatically:

• Scanned contracts: "What are the terms in the vendor agreement?" → Reads scanned PDF, explains terms
• Business cards: Upload photo → Extracts contact info
• Receipts: "How much did I spend on office supplies last month?" → Reads receipt photos, totals expenses
• Handwritten notes: Converts handwritten meeting notes to searchable text
• Whiteboard photos: Extracts text from whiteboard brainstorming sessions

No more manually typing information from scans.

4. Cross-File Analysis and Synthesis

OpenClaw can analyze multiple files together:

• "Compare the proposals from Vendor A and Vendor B" → Reads both PDFs, creates comparison table
• "What are the common themes in all my interview feedback forms?" → Analyzes 50 docs, identifies patterns
• "Summarize all meeting notes from last month" → Reads 20 docs, creates executive summary
• "Which expenses are over budget?" → Compares budget spreadsheet with expense reports

It connects information across your entire Drive.

5. Shared Drive and Permission Awareness

For teams using Google Workspace:

• Respects permissions: Only shows you files you can access
• Shared Drives support: Works with Team Drives and Shared Drives
• Version awareness: Can access previous versions of files
• Comment extraction: Reads Google Doc comments for context
• Suggestion tracking: Sees suggested edits in Docs

Perfect for collaborative teams with complex permission structures.

6. Automated File Organization

OpenClaw can help organize your messy Drive:

• "Move all invoices from 2024 into /Finances/2024/Invoices" → Identifies and moves files
• "Find all untitled documents and suggest names" → AI-generated descriptive names
• "Create a folder structure for this project" → Generates organized hierarchy
• "Tag all product photos with relevant labels" → AI-powered tagging
• "Archive files older than 2 years" → Smart archival with safety checks

Never manually organize files again.

7. Document Generation from Drive Data

Create new documents based on existing information:

• "Create a summary doc of all Q1 meeting notes" → New Google Doc with synthesis
• "Generate a presentation from this research document" → Converts Doc to Slides
• "Make a spreadsheet of all contacts mentioned in my emails" → Structured data extraction
• "Draft a report combining these three data sources" → Multi-file synthesis

Automate document creation workflows.

8. Real-Time Collaboration Intelligence

For active Google Workspace users:

• "Who's working on the marketing plan right now?" → Checks active collaborators
• "What changes were made to the budget today?" → Revision history summary
• "Alert me when the contract is signed" → Monitors doc for signature
• "Summarize all comments on the proposal" → Comment thread synthesis

Stay in sync with your team effortlessly.

Real-World Use Cases

1. Executive Knowledge Management (C-Suite)

Scenario: You're a CEO with 10,000+ files in Google Drive accumulated over 10 years. Board decks, contracts, strategic plans, investor updates, meeting notes. You need information fast but can't remember where you saved things.

How OpenClaw helps:

Connect your entire Google Drive:

• Quick retrieval: "What was our revenue in Q2 2023?" → Searches all financial docs, finds answer in seconds
• Contract questions: "What's the termination clause in the AWS contract?" → Reads 40-page PDF, quotes exact clause
• Historical context: "Why did we pivot our strategy in 2022?" → Finds board deck from that quarter, summarizes rationale
• People search: "Find all documents mentioning Sarah Chen" → Cross-file people search
• Briefing prep: "Summarize all materials related to the Acme acquisition" → Reads 50 files, creates brief
• Compliance: "Do we have signed NDAs from all advisors?" → Checks legal folder, lists missing NDAs

Advanced features:

• Daily briefing: "Show me all documents created or modified yesterday" → Morning summary
• Relationship mapping: "What companies have we partnered with?" → Scans contracts, creates list
• Decision archaeology: "Why did we choose Vendor X over Y?" → Finds decision memos

Impact:

• Save 5-10 hours/week searching for information
• Make better decisions with full historical context
• Never ask assistant "Where's that file?" again
• Faster board meeting prep

2. Sales Team Enablement

Scenario: Your sales team has hundreds of proposals, case studies, product sheets, and pricing docs in a shared Google Drive. Reps waste time hunting for the right materials during sales calls.

How OpenClaw helps:

Connect team's Shared Drive:

• During calls: "Find case studies for healthcare companies" → Instant relevant examples
• Pricing: "What's our pricing for 500-seat enterprise deals?" → Pulls from pricing sheet
• Competitive intel: "How do we compare to Competitor X on feature Y?" → Finds battle cards
• Proposal generation: "Create a proposal for Acme Corp using our SaaS template" → Customized draft
• Product info: "Does our Enterprise plan include SSO?" → Checks product matrix
• Customer history: "What proposals have we sent to Acme Corp?" → Historical search

Advanced features:

• Template library: "Show me all proposal templates" → Organized template list
• ROI calculations: "Generate ROI calculator for manufacturing companies" → Uses industry templates
• Contract help: "What's our standard payment terms?" → Extracts from contract templates

Impact:

• Sales calls 40% more effective (instant information access)
• Proposal creation time cut from 3 hours to 30 minutes
• More consistent messaging across team
• Higher win rates with better-researched proposals

3. Legal Team Document Analysis

Scenario: Your legal team reviews hundreds of contracts, NDAs, and agreements stored in Google Drive. Lawyers spend hours reading documents to answer simple questions.

How OpenClaw helps:

Connect legal document repository:

• Contract review: "What's the liability cap in the Vendor ABC agreement?" → Finds and quotes clause
• Term extraction: "List all contracts expiring in the next 90 days" → Searches termination dates
• Clause comparison: "Compare indemnification clauses across all vendor contracts" → Creates comparison table
• Risk identification: "Which contracts have unfavorable auto-renewal terms?" → Flags risky contracts
• Due diligence: "Find all documents related to the 2023 acquisition" → Comprehensive search
• Template generation: "Create an NDA using our standard template for a vendor relationship" → Customized draft

Advanced features:

• Obligation tracking: "What are our outstanding obligations to Microsoft?" → Extracts commitments
• Approval chain: "Has the CFO signed the AWS contract?" → Checks signature pages
• Redline analysis: "What changed between version 1 and version 3?" → Detailed comparison

Impact:

• Contract review time reduced 60%
• Risk identification improves (AI catches clauses humans miss)
• More consistent contract language
• Faster deal closure (less time searching for precedents)

4. Academic Research and Note-Taking

Scenario: You're a PhD student with 500+ research papers, notes, and drafts in Google Drive. You need to find specific studies, synthesize findings, and track your own notes.

How OpenClaw helps:

Connect research library:

• Literature review: "Find all papers about neural networks in medical imaging" → Searches PDFs by content
• Citation finding: "Who cited the Transformer paper in my collection?" → Searches references sections
• Methodology questions: "What datasets were used in these computer vision papers?" → Extracts methodology details
• Note synthesis: "Summarize all my notes on attention mechanisms" → Reads Google Docs, creates summary
• Gap identification: "What areas haven't I covered yet?" → Analyzes collection, suggests gaps
• Citation generation: "Create citations for all papers in the /PhD/Background folder" → Formatted bibliography

Advanced features:

• Concept mapping: "How do these papers relate to each other?" → Creates concept map
• Timeline extraction: "What's the history of CNNs?" → Chronological summary from papers
• Methodology replication: "How did they implement this experiment?" → Step-by-step extraction

Impact:

• Literature review time cut by 70%
• Better synthesis across papers
• Never lose track of your own notes
• Faster writing with instant citation access

5. HR and Employee Onboarding

Scenario: Your HR team manages employee handbooks, policies, benefits documents, and onboarding materials in Google Drive. Employees ask repetitive questions that are answered in docs somewhere.

How OpenClaw helps:

Connect HR shared drive:

• Policy questions: "What's our remote work policy?" → Pulls from employee handbook
• Benefits: "How much PTO do I get after 3 years?" → Checks benefits doc, calculates
• Procedures: "How do I submit an expense report?" → Step-by-step guide from procedures doc
• Forms: "Where's the PTO request form?" → Links to form in Drive
• Onboarding: "What do new engineers need to read?" → Creates onboarding checklist
• Compliance: "What's our harassment reporting process?" → Quotes policy document

Advanced features:

• Personalized answers: AI knows employee's role, tenure, location (customizes responses)
• Form assistance: "Help me fill out the 401k enrollment form" → Guided walkthrough
• Document updates: "Has the PTO policy changed recently?" → Compares versions

Impact:

• HR team spends 50% less time answering repetitive questions
• Employees get instant answers 24/7
• Better compliance (employees can easily find policies)
• Faster onboarding (new hires self-serve information)

6. Marketing Content Library

Scenario: Your marketing team has years of blog posts, social media content, ad copy, brand guidelines, and campaign docs scattered across Google Drive. Coordination is chaotic.

How OpenClaw helps:

Connect marketing drive:

• Content search: "Find all blog posts about AI from 2024" → Searches by topic and date
• Asset location: "Where's the logo file with transparent background?" → Finds exact file
• Brand guidelines: "What's our brand voice for technical content?" → Quotes style guide
• Performance data: "Which blog posts got the most traffic?" → Checks analytics docs
• Repurposing: "Turn this blog post into social media posts" → Generates variations
• Campaign history: "What did we do for Black Friday last year?" → Finds campaign brief

Advanced features:

• Content calendar: "What content is scheduled for next week?" → Checks calendar doc
• Competitor analysis: "Summarize competitor content in this folder" → Synthesis
• SEO insights: "Which keywords are we targeting?" → Extracts from content briefs

Impact:

• Content creation 40% faster (easy to find past work to repurpose)
• More consistent brand voice (instant access to guidelines)
• Better campaign coordination (historical context readily available)
• Less duplicate work (easy to find existing assets)

7. Project Management and Documentation

Scenario: You're managing a complex software project with specs, design docs, meeting notes, and architecture diagrams in Google Drive. Information is spread across dozens of files.

How OpenClaw helps:

Connect project drive folder:

• Spec questions: "What's the planned architecture for the auth system?" → Reads architecture doc
• Decision history: "Why did we choose PostgreSQL?" → Finds decision record
• Status tracking: "What's the status of the mobile app redesign?" → Scans status docs
• Blocker identification: "What's blocking the Q2 launch?" → Searches meeting notes for blockers
• Stakeholder updates: "Generate a status update for leadership" → Synthesizes project docs
• Technical details: "What API endpoints are we exposing?" → Extracts from API spec

Advanced features:

• Cross-reference checking: "Are the frontend and backend specs aligned?" → Compares docs for inconsistencies
• Change tracking: "What changed in the spec since last review?" → Version comparison
• Dependency mapping: "What depends on the authentication service?" → Analyzes architecture docs

Impact:

• Faster decision-making with instant access to context
• Fewer miscommunications (everyone can easily check specs)
• Better documentation (AI helps identify gaps)
• Smoother handoffs (new team members get up to speed faster)

8. Personal Knowledge Management

Scenario: You're a knowledge worker with years of personal notes, ideas, reading lists, and saved articles in Google Drive. You want to build a "second brain" but organization feels overwhelming.

How OpenClaw helps:

Connect personal Drive:

• Idea retrieval: "I had an idea about improving user onboarding, where is it?" → Finds note from 6 months ago
• Book summaries: "What were the key takeaways from 'Thinking Fast and Slow'?" → Reads your notes
• Connection finding: "What notes relate to habit formation?" → Semantic search across all notes
• Reading list: "What articles did I save about AI safety?" → Finds saved PDFs and links
• Learning review: "What did I learn about React this year?" → Synthesizes learning notes
• Journal insights: "What patterns do I see in my weekly reviews?" → Analyzes journal entries

Advanced features:

• Zettelkasten-style linking: "What ideas connect to this concept?" → Builds knowledge graph
• Spaced repetition: "Quiz me on what I learned about microservices" → Generates review questions
• Content creation: "Write a blog post based on my notes about remote work" → Drafts post

Impact:

• Never lose an idea or insight again
• Build connections between concepts automatically
• Actually use all those articles you saved
• Accelerate learning through better review

Features Deep Dive

File Reading and Analysis

OpenClaw can read:

• Google Docs: Full text, comments, suggestions
• Google Sheets: All cells, formulas, charts, multiple sheets
• Google Slides: Slide text, speaker notes, embedded images
• PDFs: Text extraction, OCR for scanned PDFs, table extraction
• Images: Visual analysis, OCR text extraction, object detection
• Microsoft Office: Word, Excel, PowerPoint (converted automatically)
• Code files: Syntax-aware reading of any programming language
• Plain text: TXT, CSV, JSON, XML, Markdown, YAML
• Audio files: Speech-to-text transcription
• Video files: Frame analysis, caption extraction

Semantic Search

Beyond keyword matching:

• Understands synonyms and related concepts
• Finds answers even if wording is different
• Searches based on meaning, not just words
• Cross-lingual search (ask in English, find Spanish docs)
• Handles typos and fuzzy matching
• Context-aware search (understands domain-specific terminology)

OCR and Document Processing

For scanned documents and images:

• Automatic text extraction from PDFs
• Photo document processing (receipts, business cards, whiteboard)
• Handwriting recognition (printed and cursive)
• Table extraction from images
• Multi-language OCR support
• Layout preservation (maintains document structure)

Cross-File Intelligence

Multi-document capabilities:

• Compare 2+ documents side by side
• Synthesize information across dozens of files
• Find contradictions between documents
• Track changes across file versions
• Build relationships between related files
• Create summaries from multiple sources

Permission-Aware Access

Respects Google Drive permissions:

• Only shows files you can access
• Works with individual files, folders, and Shared Drives
• Honors view-only restrictions (won't modify files you can't edit)
• Team Drive support with role-based access
• Domain-restricted file support

File Organization and Management

Active file management:

• Move files between folders
• Rename files based on content
• Create folder structures
• Tag files with labels
• Archive old files
• Duplicate detection and cleanup
• Suggest organization improvements

Version History

Google Drive version awareness:

• Access previous versions of documents
• Compare current vs previous versions
• See who made what changes when
• Restore specific versions (if you have permission)
• Track document evolution over time

Metadata Extraction

Rich metadata analysis:

• Author information
• Creation and modification dates
• File size and format
• Sharing settings
• Comment count and participants
• Revision history
• View and download statistics (if available)

Document Creation

Generate new Drive files:

• Create Google Docs from templates or scratch
• Generate spreadsheets with structured data
• Build presentations from outlines
• Convert between formats (Doc → Slides, etc.)
• Populate templates with data
• Export files to PDF, Office formats

Collaborative Intelligence

Team collaboration features:

• See who's actively editing a file
• Extract and summarize comments
• Track suggested edits
• Monitor document activity
• Alert on file changes
• Analyze collaboration patterns

Automation and Workflows

Automate common tasks:

• Daily/weekly summaries of Drive activity
• Auto-tag new files by content
• Auto-organize downloads into folders
• Alert when specific files are modified
• Scheduled backups of important files
• Duplicate file prevention

Data Extraction and Structuring

Extract structured data:

• Pull contact info from documents into spreadsheet
• Extract dates and create calendar
• Build database from unstructured docs
• Generate tables from narrative text
• Create timelines from meeting notes
• Compile statistics from multiple sources

Security and Privacy

• Encryption in transit (TLS 1.3)
• Encrypted credential storage
• OAuth 2.0 authentication (no password sharing)
• Scope-limited permissions (only what you authorize)
• Audit logging (track all AI access)
• No data retention without consent
• GDPR and SOC 2 compliant (HeraClaw Cloud)

Setup Option 1: HeraClaw Cloud (Recommended)

Time required: 60 seconds Technical skill: None Cost: Included in HeraClaw Cloud subscription Best for: 95% of users, all use cases

Why HeraClaw Cloud?

• No Google Cloud Console complexity
• No OAuth credential JSON files
• No API quota management
• No token refresh logic
• Professional support included
• Automatic API updates
• 99.9% uptime SLA
• Enterprise-grade security

Steps:

1. Sign up for HeraClaw Cloud

• Visit cloud.getopenclaw.ai
• Click "Sign In" (no credit card required)
• Create your account (takes 60 seconds)

2. Navigate to Integrations

• Click "Integrations" in sidebar
• Find "Google Drive" in the list
• Click "Connect to Google Drive"

3. Authorize Access

• Google OAuth screen appears
• Select your Google account
• Review permissions (read and write access to Drive)
• Click "Allow"

4. Select Scope (Optional)

• Choose which folders OpenClaw can access
• Options:
  • Entire Drive (recommended for personal use)
  • Specific folders only (for sensitive data)
  • Shared Drives (select which ones)
• Save configuration

5. Test the Integration

• In HeraClaw, ask: "What files are in my Google Drive?"
• You should see a list of recent files
• Try: "Summarize the document called [filename]"
• You should get a summary

That's it! Your Google Drive is now searchable and analyzable.

What You Get with HeraClaw Cloud:

✅ Instant Setup - No Google Cloud Console required ✅ Automatic Updates - We handle Google API changes ✅ Professional Support - Email, chat, phone support ✅ 99.9% Uptime - SLA-backed reliability ✅ Enterprise Security - SOC 2, GDPR, HIPAA available ✅ Unlimited Files - No file count or size limits ✅ Advanced Features - OCR, cross-file analysis, automation ✅ No Maintenance - We manage tokens, quotas, everything

Pricing: See cloud.getopenclaw.ai/pricing

Get Started: Start with HeraClaw Cloud →

Setup Option 2: Self-Hosted (Advanced)

Time required: 30-45 minutes (first time) Technical skill: Intermediate to Advanced Cost: Free (Google API is free up to quotas) + your time Best for: Technical users, data sovereignty requirements

Who should self-host?

✅ Developers comfortable with OAuth 2.0 ✅ Organizations with data residency requirements ✅ Teams with existing infrastructure ✅ Users wanting full control over credentials ✅ Companies that cannot use SaaS

Who should NOT self-host?

❌ Non-technical users ❌ Anyone who values time over cost ❌ Users uncomfortable with Google Cloud Console ❌ Teams without DevOps knowledge

Prerequisites:

• OpenClaw installed and running
• Google account
• Basic understanding of OAuth 2.0
• Comfortable with JSON and terminal

Detailed Self-Hosted Setup

Step 1: Create a Google Cloud Project

1. Go to console.cloud.google.com
2. Click "Select a project" → "New Project"
3. Project name: "OpenClaw Integration" (or your preference)
4. Organization: Select your org (or leave as "No organization" for personal)
5. Click "Create"
6. Wait 30 seconds for project creation
7. Select your new project from the dropdown

Step 2: Enable Google Drive API

1. In Google Cloud Console, go to "APIs & Services" → "Library"
2. Search for "Google Drive API"
3. Click on "Google Drive API"
4. Click "Enable"
5. Wait for API to be enabled (~30 seconds)

Step 3: Configure OAuth Consent Screen

Critical: This determines what users see when authorizing.

1. Go to "APIs & Services" → "OAuth consent screen"
2. Choose user type:
   • Internal: Only for Google Workspace users in your org
   • External: For anyone with a Google account (most users)
3. Click "Create"

Fill out consent screen:

• App name: "OpenClaw"
• User support email: Your email
• App logo: (optional) Upload a logo
• App domain: Your domain (optional, can skip)
• Developer contact: Your email
• Click "Save and Continue"

Scopes: 4. Click "Add or Remove Scopes" 5. Search for and add:

• https://www.googleapis.com/auth/drive.readonly (read files)
• https://www.googleapis.com/auth/drive.file (read/write files created by app)
• OR https://www.googleapis.com/auth/drive (full access - use with caution)

1. Recommended: Start with drive.readonly for safety
2. Click "Update" → "Save and Continue"

Test users (if External + not published): 8. Add your email as a test user 9. Click "Save and Continue" 10. Review summary → "Back to Dashboard"

Note: Apps in "Testing" mode only allow test users. To allow anyone, you'll need to publish (requires verification for sensitive scopes).

Step 4: Create OAuth Credentials

1. Go to "APIs & Services" → "Credentials"
2. Click "Create Credentials" → "OAuth client ID"
3. Application type: "Desktop app" (for self-hosted OpenClaw)
   • Alternative: "Web application" if OpenClaw has a public URL
4. Name: "OpenClaw Desktop Client"
5. Click "Create"
6. Download JSON: Click "Download JSON" (downloads a file like client_secret_XXX.json)
7. Keep this file safe - it contains your OAuth credentials
8. Click "OK"

Step 5: Configure OpenClaw

Place the downloaded JSON file where OpenClaw can access it:

# Create config directory if neededmkdir -p ~/.openclaw/credentials/# Move downloaded filemv ~/Downloads/client_secret_*.json ~/.openclaw/credentials/google_drive.json# Secure the file (only you can read)chmod 600 ~/.openclaw/credentials/google_drive.json

Edit your OpenClaw config (~/.openclaw/config.yaml):

integrations:  google_drive:    enabled: true        # Path to credentials JSON    credentialsFile: "~/.openclaw/credentials/google_drive.json"        # Where to store OAuth token (created after first auth)    tokenFile: "~/.openclaw/credentials/google_drive_token.json"        # Optional: Limit to specific folders (folder IDs)    allowedFolders:      - "root"  # Everything      # - "1a2b3c4d5e6f7g8h9i0j"  # Specific folder ID        # Optional: Exclude folders    excludedFolders:      - "1q2w3e4r5t6y7u8i9o0p"  # Trash, sensitive folders        # Enable OCR for scanned PDFs?    enableOCR: true        # Cache file metadata?    cachingEnabled: true    cacheSize: 1000  # files        # Search settings    maxSearchResults: 50    searchTimeout: 30  # seconds

Step 6: Authorize OpenClaw

Run the initial authorization:

# Start OpenClaw authorization flowopenclaw integrations authorize google_drive

What happens:

1. OpenClaw opens a browser window (or prints a URL)
2. You'll see Google's OAuth consent screen
3. Select your Google account
4. Review permissions (click "Advanced" if you see a warning about unverified app)
5. Click "Allow"
6. Browser shows "Authorization successful, you can close this window"
7. OpenClaw saves the token to google_drive_token.json

If you see "This app isn't verified":

• This is expected for self-hosted apps not published by Google
• Click "Advanced" → "Go to OpenClaw (unsafe)" (it's safe, it's your own app)
• Proceed with authorization

Step 7: Test the Integration

# Test connectionopenclaw integrations test google_drive# Expected output:# ✓ Connected to Google Drive# ✓ Account: your-email@gmail.com# ✓ Storage: 15 GB used of 100 GB# ✓ Files accessible: 1,247

Try some queries:

# List recent filesopenclaw ask "What are my recent files in Google Drive?"# Search for a fileopenclaw ask "Find the Q4 report in my Drive"# Summarize a documentopenclaw ask "Summarize the file called 'Meeting Notes 2026-03-15'"

Step 8: Monitor Usage and Quotas

Google Drive API has free quotas:

• 1,000 queries per 100 seconds (plenty for most users)
• 10,000 queries per day (self-hosted default)

Monitor usage:

1. Go to console.cloud.google.com
2. APIs & Services → Dashboard
3. Click "Google Drive API"
4. View quota usage and traffic

If you hit limits, consider:

• Increase quotas (request from Google, usually free)
• Implement caching (OpenClaw does this automatically)
• Reduce search frequency

Advanced Self-Hosted Configuration

Service Account (for Google Workspace)

For organizations, use a service account instead of OAuth:

1. In Google Cloud Console: IAM & Admin → Service Accounts
2. Create Service Account: "openclaw-drive-access"
3. Download JSON key file
4. In Google Workspace Admin: Security → API Controls → Domain-wide Delegation
5. Add service account with Drive scopes

Config:

integrations:  google_drive:    authType: "service_account"    serviceAccountFile: "~/.openclaw/credentials/service_account.json"    impersonateUser: "user@yourdomain.com"  # Which user to access as

Benefit: No interactive auth, works for automation

Shared Drive Access

Access Team Drives:

integrations:  google_drive:    sharedDrives:      enabled: true            # Specific Shared Drives (by ID)      allowedDrives:        - "0ABcdEfGhIjKlMnOp"  # Engineering Shared Drive        - "0QRstUvWxYzAbCdEf"  # Marketing Shared Drive            # Include in global searches?      includeInSearch: true

Find Shared Drive IDs:

1. Open Drive, go to Shared Drive
2. URL contains the ID: drive.google.com/drive/folders/[ID HERE]

OCR Configuration

Customize OCR behavior:

integrations:  google_drive:    ocr:      enabled: true            # Languages to detect      languages:        - "en"  # English        - "es"  # Spanish        - "fr"  # French            # Auto-OCR all PDFs?      autoProcessPDFs: true            # Cache OCR results?      cacheResults: true      cacheDuration: 30  # days

File Type Filtering

Control which files to index:

integrations:  google_drive:    fileTypes:      # Include only these types      include:        - "application/pdf"        - "application/vnd.google-apps.document"  # Google Docs        - "application/vnd.google-apps.spreadsheet"  # Sheets        - "text/plain"            # Or exclude specific types      exclude:        - "application/zip"        - "video/*"        - "audio/*"            # Max file size to process (MB)      maxSize: 100

Caching Strategy

Optimize for performance:

integrations:  google_drive:    cache:      enabled: true            # What to cache      cacheMetadata: true    # File names, dates, etc.      cacheContent: false    # Actual file contents (uses lots of space)      cacheThumbnails: true  # Image thumbnails            # Cache duration      metadataTTL: 3600      # 1 hour (seconds)      contentTTL: 86400      # 24 hours            # Max cache size      maxCacheSize: 5000     # MB            # Refresh strategy      refreshInterval: 300   # Check for updates every 5 min

Search Configuration

Customize search behavior:

integrations:  google_drive:    search:      # Max results to return      maxResults: 100            # Search timeout      timeout: 30  # seconds            # Search in file content (slower) or just metadata?      deepSearch: true            # Fuzzy matching threshold (0-1)      fuzzyThreshold: 0.8            # Prioritize recent files?      recencyBias: true      recencyWeight: 0.3  # 30% weight to recency

Automation Rules

Automate Drive organization:

integrations:  google_drive:    automation:      # Auto-organize new files      - trigger: "file_created"        conditions:          - mimeType: "application/pdf"          - name: "*invoice*"        action: "move"        destination: "1a2b3c4d5e6f7g8h9i0j"  # Invoices folder ID            # Auto-tag files      - trigger: "file_created"        action: "tag"        tag: "auto-processed-{{date}}"            # Alert on specific files      - trigger: "file_modified"        conditions:          - name: "Important Document"        action: "alert"        channel: "slack"  # Send Slack notification

Webhook Integration

Receive real-time Drive updates:

integrations:  google_drive:    webhooks:      enabled: true            # Your endpoint to receive notifications      endpoint: "https://your-server.com/webhooks/google-drive"            # Events to watch      events:        - "file.created"        - "file.modified"        - "file.trashed"            # Specific files or folders to watch      watchList:        - "1a2b3c4d5e6f7g8h9i0j"  # Important folder

Troubleshooting Self-Hosted Setup

"Invalid Credentials" Error

Symptoms: OpenClaw can't connect to Google Drive

Potential causes:

1. Wrong credentials file path
2. Credentials file corrupted
3. OAuth client deleted from Google Cloud Console

Fix:

# Verify file exists and is readablels -la ~/.openclaw/credentials/google_drive.json# Check file is valid JSONcat ~/.openclaw/credentials/google_drive.json | python -m json.tool# Re-download credentials from Google Cloud Console if needed# APIs & Services → Credentials → Download JSON

"Token Expired" Error

Symptoms: Integration worked before, now fails

Potential causes:

1. OAuth token expired (normal after 7 days of inactivity)
2. Token file deleted
3. Scopes changed

Fix:

# Remove old tokenrm ~/.openclaw/credentials/google_drive_token.json# Re-authorizeopenclaw integrations authorize google_drive

"Insufficient Permissions" Error

Symptoms: Can read files but can't write/modify

Potential causes:

1. OAuth scopes too restrictive
2. File-level permissions (file shared as view-only)

Fix:

1. Check OAuth scopes in Google Cloud Console
2. Ensure you added drive.file or drive scope, not just drive.readonly
3. Re-create OAuth client with correct scopes
4. Re-authorize OpenClaw

"Quota Exceeded" Error

Symptoms: Requests fail with 403 or 429 error

Potential causes:

1. Hit Google's daily quota (10,000 queries/day default)
2. Too many queries in short time (1,000 per 100 seconds)

Fix:

# Check quota usage# Go to: console.cloud.google.com → APIs & Services → Dashboard → Drive API# Implement rate limiting in config# In config.yaml:integrations:  google_drive:    rateLimit:      queriesPerSecond: 5      burstAllowance: 20

Request quota increase:

1. Google Cloud Console → APIs & Services → Drive API → Quotas
2. Click "Edit Quotas"
3. Request increase (usually approved immediately for reasonable amounts)

Files Not Found

Symptoms: OpenClaw says file doesn't exist, but you see it in Drive

Potential causes:

1. File in excluded folder
2. File permissions (not shared with the account)
3. File in Shared Drive not configured
4. Cache out of sync

Fix:

# Clear cacheopenclaw integrations clear-cache google_drive# Verify file access# In Drive, check sharing settings on the file# Check config for excluded folders# In config.yaml, review excludedFolders list

Slow Search Performance

Symptoms: Searches take 20+ seconds

Potential causes:

1. Large Drive (10,000+ files)
2. Deep search enabled (searches file contents)
3. No caching
4. Network latency

Fix:

# Enable aggressive cachingintegrations:  google_drive:    cache:      enabled: true      cacheMetadata: true      metadataTTL: 7200  # 2 hours        # Limit search scope    search:      maxResults: 25  # Return fewer results      deepSearch: false  # Metadata only

OCR Not Working

Symptoms: Scanned PDFs can't be read

Potential causes:

1. OCR disabled in config
2. Missing dependencies (Tesseract)
3. Unsupported image format

Fix:

# Install Tesseract OCRsudo apt-get install tesseract-ocr  # Linuxbrew install tesseract              # macOS# Install language datasudo apt-get install tesseract-ocr-eng  # English# Verify installationtesseract --version# Enable in config# In config.yaml:integrations:  google_drive:    ocr:      enabled: true

"This App Isn't Verified" Warning

Symptoms: During OAuth, Google warns app isn't verified

This is expected for self-hosted apps

To bypass:

1. Click "Advanced" on the warning screen
2. Click "Go to OpenClaw (unsafe)" (it's safe, it's your own app)
3. Proceed with authorization

To remove warning (optional, complex):

1. Publish your OAuth app (Google Cloud Console → OAuth consent screen → Publish)
2. Request verification (required for sensitive scopes, takes days)
3. Provide privacy policy, terms of service, etc.

Most users don't need to verify self-hosted apps.

Security Best Practices for Self-Hosted

1. Protect Credential Files

# Secure file permissionschmod 600 ~/.openclaw/credentials/google_drive.jsonchmod 600 ~/.openclaw/credentials/google_drive_token.json# Never commit to gitecho "credentials/" >> ~/.openclaw/.gitignore

2. Minimal Scopes

Only request OAuth scopes you need:

• drive.readonly - Read-only access (safest)
• drive.file - Access files created by app
• drive - Full access (use only if necessary)

3. Regular Token Rotation

Rotate tokens periodically:

# Every 90 days, re-authorizerm ~/.openclaw/credentials/google_drive_token.jsonopenclaw integrations authorize google_drive

4. Folder Restrictions

Limit access to specific folders:

integrations:  google_drive:    allowedFolders:      - "1a2b3c4d5e6f7g8h9i0j"  # Only Work folder        excludedFolders:      - "1z2y3x4w5v6u7t8s9r0q"  # Personal folder

5. Audit Logging

Track all Drive access:

logging:  audit:    enabled: true    logFile: "/var/log/openclaw/google-drive-audit.log"    includeQueries: true    includeResults: false  # Don't log file contents    retention: 90  # days

6. No Content Logging

Never log actual file contents:

logging:  privacy:    logFileContents: false    logFileNames: true  # OK to log names    redactPatterns:  # Redact sensitive patterns      - "password"      - "api[_-]?key"

7. Use Service Accounts for Automation

For automated systems, use service accounts instead of user OAuth:

• No interactive login required
• Easier to manage programmatically
• Can be restricted more tightly

8. Monitor API Usage

Regularly check for unusual activity:

# Check OpenClaw logs for Drive accessopenclaw logs | grep "google_drive"# Review Google Cloud Console audit logs# IAM & Admin → Audit Logs

Comparison: HeraClaw Cloud vs Self-Hosted

Why 95% of users choose HeraClaw Cloud:

✅ Time is valuable - Setup + maintenance adds up ✅ OAuth is confusing - Consent screens, scopes, verification ✅ Token management is tedious - Refresh tokens expire, need handling ✅ Google changes APIs - We handle breaking changes ✅ OCR is complex - Dependencies, language packs, configuration ✅ Support matters - When things break, we fix it

When self-hosting makes sense:

✅ You're comfortable with Google Cloud Console ✅ Data cannot leave your infrastructure ✅ You have time to manage OAuth tokens ✅ You want to customize heavily ✅ You're already running OpenClaw infrastructure

Frequently Asked Questions

Q: Do I need a paid Google Workspace account?

A: No. Works with free Gmail accounts and paid Workspace. Free accounts have 15GB storage, paid have more.

Q: Can I use this with multiple Google accounts?

A: Yes! HeraClaw Cloud supports multiple accounts. Self-hosted requires separate OAuth tokens per account.

Q: What permissions does OpenClaw need?

A: Minimum: Read access to Drive files. Optional: Write access (to create/modify files). You control this during OAuth authorization.

Q: Will OpenClaw modify my files?

A: Only if you ask it to ("rename this file", "move this to folder X"). Read-only operations (search, summarize) never modify files.

Q: Can it access files shared with me?

A: Yes, if you have permission to view them. Works with files you own and files shared with you.

Q: What about Shared Drives (Team Drives)?

A: Yes, full support. You can search across your personal Drive and all Shared Drives you have access to.

Q: Can it read files in my trash?

A: By default, no. Can be enabled if needed (e.g., "Did I accidentally delete the Q3 report?").

Q: How does OCR work?

A: OpenClaw automatically extracts text from scanned PDFs and images. Works with photos of documents, business cards, receipts, etc.

Q: Is my data secure?

A: HeraClaw Cloud: SOC 2 certified, encrypted in transit and at rest, GDPR compliant. We don't store file contents unless configured. Self-hosted: Your responsibility, you control all data.

Q: Can OpenClaw see deleted file versions?

A: Yes, can access Drive's version history if you have permission.

Q: What file size limits exist?

A: HeraClaw Cloud: No limits. Self-hosted: Limited by your server memory and Google API limits (reasonable for most files).

Q: How fast is search?

A: Typically 2-5 seconds for metadata search, 5-15 seconds for deep content search (depends on Drive size and query complexity).

Q: Can it create new files?

A: Yes! Can create Google Docs, Sheets, Slides, or upload new files if you grant write permissions.

Q: What about Google Photos?

A: Google Photos is separate from Drive. OpenClaw can access photos stored in Drive, but not Photos library (different API).

Q: Can it read files in native Google format?

A: Yes. Reads Google Docs, Sheets, and Slides in their native format (no export needed).

Q: What happens if I hit API quotas?

A: HeraClaw Cloud: We have high quotas and handle limits automatically. Self-hosted: Requests fail until quota resets (daily). Can request increases from Google.

Q: Can I search by date range?

A: Yes. "Find all files modified last week" or "Show documents created in Q4 2025".

Q: Does it work offline?

A: No, requires internet connection to access Google Drive API.

Q: Can it organize my messy Drive?

A: Yes! Can suggest folder structures, rename files, move files to appropriate folders, and identify duplicates.

Q: What about file comments and suggestions?

A: Yes, can read comments and suggested edits in Google Docs. "What did reviewers say about the proposal?"

Q: Can I limit access to specific folders?

A: Yes. Configure which folders OpenClaw can access, exclude sensitive folders.

Q: How do I revoke access?

A: Go to myaccount.google.com/permissions, find OpenClaw, click "Remove Access".

Q: Can multiple people in my org use this?

A: Yes. Each person authorizes with their own Google account. HeraClaw Cloud has team plans.

Q: What if Google changes their API?

A: HeraClaw Cloud: We handle API changes automatically. Self-hosted: May require OpenClaw updates.

Q: Can it extract data from spreadsheets?

A: Yes. "What's the total revenue in Q4?" → Reads Sheets, calculates from cells.

Q: Does it work with Google Forms responses?

A: Yes, if responses are saved to a Google Sheet in your Drive.

Get Started

For 95% of users (recommended):

Start with HeraClaw Cloud →

• 60-second setup
• No Google Cloud Console needed
• Professional support
• 99.9% uptime SLA
• No credit card required

For advanced users only:

Self-Hosting Setup Guide →

• 30-45 minute setup
• Requires Google Cloud Console
• You manage OAuth tokens
• Full control and customization

Questions? Email support@cloud.getopenclaw.ai or visit our help center.

Last updated: April 9, 2026

Built with OpenClaw — The open-source AI assistant platform. Self-host or use HeraClaw Cloud.