Gmail Integration
Gmail integration skill for OpenClaw. Send emails, manage labels, and automate Gmail workflows.
Capabilities
- Send emails via Gmail API
- List recent emails from inbox
- Create and manage custom labels
- Full OAuth2 support for secure authentication
Setup
- Go to Google Cloud Console (https://console.cloud.google.com/)
- Create a new project or select existing
- Enable Gmail API from API Library
- Create OAuth 2.0 credentials:
- Go to "Credentials" → "Create Credentials" → "OAuth client ID"
- Application type: "Desktop app"
- Download the JSON and get client_id and client_secret
- Configure environment variables
Environment Variables
| Variable | Required | Description |
|---|
| ---------- | ---------- | ------------- |
GMAIL_CLIENT_ID | Yes | OAuth Client ID from Google Cloud |
GMAIL_CLIENT_SECRET | Yes | OAuth Client Secret |
Usage Examples
Send an email to boss@example.com with subject "Project Update" and body "The project is complete"
List my recent emails from Gmail
Create a new label named "Projects/OpenClaw"
Message Types
- Plain text emails
- HTML emails (coming soon)
- Emails with attachments (coming soon)
Rate Limits
Google Gmail API has rate limits:
- 100:00 requests per day
- 100 requests per second
Troubleshooting
- "Invalid credentials": Re-check your OAuth credentials
- "Rate limit exceeded": Wait before making more requests
- "Account not verified": Your app needs to go through Google's verification for sensitive scopes