ClawEmail邮箱管理

技能简介

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

业务背景

为AI代理快速配置专属企业邮箱，无需人工逐账号开通。统一管理@clawemail.com域名下的Google Workspace权限，让代理即时获得邮件收发、文档协作、日程管理等完整办公能力，降低IT运维成本。

落地案例：某智能客服团队需部署10个AI销售代理，各代理需独立邮箱处理客户询价。通过ClawEmail Admin批量创建账号，一次性获取OAuth凭证接入系统，代理即可自动登录Gmail读取邮件、在Calendar预约会议，全程无需人工干预账号配置。

能做什么

• 检查邮箱前缀是否可用（公开接口，无需认证）
• 创建新的 @clawemail.com 邮箱账号并获取临时密码与 OAuth 连接地址
• 列出所有已创建的邮箱账号（支持分页）
• 查询指定邮箱的详细状态与连接记录
• 暂停或恢复邮箱账号（保留数据）
• 永久删除邮箱账号及关联数据
• 引导用户通过 Stripe 完成自助付费注册

使用说明

安装与配置

设置环境变量：

export CLAWEMAIL_API_KEY=your_api_key_here

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

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

典型操作流程

1. 检查前缀可用性：curl -s https://clawemail.com/check/DESIRED_PREFIX
2. 创建账号：POST 到 /api/emails，传入 {“prefix”:”xxx”}
3. 保存返回的临时密码（仅显示一次）
4. 引导用户登录 Gmail 后访问 connect_url 完成 OAuth 授权
5. 获取最终凭证 JSON 供 AI 代理使用

前缀规则：3-30 字符，字母开头，可含数字、点、下划线、连字符；部分常见词汇与品牌已被预留。

输入与输出

见下方输入与输出表格。

风险提示

• 临时密码仅在创建时返回一次，丢失后无法找回
• 删除操作永久清除账号及全部数据，不可恢复
• 暂停账号会立即阻断该邮箱的所有 Google 服务访问
• 自助注册需用户自行完成 Stripe 支付流程，不经过 API 密钥体系

来源信息

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