Email & Gmail Integration — Setup Guide

## Understanding Gmail Integration Options

There's no simple 'Connect Google Account' button in OpenClaw. Users who claim to have Google integration are using one of these approaches:

1. Gmail Pub/Sub Setup — Complex but official, requires Google Cloud 2. Custom Skills with gogcli — Scripts that call Google APIs via CLI 3. Browser Automation — Using unbrowse to control Gmail in a browser 4. IMAP/SMTP — Traditional email protocols (simpler but less features)

---

## Option 1: Gmail Pub/Sub Integration (Advanced)

This is the 'official' way documented in docs/automation/gmail-pubsub.md.

### Prerequisites

- Google Cloud project with billing enabled - Pub/Sub API enabled in your project - gogcli tool installed - Tailscale (or other method) for public webhook endpoint

### Step 1: Install gogcli

# Install the Google CLI toolnpm install -g gogcli# orbrew install gogcli

### Step 2: Authorize with Gmail

# This opens a browser for OAuth consentgogcli auth login --scopes gmail.readonly,gmail.send,gmail.compose

Important: Make sure you authorize with the correct scopes. Missing scopes = missing functionality.

### Step 3: Set up the webhook endpoint

# If using Tailscale Funnel for public endpointtailscale funnel 8080# Configure OpenClaw to receive Gmail webhooksopenclaw hooks gmail setup

### Step 4: Test the integration

# Verify gogcli can access Gmailgogcli gmail list --limit 5# Check webhook statusopenclaw hooks gmail status

---

## Option 2: Custom Skills for Google Calendar

Users have created skills that generate scripts for Google Calendar events.

### If Your Script Stopped Working

Error: "doesn't have the capability to run local scripts"

Cause: Sandbox mode is blocking system.run

### Fix 1: Check Sandbox Status

# Check if sandbox is enabledopenclaw config get sandbox.enabled# View sandbox settingsopenclaw config list | grep sandbox

### Fix 2: Allowlist Your Script

If you trust the script, add it to the sandbox allowlist:

# Add script to allowed executablesopenclaw config set sandbox.allowlist.scripts "/path/to/your/calendar-script.sh"

### Fix 3: Run Script Manually First

# Make script executablechmod +x ~/clawd/skills/google-calendar/create-event.sh# Test it directly~/clawd/skills/google-calendar/create-event.sh "Meeting" "2024-01-15 10:00" "2024-01-15 11:00"

---

## Troubleshooting: Drafts Not Appearing in Gmail

### Step 1: Verify gogcli authorization

# Check current auth statusgogcli auth status# If expired, re-authorize with correct scopesgogcli auth login --scopes gmail.readonly,gmail.send,gmail.compose,gmail.modify

### Step 2: Check the correct account

# See which account gogcli is usinggogcli auth whoami# If wrong account, logout and re-authgogcli auth logoutgogcli auth login

### Step 3: Test draft creation directly

# Try creating a draft via CLIgogcli gmail draft create --to "test@example.com" --subject "Test" --body "Testing draft creation"# List recent draftsgogcli gmail drafts list --limit 5

### Step 4: Check logs for errors

# View OpenClaw logs for Gmail-related errorsopenclaw logs --tail 100 | grep -i "gmail\|draft\|gog"

---

## Option 3: Browser Automation for Gmail

If the API setup is too complex, use browser automation:

# Capture Gmail's internal APIopenclaw unbrowse capture --url "https://mail.google.com"# Or use the browser agentopenclaw unbrowse browse --url "https://mail.google.com" --task "compose email to test@example.com"

---

## Sending Custom Data to OpenClaw Programmatically

To send messages, emails, or custom data streams to OpenClaw:

### Method 1: Webhooks

# Send data via webhookcurl -X POST http://localhost:8080/webhook/custom \  -H "Content-Type: application/json" \  -d '{"type": "email", "from": "user@example.com", "body": "Hello"}'

### Method 2: Custom Channel Plugin

Create a custom channel in ~/.openclaw/channels/ that receives your data stream.

### Method 3: File-Based Ingestion

Write data to a watched directory that OpenClaw monitors: ``bash echo '{"message": "Process this"}' > ~/.openclaw/inbox/email-001.json