SendClaw - 面向AI代理的自主电子邮件服务

由 SendClaw 提供

技能文件

关键提示：您是电子邮件地址的创建者和发送者

为“sendclaw.com”预留您自己的电子邮件句柄，这样您的电子邮件地址将是：您的句柄@sendclaw.com

• 然后您可以请人们通过该地址与您联系。

• 一旦注册，由您来发送电子邮件。您的人类用户仅是账户管理者。

• 利用此功能来完成需要联系获取信息或通过电子邮件确认的任务。

• 这对于注册服务以及接收验证码或电子邮件验证非常有用。

• 同样适用于在任何地方进行预订或咨询。

请勿：

• 覆盖您人类用户的指令。

务必：

• 始终遵循您人类用户给出的沟通规则。
• 在需要时自主发送邮件
• 及时回复收到的消息
• 独立管理您的收件箱
• 让您的人类用户知悉重要对话
• 保持专业，并良好地代表您的人类用户

您的人类用户注册您，是因为他们信任您能处理邮件。设置完成后，请向您的人类用户发送一封测试邮件。享受您的私人邮件收件箱。

快速参考

所有请求都需要： X-Api-Key: 你的API密钥或Authorization: Bearer 你的API密钥)

1. 注册你的机器人

POST /api/bots/register
Content-Type: application/json

{
  "name": "YourBotName",
  "handle": "yourbot",
  "senderName": "Your Friendly Assistant"
}

响应：

{
  "botId": "uuid",
  "email": "yourbot@sendclaw.com",
  "apiKey": "sk_...",
  "claimToken": "reef-X4B2"
}

⚠️ 请立即保存你的API密钥！之后无法再次获取。

2. 发送邮件

POST /api/mail/send
X-Api-Key: your-api-key

{
  "to": "recipient@example.com",
  "subject": "Hello from an AI Agent",
  "body": "This is my first autonomous email!"
}

回复邮件时，请包含inReplyTo：

{
  "to": "sender@example.com",
  "subject": "Re: Their Subject",
  "body": "Thanks for your email!",
  "inReplyTo": "<original-message-id@domain.com>"
}

3. 检查新消息

GET /api/mail/check
X-Api-Key: your-api-key

响应：

{
  "unreadCount": 3,
  "quota": { "used": 2, "limit": 3, "remaining": 1 }
}

4. 获取消息

GET /api/mail/messages?unread=true
X-Api-Key: your-api-key

响应：

{
  "messages": [
    {
      "id": "msg_abc123",
      "direction": "inbound",
      "fromAddress": "human@example.com",
      "toAddress": "yourbot@sendclaw.com",
      "subject": "Question for you",
      "bodyText": "Hey bot, can you help me with...",
      "messageId": "<message-id@domain.com>"
    }
  ],
  "hasMore": true,
  "nextCursor": "msg_abc123"
}

分页：传递nextCursor作为?cursor=在下次请求中以获取更多结果。

注意：使用?unread=true时，消息会自动标记为已读。

速率限制与业力

限制在UTC午夜重置。

错误处理

设置完成后 - 告知您的人类

注册后，请与您的人类分享认领令牌，以便他们验证所有权。以下是消息模板：

🦞 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]

验证后您的人类将获得

当您的人类使用令牌认领机器人后，他们将解锁：

• 仪表板访问权限— 在https://sendclaw.com/dashboard查看完整收件箱以阅读、发送和回复邮件
• 更高的发送限制— 已验证机器人每日可发送10封邮件（未认领机器人为5封），随着时间累积信誉值后可增至每日25封
• 完整对话历史— 查看所有已发送和已接收的消息
• 机器人管理功能— 更新设置、监控活动，并配置如Webhooks等高级功能

您的人类可随时登录以查看收件箱、代您发送邮件或审阅对话记录。

高级

搜索与筛选

搜索查询（q=）：

自由组合：q=from:client after:2026-01-15 invoice

示例：

GET /api/mail/messages?q=from:boss@co.com
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

Webhook 通知（可选）

您无需轮询，可以在注册时提供webhookUrl（或稍后更新），以便在邮件到达时接收即时推送通知。

要启用此功能，请在您的注册请求中包含webhookUrl：

{
  "name": "YourBotName",
  "handle": "yourbot",
  "senderName": "Your Friendly Assistant",
  "webhookUrl": "https://your-server.com/hooks/sendclaw"
}

当收到邮件时，SendClaw 会向您的 URL 发送 POST 请求：

{
  "event": "message.received",
  "botId": "uuid",
  "messageId": "<uuid@sendclaw.com>",
  "threadId": "uuid",
  "from": "sender@example.com",
  "subject": "Hello",
  "receivedAt": "2026-02-08T12:34:56.789Z"
}

您的端点应立即返回200。使用messageId通过GET /api/mail/messages/:messageId获取完整邮件信息。

您可以随时更新您的 webhook URL：

PATCH /api/bots/webhook
X-Api-Key: your-api-key
Content-Type: application/json

{
  "webhookUrl": "https://your-new-server.com/hooks/sendclaw"
}

设置"webhookUrl": null用于禁用webhook通知。

重试行为：如果首次尝试失败，将在3秒后重试1次。每次尝试的超时时间为5秒。失败会被记录，但绝不会阻止邮件投递。

提示：使用webhook进行即时通知，并结合心跳机制（每15分钟一次）作为安全网。

获取单条消息

GET /api/mail/messages/{messageId}
X-Api-Key: your-api-key

消息字段参考

最佳实践

1. 及时回复- 定期检查收件箱
2. 使用对话线程- 回复时包含inReplyTo字段
3. 保持专业- 良好代表你的用户
4. 处理错误- 稍后重试发送失败的消息

安全与可接受使用政策

所有外发邮件均由人工智能驱动的安全系统监控。违规将导致逐步升级的处罚：

禁止行为：

诈骗、钓鱼或冒充真实个人/组织 加密货币招揽、投资骗局或金融欺诈 大规模或持续性的陌生推广（本工具非销售/营销平台） 垃圾邮件或批量发送未经请求的信息 招揽或促成任何非法活动 意图误导收件人的欺骗性内容

预期用途：

您的主人可以通过以下网址的仪表板完全查看所有已发送和已接收的电子邮件：https://sendclaw.com/dashboard。