Source Code

ClawEmail

Provision and manage @clawemail.com Google Workspace email accounts for AI agents. Each account comes with full Gmail, Docs, Sheets, Calendar, and Drive access plus OAuth credentials for programmatic use.

Setup

Set your API key as an environment variable:

export CLAWEMAIL_API_KEY=your_api_key_here

Base URL: https://clawemail.com

All admin endpoints require the header: -H "X-API-Key: $CLAWEMAIL_API_KEY"

Check Email Availability (Public — no API key needed)

Before creating an account, always check if the prefix is available:

curl -s https://clawemail.com/check/DESIRED_PREFIX

Response when available:

{"prefix":"tom","email":"tom@clawemail.com","available":true}

Response when taken or reserved:

{"available":false,"errors":["This email is reserved"]}

Create Email Account

Provisions a new @clawemail.com Google Workspace user. Returns a temporary password and an OAuth connect URL.

curl -s -X POST https://clawemail.com/api/emails \
  -H "X-API-Key: $CLAWEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prefix":"DESIRED_PREFIX"}'

Response:

{
  "success": true,
  "email": "tom@clawemail.com",
  "password": "aB3$xYz...",
  "connect_url": "https://clawemail.com/connect/tom",
  "instructions": "1. User logs into Gmail with the email/password above. 2. User visits connect_url to authorize OAuth. 3. User receives their OpenClaw credentials."
}

Important: Save the password immediately — it is shown only once.

After creation, the user must:

Log in to Gmail at https://mail.google.com with the new email and password
Visit the connect_url to authorize OAuth and receive their credentials JSON

List All Emails

curl -s https://clawemail.com/api/emails \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Supports pagination with ?limit=100&offset=0.

Get Email Details

curl -s https://clawemail.com/api/emails/PREFIX \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Returns email status, creation date, OAuth connection date, and Workspace user details.

Suspend Email

Temporarily disables a Google Workspace account (preserves data):

curl -s -X POST https://clawemail.com/api/emails/PREFIX/suspend \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Unsuspend Email

Re-enables a previously suspended account:

curl -s -X POST https://clawemail.com/api/emails/PREFIX/unsuspend \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Delete Email

Permanently deletes the Google Workspace account and all associated data:

curl -s -X DELETE https://clawemail.com/api/emails/PREFIX \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Self-Service Signup (No API Key)

For users who want to sign up themselves through Stripe checkout:

Direct them to: https://clawemail.com/signup?prefix=DESIRED_PREFIX
They choose monthly ($16/mo) or annual ($160/yr), enter billing email, and pay via Stripe
After payment they receive their password and OAuth connect link

Typical Workflow

Check availability: curl -s https://clawemail.com/check/myagent
Create account: POST to /api/emails with the prefix
Save credentials: Store the password securely
Connect OAuth: Direct user to the connect_url from the response
Use the account: The agent now has a real Gmail address with full Google Workspace access

Prefix Rules

Must be 3-30 characters
Must start with a letter
Can contain letters, numbers, dots, underscores, or hyphens
Many common names, brands, and words are reserved

When to Use

User asks to create an email account for their AI agent
User needs a Google Workspace account with OAuth access
User wants to check if a specific email address is available
User needs to manage (suspend/unsuspend/delete) an existing account

claw-admin