name: claw-admin
description: "为 AI 代理提供和管理 @clawemail.com Google Workspace 邮箱账户。当用户需要为其 AI 代理创建邮箱、检查邮箱可用性或管理现有 ClawEmail 账户时使用。"
user-invocable: true
metadata: {"openclaw":{"requires":{"env":["CLAWEMAIL_API_KEY"]},"primaryEnv":"CLAWEMAIL_API_KEY","emoji":"🦞"}}

ClawEmail

为 AI 代理提供和管理 @clawemail.com 的 Google Workspace 邮箱账户。每个账户都包含完整的 Gmail、Docs、Sheets、Calendar 和 Drive 访问权限，以及用于编程访问的 OAuth 凭证。

设置

将您的 API 密钥设置为环境变量：

export CLAWEMAIL_API_KEY=your_api_key_here

基础 URL： https://clawemail.com

所有管理员接口都需要在请求头中包含：-H "X-API-Key: $CLAWEMAIL_API_KEY"

检查邮箱可用性 (公开接口 — 无需 API 密钥)

在创建账户前，务必检查所需前缀是否可用：

curl -s https://clawemail.com/check/所需前缀

当邮箱可用时的响应：

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

当邮箱已被占用或保留时的响应：

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

创建邮箱账户

创建一个新的 @clawemail.com Google Workspace 用户。返回临时密码和 OAuth 连接 URL。

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

响应示例：

{
  "success": true,
  "email": "tom@clawemail.com",
  "password": "aB3$xYz...",
  "connect_url": "https://clawemail.com/connect/tom",
  "instructions": "1. 用户使用上面的邮箱/密码登录 Gmail。 2. 用户访问 connect_url 以授权 OAuth。 3. 用户将收到其 OpenClaw 凭证。"
}

重要提示： 请立即保存密码 — 它只显示一次。

创建账户后，用户必须：
1. 使用新邮箱和密码在 https://mail.google.com 登录 Gmail。
2. 访问 connect_url 以授权 OAuth 并接收其凭证 JSON 文件。

列出所有邮箱

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

支持使用 ?limit=100&offset=0 进行分页。

获取邮箱详情

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

返回邮箱状态、创建日期、OAuth 连接日期以及 Workspace 用户详情。

暂停邮箱

临时禁用 Google Workspace 账户（保留数据）：

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

恢复邮箱

重新启用之前被暂停的账户：

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

删除邮箱

永久删除 Google Workspace 账户及其所有关联数据：

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

自助注册 (无需 API 密钥)

对于希望通过 Stripe 结账自行注册的用户：

1. 引导他们访问：https://clawemail.com/signup?prefix=所需前缀
2. 他们选择月付（$16/月）或年付（$160/年），输入账单邮箱，并通过 Stripe 支付。
3. 支付后，他们将收到密码和 OAuth 连接链接。

典型工作流程

1. 检查可用性： curl -s https://clawemail.com/check/myagent
2. 创建账户： 向 /api/emails 发送 POST 请求，包含所需前缀。
3. 保存凭证： 安全地存储密码。
4. 连接 OAuth： 引导用户访问响应中的 connect_url。
5. 使用账户： 代理现在拥有了一个具有完整 Google Workspace 访问权限的真实 Gmail 地址。

前缀规则

• 长度必须在 3 到 30 个字符之间。
• 必须以字母开头。
• 可以包含字母、数字、点、下划线或连字符。
• 许多常见的名称、品牌和词汇已被保留。

使用场景

• 用户要求为其 AI 代理创建邮箱账户。
• 用户需要一个具有 OAuth 访问权限的 Google Workspace 账户。
• 用户想要检查特定邮箱地址是否可用。
• 用户需要管理（暂停/恢复/删除）现有账户。