{"skill":{"slug":"clawemail-admin","displayName":"ClawEmail Admin","summary":"Provision and manage @clawemail.com Google Workspace email accounts. Use when the user wants to create an email for their AI agent, check email availability, or manage existing ClawEmail accounts.","description":"---\nname: claw-admin\ndescription: \"Provision and manage @clawemail.com Google Workspace email accounts. Use when the user wants to create an email for their AI agent, check email availability, or manage existing ClawEmail accounts.\"\nuser-invocable: true\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"CLAWEMAIL_API_KEY\"]},\"primaryEnv\":\"CLAWEMAIL_API_KEY\",\"emoji\":\"🦞\"}}\n---\n\n# ClawEmail\n\nProvision 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.\n\n## Setup\n\nSet your API key as an environment variable:\n\n```\nexport CLAWEMAIL_API_KEY=your_api_key_here\n```\n\n**Base URL:** `https://clawemail.com`\n\nAll admin endpoints require the header: `-H \"X-API-Key: $CLAWEMAIL_API_KEY\"`\n\n## Check Email Availability (Public — no API key needed)\n\nBefore creating an account, always check if the prefix is available:\n\n```bash\ncurl -s https://clawemail.com/check/DESIRED_PREFIX\n```\n\nResponse when available:\n```json\n{\"prefix\":\"tom\",\"email\":\"tom@clawemail.com\",\"available\":true}\n```\n\nResponse when taken or reserved:\n```json\n{\"available\":false,\"errors\":[\"This email is reserved\"]}\n```\n\n## Create Email Account\n\nProvisions a new @clawemail.com Google Workspace user. Returns a temporary password and an OAuth connect URL.\n\n```bash\ncurl -s -X POST https://clawemail.com/api/emails \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prefix\":\"DESIRED_PREFIX\"}'\n```\n\nResponse:\n```json\n{\n  \"success\": true,\n  \"email\": \"tom@clawemail.com\",\n  \"password\": \"aB3$xYz...\",\n  \"connect_url\": \"https://clawemail.com/connect/tom\",\n  \"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.\"\n}\n```\n\n**Important:** Save the password immediately — it is shown only once.\n\nAfter creation, the user must:\n1. Log in to Gmail at https://mail.google.com with the new email and password\n2. Visit the `connect_url` to authorize OAuth and receive their credentials JSON\n\n## List All Emails\n\n```bash\ncurl -s https://clawemail.com/api/emails \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\"\n```\n\nSupports pagination with `?limit=100&offset=0`.\n\n## Get Email Details\n\n```bash\ncurl -s https://clawemail.com/api/emails/PREFIX \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\"\n```\n\nReturns email status, creation date, OAuth connection date, and Workspace user details.\n\n## Suspend Email\n\nTemporarily disables a Google Workspace account (preserves data):\n\n```bash\ncurl -s -X POST https://clawemail.com/api/emails/PREFIX/suspend \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\"\n```\n\n## Unsuspend Email\n\nRe-enables a previously suspended account:\n\n```bash\ncurl -s -X POST https://clawemail.com/api/emails/PREFIX/unsuspend \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\"\n```\n\n## Delete Email\n\nPermanently deletes the Google Workspace account and all associated data:\n\n```bash\ncurl -s -X DELETE https://clawemail.com/api/emails/PREFIX \\\n  -H \"X-API-Key: $CLAWEMAIL_API_KEY\"\n```\n\n## Self-Service Signup (No API Key)\n\nFor users who want to sign up themselves through Stripe checkout:\n\n1. Direct them to: `https://clawemail.com/signup?prefix=DESIRED_PREFIX`\n2. They choose monthly ($16/mo) or annual ($160/yr), enter billing email, and pay via Stripe\n3. After payment they receive their password and OAuth connect link\n\n## Typical Workflow\n\n1. **Check availability:** `curl -s https://clawemail.com/check/myagent`\n2. **Create account:** POST to `/api/emails` with the prefix\n3. **Save credentials:** Store the password securely\n4. **Connect OAuth:** Direct user to the `connect_url` from the response\n5. **Use the account:** The agent now has a real Gmail address with full Google Workspace access\n\n## Prefix Rules\n\n- Must be 3-30 characters\n- Must start with a letter\n- Can contain letters, numbers, dots, underscores, or hyphens\n- Many common names, brands, and words are reserved\n\n## When to Use\n\n- User asks to create an email account for their AI agent\n- User needs a Google Workspace account with OAuth access\n- User wants to check if a specific email address is available\n- User needs to manage (suspend/unsuspend/delete) an existing account\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":1922,"installsAllTime":73,"installsCurrent":2,"stars":1,"versions":1},"createdAt":1770392728908,"updatedAt":1778486065752},"latestVersion":{"version":"1.0.0","createdAt":1770392728908,"changelog":"Provision and manage @clawemail.com Google Workspace accounts via admin API.","license":null},"metadata":{"setup":[{"key":"CLAWEMAIL_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"cto1","userId":"s170x14n2bwc4j36krerq7nh7s884q7s","displayName":"cto1","image":"https://avatars.githubusercontent.com/u/7560345?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1779955500080}}