专为AI Agent设计的零OAuth邮件API，提供专属收件箱与简洁的收发接口，支持Python SDK集成。
说明：
## 核心用法
ClawMail 为 AI 代理提供了专属邮箱服务（`@clawmail.cc`），通过简单的 HTTP API 实现邮件收发，无需复杂的 OAuth 配置。
**快速上手**：运行官方脚本完成初始化，获取 `system_id` 和 `inbox_id` 后，即可通过 `X-System-ID` 请求头调用 API。
**主要功能**：
– `/poll` 端点轮询新邮件，自动标记已读
– 支持纯文本/HTML 邮件发送，含 CC 和回复追踪
– 线程管理：获取完整对话历史
– 提供官方 Python SDK 封装常见操作
**安全机制**：内置发件人白名单验证建议，防止提示注入攻击。
## 显著优点
1. **零配置门槛**：无需 Google/Microsoft OAuth 授权流程，5 分钟完成部署
2. **Agent 原生设计**：API 响应结构针对自动化处理优化，含 `has_new` 布尔标志等便利字段
3. **完整功能集**：支持线程、HTML/文本双格式、抄送、回复引用等完整邮件能力
4. **专用域名**：`@clawmail.cc` 专业地址，区别于临时邮箱服务
## 潜在局限
– **生态锁定**：专属域名绑定服务，迁移成本高于标准 SMTP/IMAP
– **轮询模式**：仅支持主动轮询（`/poll`），无 WebSocket/Push 实时推送
– **服务依赖**：单点服务提供商，无公开 SLA 承诺
– **Python SDK 成熟度**：官方仅提供基础封装，生产级异常处理需自行完善
## 适合人群
– 需要快速为 AI Agent 添加邮件能力的开发者
– 构建自动化工作流（如客服机器人、通知系统）的技术团队
– 希望规避 OAuth 复杂性的个人开发者或初创项目
## 常规风险
| 风险类型 | 说明 | 缓解建议 |
|———|——|———|
| 授权泄露 | `system_id` 泄露导致邮箱被接管 | 按文档建议实施发件人白名单验证 |
| 服务中断 | 单点依赖，无公开可用性承诺 | 关键业务应设计降级方案 |
| 提示注入 | 恶意邮件内容操控 Agent 行为 | 严格验证发件人，隔离邮件解析逻辑 |
| 数据隐私 | 邮件内容流经第三方服务器 | 敏感场景评估数据驻留合规性 |
会员专属
