@tensorfold/openclaw-google-workspace

All-in-one Google Workspace plugin for OpenClaw. One plugin, one OAuth flow, six Google services.

Gmail | Calendar | Drive | Contacts | Tasks | Sheets

Why This Plugin

Setting up Google integrations in OpenClaw typically requires installing 3+ separate plugins, each with its own OAuth flow, token management, and configuration. This creates friction during client deployments:

• Multiple openclaw plugins install commands
• Separate OAuth authorization for each service
• Different config schemas that conflict
• No shared token management

This plugin solves that. One install, one OAuth flow, one config block. Services are toggled on/off with a boolean.

Quick Start

1. Install

openclaw plugins install @tensorfold/openclaw-google-workspace

2. Set up Google Cloud (one-time)

Create a Google Cloud project with the APIs you need enabled, then download OAuth Desktop Client credentials. See docs/google-cloud-setup.md for the full walkthrough.

3. Place credentials

mkdir -p ~/.openclaw/secrets
cp client_secret_*.json ~/.openclaw/secrets/google-oauth.json
chmod 600 ~/.openclaw/secrets/google-oauth.json

4. Configure openclaw.json

{
  "plugins": {
    "allow": ["openclaw-google-workspace"],
    "entries": {
      "openclaw-google-workspace": {
        "enabled": true,
        "config": {
          "credentialsPath": "./secrets/google-oauth.json",
          "tokenPath": "./secrets/google-tokens.json",
          "services": {
            "gmail": { "enabled": true },
            "calendar": { "enabled": true },
            "drive": { "enabled": true, "readOnly": true }
          }
        }
      }
    }
  },
  "tools": {
    "allow": ["openclaw-google-workspace"]
  }
}

5. Restart, authorize, use

openclaw gateway restart

Then via your chat channel:

"Run google_workspace_begin_auth" (click URL, sign in, grant consent, copy code) "Run google_workspace_complete_auth with code 4/0AXY..." "What's in my inbox?"

Configuration Reference

Top-level Config

Service Configuration

Environment Variable Overrides

All config properties can be overridden via environment variables:

Available Tools

Authentication (3 tools — always available)

Gmail (5 tools)

Calendar (5 tools)

Drive (4 tools)

Contacts (2 tools)

Tasks (3 tools)

Sheets (2 tools)

Authentication

All services share a single Google OAuth2 flow. Scopes are computed dynamically based on which services are enabled:

Token management:

• Tokens stored securely with chmod 600 permissions
• Auto-refresh when access token expires
• Incremental scope addition when enabling new services (include_granted_scopes: true)

Adding services later: Enable the service in config, restart gateway, run begin_auth again. The OAuth URL requests the new scopes while preserving existing grants.

Coexistence with Other Plugins

This plugin uses tool-based Gmail integration (search, read, send on demand). It does not replace the @mcinteerj/openclaw-gmail channel plugin which provides inbound email polling and auto-replies. Both can be installed simultaneously — they use different tool names and serve different purposes.

Similarly, this plugin's calendar tools use the google_calendar_* prefix and will not conflict with the standalone openclaw-google-calendar plugin if both are installed.

Migration from Existing Plugins

If you're currently using separate Gmail and Calendar plugins:

1. Install this plugin alongside existing ones
2. Verify it works with your Google account
3. Disable the old plugins in openclaw.json ("enabled": false)
4. Remove old plugins from plugins.allow and tools.allow
5. Restart gateway

Documentation

• Setup Guide — Step-by-step deployment for TensorFold setups
• Google Cloud Setup — GCP project and OAuth configuration
• Service Reference — All 24 tools with parameters and examples
• Troubleshooting — Common issues and solutions
• Config Example — Full annotated config
• Minimal Setup — Gmail-only quickstart
• Full Setup — All services enabled

Development

# Clone and install
git clone https://github.com/tensorfold/openclaw-google-workspace.git
cd openclaw-google-workspace
npm install

# Type check
npm run typecheck

# Local install for testing
openclaw plugins install .

License

MIT - TensorFold