claw-admin

# 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:

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

Response when available:
```json
{"prefix":"tom","email":"tom@clawemail.com","available":true}
```

Response when taken or reserved:
```json
{"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.

```bash
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:
```json
{
  "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:
1. Log in to Gmail at https://mail.google.com with the new email and password
2. Visit the `connect_url` to authorize OAuth and receive their credentials JSON

## List All Emails

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

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

## Get Email Details

```bash
curl -s https://clawemail.com/api/emails/PREFIX \
  -H "X-API-K...