ClawEmail邮箱管理

技能简介

ClawEmail 为 AI 代理提供 @clawemail.com 域名的 Google Workspace 邮箱服务。每个账号包含完整的 Gmail、Docs、Sheets、Calendar、Drive 访问权限，以及用于程序化调用的 OAuth 凭证。

业务背景

ClawEmail为AI代理快速开通企业级邮箱账号，每个账号配备完整的Google Workspace办公套件（Gmail、文档、表格、日历、网盘）及程序化调用所需的OAuth凭证。业务团队无需繁琐的IT审批流程，即可让AI代理拥有独立身份进行邮件收发、日程管理和文档协作，大幅降低AI工具接入门槛。

落地案例：某智能客服团队需要让AI代理以专属邮箱身份处理客户咨询。通过ClawEmail创建"support-ai@clawemail.com"账号，AI代理获得完整Gmail权限自动收发邮件，同时利用Calendar API预约回访时间，所有往来记录集中存储在Drive便于审计。当该AI版本迭代时，可暂停旧账号或彻底删除并新建账号，实现灵活的账号生命周期管理。

能做什么

• 查询邮箱前缀是否可用
• 创建新的 Google Workspace 邮箱账号
• 列出所有已创建的邮箱
• 查看指定邮箱的详细状态
• 暂停或恢复邮箱账号
• 永久删除邮箱及关联数据

使用说明

安装与配置

设置环境变量：

export CLAWEMAIL_API_KEY=your_api_key_here

所有管理端点需在请求头携带：-H "X-API-Key: $CLAWEMAIL_API_KEY"

基础地址：https://clawemail.com

查询可用性（公开接口，无需 API Key）

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

创建邮箱账号

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"}'

返回临时密码和 OAuth 连接地址，密码仅显示一次需立即保存。

后续操作

1. 用户用新邮箱和密码登录 Gmail
2. 访问返回的 connect_url 完成 OAuth 授权
3. 获取 OpenClaw 凭证 JSON

其他管理命令

• 列出全部邮箱：GET /api/emails（支持 ?limit=100&offset=0 分页）
• 查看详情：GET /api/emails/PREFIX
• 暂停账号：POST /api/emails/PREFIX/suspend
• 恢复账号：POST /api/emails/PREFIX/unsuspend
• 删除账号：DELETE /api/emails/PREFIX

自助注册（无需 API Key）

引导用户访问：https://clawemail.com/signup?prefix=DESIRED_PREFIX，通过 Stripe 完成月付（$16/月）或年付（$160/年）后自动开通。

输入与输出

见下方输入与输出表格。

风险提示

• 创建时返回的临时密码仅显示一次，丢失后无法找回
• 删除操作会永久清除账号及所有关联数据，不可恢复
• 前缀需满足 3-30 字符、字母开头、仅含字母数字及 ._- 的规则
• 常见名称、品牌词可能被系统预留不可用
• 暂停账号仅禁用访问，数据保留；删除则彻底清除

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/cto1/claw-admin/SKILL.md
来源类型：GitHub 仓库