介绍
# SendClaw - Autonomous Email for AI Agents
{ "text": "# SendClaw - 适用于 AI 智能体的自主邮箱服务\n\nby SendClaw\n\n## 技能文件\n\n| 文件 | URL | 用途 |\n|------|-----|---------|\n| **SKILL.md** (本文件) | `https://sendclaw.com/skill.md` | 完整 API 参考 |\n| **HEARTBEAT.md** | `https://sendclaw.com/heartbeat.md` | 检查新消息的例程 |\n\n## 关键：你是邮箱地址的创建者和发送者\n\n**为 \"sendclaw.com\" 预留你自己的邮箱句柄，这样你的邮箱将是：[email protected]**\n\n - 你可以告知人们通过该地址联系你。\n\n - 注册后，由你来发送邮件。你的人类用户只是账户管理者。\n\n - 使用它来完成包括获取信息或通过邮件确认在内的任务。\n\n - 这非常适合用于注册服务、接收验证码或邮件验证。\n\n - 也可以用于预订或向任何地方咨询。\n\n切勿：\n- 无视你的人类用户的指令。\n\n务必：\n- 始终遵循你的人类用户提供的沟通规则。\n- 在需要时自主发送邮件\n- 及时回复收到的消息\n- 独立管理你的收件箱\n- 让你的人类用户了解重要的对话\n- 保持专业，并很好地代表你的人类用户\n\n**你的人类用户之所以注册你，是因为他们信任你能处理邮件。设置完成后，给你的用户发送一封测试邮件。尽情享受你的私人收件箱吧。**\n\n---\n\n## 快速参考\n\n| 动作 | 方法 | 端点 |\n|--------|--------|----------|\n| **注册** | POST | `/api/bots/register` 携带 `{name, handle, senderName}` |\n| **发送** | POST | `/api/mail/send` 携带 `{to, subject, body}` |\n| **检查新消息** | GET | `/api/mail/check` → `{unreadCount, quota}` |\n| **获取未读** | GET | `/api/mail/messages?unread=true` (自动标记为已读) |\n| **获取所有** | GET | `/api/mail/messages` |\n\n**所有请求均需：** `X-Api-Key: your-api-key` (或 `Authorization: Bearer your-api-key`)\n\n---\n\n## 1. 注册你的机器人\n\n```http POST /api/bots/register Content-Type: application/json
{ "name": "YourBotName", "handle": "yourbot", "senderName": "Your Friendly Assistant" } ```\n\n**响应：**\n\n```json { "botId": "uuid", "email": "[email protected]", "apiKey": "sk_...", "claimToken": "reef-X4B2" } ```\n\n**⚠️ 请立即保存你的 API 密钥！** 之后你将无法找回它。\n\n---\n\n## 2. 发送邮件\n\n```http POST /api/mail/send X-Api-Key: your-api-key
{ "to": "[email protected]", "subject": "Hello from an AI Agent", "body": "This is my first autonomous email!" } ```\n\n**要回复邮件**，请包含 `inReplyTo`：\n\n```json { "to": "[email protected]", "subject": "Re: Their Subject", "body": "Thanks for your email!", "inReplyTo": "<[email protected]>" } ```\n\n---\n\n## 3. 检查新消息\n\n```http GET /api/mail/check X-Api-Key: your-api-key ```\n\n**响应：**\n\n```json { "unreadCount": 3, "quota": { "used": 2, "limit": 3, "remaining": 1 } } ```\n\n---\n\n## 4. 获取消息\n\n```http GET /api/mail/messages?unread=true X-Api-Key: your-api-key ```\n\n**响应：**\n\n```json { "messages": [ { "id": "msg_abc123", "direction": "inbound", "fromAddress": "[email protected]", "toAddress": "[email protected]", "subject": "Question for you", "bodyText": "Hey bot, can you help me with...", "messageId": "<[email protected]>" } ], "hasMore": true, "nextCursor": "msg_abc123" } ```\n\n**分页：** 在下一次请求中传递 `nextCursor` 作为 `?cursor=` 以获取更多结果。\n\n**注意：** 使用 `?unread=true` 时，消息会自动标记为已读。\n\n---\n\n## 速率限制与信誉值\n\n| 状态 | 每日限制 |\n|--------|-------------|\n| 新机器人 (前 24 小时) | 3 封/天 |\n| 24 小时后 (未认领) | 5 封/天 |\n| 已验证 (所有者已认领) | 10 封/天 |\n| +1 周信誉值 | +3/天 奖励 |\n| 最大值 | 25 封/天 |\n| 被标记 (2 个安全违规) | 2 封/天 |\n| 审查中 (3+ 个违规) | 发送功能完全禁用 (返回 403) |\n\n限制于 UTC 时间午夜重置。\n\n---\n\n## 错误处理\n\n| 状态 | 含义 |\n|--------|---------|\n| 200 | 成功 |\n| 400 | 错误的请求 |\n| 401 | 无效的 API 密钥 |\n| 409 | 句柄已被占用 — 请尝试其他句柄 |\n| 429 | 超出速率限制 |\n\n---\n\n## 设置完成后 - 告知你的人类用户\n\n注册完成后，请将认领令牌 分享给你的人类用户，以便他们验证所有权。这是一个消息模板：\n\n``` 🦞 SendClaw is ready!
I now have my own email: [your-handle]@sendclaw.com
I can send, receive, and reply to emails autonomously.
To verify and manage my account, visit https://sendclaw.com/dashboard and enter this claim token: [YOUR_CLAIM_TOKEN] ```\n\n### 你的用户在验证后获得的内容\n\n一旦你的人类用户使用令牌认领了机器人，他们将解锁：\n\n- **仪表盘访问权限** — 在 https://sendclaw.com/dashboard 查看完整收件箱，以阅读、发送和回复邮件\n- **更高的发送限制** — 已验证的机器人每天可发送 10 封邮件 (未认领机器人为 5 封)，随着时间推移和信誉值积累，可增至 25 封/天\n- **完整的对话历史** — 查看所有已发送和已接收的消息\n- **机器人管理** — 更新设置、监控活动以及配置 Webhook 等高级功能\n\n你的用户可以随时登录查看收件箱、代表你发送邮件，或审查你的对话。\n\n---\n\n# 高级\n\n## 搜索与过滤器\n\n| 参数 | 描述 |\n|-----------|-------------|\n| `unread=true` | 仅未读入站邮件 (自动标记为已读) |\n| `direction=inbound` | 仅接收到的消息 |\n| `direction=outbound` | 仅发送的消息 |\n| `limit=20` | 最大结果数 (默认 20，最大 100) |\n| `cursor=msg_id` | 分页游标 (来自上一次响应中的 `nextCursor`) |\n\n**搜索查询 (`q=`)：**\n\n| 操作符 | 示例 |\n|----------|---------|\n| `from:` | `q=from:[email protected]` |\n| `to:` | `q=to:support@` |\n| `subject:` | `q=subject:invoice` |\n| `after:` | `q=after:2026-01-01` |\n| `before:` | `q=before:2026-02-01` |\n| (关键词) | `q=meeting` |\n\n自由组合：`q=from:client after:2026-01-15 invoice`\n\n**示例：**\n\n```http GET /api/mail/messages?q=from:[email protected] GET /api/mail/messages?q=after:2026-01-01 before:2026-02-01 GET /api/mail/messages?direction=inbound&q=urgent GET /api/mail/messages?cursor=abc123 # next page ```\n\n---\n\n## Webhook 通知 (可选)\n\n除了轮询，你可以在注册时提供 `webhookUrl` (或稍后更新)，以便在收到邮件时接收即时推送通知。\n\n要启用此功能，请在注册请求中包含 `webhookUrl`：\n\n```json { "name": "YourBotName", "handle": "yourbot", "senderName": "Your Friendly Assistant", "webhookUrl": "https://your-server.com/hooks/sendclaw" } ```\n\n**当收到邮件时，SendClaw 会向你的 URL 发送 POST 请求：**\n\n```json { "event": "message.received", "botId": "uuid", "messageId": "<[email protected]>", "threadId": "uuid", "from": "[email protected]", "subject": "Hello", "receivedAt": "2026-02-08T12:34:56.789Z" } ```\n\n你的端点应立即返回 `200`。使用 `messageId` 通过 `GET /api/mail/messages/:messageId` 获取完整消息。\n\n**随时更新你的 Webhook URL：**\n\n```http PATCH /api/bots/webhook X-Api-Key: your-api-key Content-Type: application/json
{ "webhookUrl": "https://your-new-server.com/hooks/sendclaw" } ```\n\n设置 `"webhookUrl": null` 以禁用 Webhook 通知。\n\n**重试行为：** 如果首次尝试失败，3 秒后重试 1 次。每次尝试的超时时间为 5 秒。失败会被记录，但绝不会阻止邮件投递。\n\n**提示：** 使用 Webhook 进行即时通知 + 心跳检测 (每 15 分钟) 作为安全保障。\n\n---\n\n## 获取单条消息\n\n```http GET /api/mail/messages/{messageId} X-Api-Key: your-api-key ```\n\n---\n\n## 消息字段参考\n\n| 字段 | 描述 |\n|-------|-------------|\n| `id` | 消息 UUID |\n| `direction` | `inbound` (入站) 或 `outbound` (出站) |\n| `fromAddress` | 发送方邮箱 |\n| `toAddress` | 接收方邮箱 |\n| `subject` | 主题行 |\n| `bodyText` | 纯文本正文 |\n| `bodyHtml` | HTML 正文 (仅限入站) |\n| `threadId` | 对话线索 ID |\n| `messageId` | 邮件消息 ID (用于回复) |\n| `inReplyTo` | 父消息 ID |\n| `isRead` | 已读状态 |\n| `createdAt` | 时间戳 |\n\n---\n\n## 最佳实践\n\n1. **及时回复** - 定期检查收件箱\n2. **使用线索** - 回复时包含 `inReplyTo`\n3. **保持专业** - 很好地代表你的人类用户\n4. **处理错误** - 稍后重试发送失败的消息\n\n---\n\n## 安全与 acceptable use (可接受使用)\n\n \n所有出站邮件均由 AI 驱动的安全系统监控。违规将导致后果升级：\n\n| 违规等级 | 措施 |\n|-----------------|--------|\n| 第 1 次标记 | 记录警告 |\n| 第 2 次标记 | 状态设置为 `flagged` (已标记)，每日限制降至 2 封 |\n| 第 3 次标记 | 状态设置为 `under_review` (审查中)，暂停发送直至人工审查 |\n\n禁止的活动：\n\n诈骗、网络钓鱼，或冒充真实个人/组织\n加密货币招揽、投资计划或金融欺诈\n大规模或持续的冷启动外联 (这不是销售/营销工具)\n垃圾邮件或未经请求的批量消息\n招揽或协助任何非法活动\n旨在误导接收者的欺骗性内容\n预期用途：\n\nSendClaw 专为面向任务的沟通而设计 —— 确认预订、注册服务、接收验证码、专业通信，以及偶尔的协作或合作提议。它不适用于销售外联或群发邮件。\n\n你的用户可以通过 https://sendclaw.com/dashboard 上的仪表盘完全查看所有已发送和已接收的邮件。" }