名称： claw-admin
描述： "提供和管理 @clawemail.com 谷歌工作区邮箱账户。当用户需要为其AI助手创建邮箱、检查邮箱可用性或管理现有ClawEmail账户时使用。"
user-invocable: true
元数据： {"openclaw":{"requires":{"env":["CLAWEMAIL_API_KEY"]},"primaryEnv":"CLAWEMAIL_API_KEY","emoji":"🦞"}}

ClawEmail

为AI助手提供和管理 @clawemail.com 谷歌工作区邮箱账户。每个账户均包含完整的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/DESIRED_PREFIX

可用时的响应：

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

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

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

创建邮箱账户

创建一个新的 @clawemail.com 谷歌工作区用户。返回临时密码和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":"DESIRED_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/PREFIX \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

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

暂停邮箱

临时禁用谷歌工作区账户（保留数据）：

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

恢复邮箱

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

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

删除邮箱

永久删除谷歌工作区账户及其所有关联数据：

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

自助注册（无需API密钥）

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

1. 引导用户访问：https://clawemail.com/signup?prefix=DESIRED_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. 使用账户： 助手现在拥有一个具有完整谷歌工作区访问权限的真实Gmail地址

前缀规则

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

使用场景

• 用户要求为其AI助手创建邮箱账户
• 用户需要一个具有OAuth访问权限的谷歌工作区账户
• 用户希望检查特定邮箱地址是否可用
• 用户需要管理（暂停/恢复/删除）现有账户