Claw Ai Mail

ClawAIMail

面向 AI Agent 的邮件基础设施。

---

ClawAIMail 为 AI Agent 提供专属邮箱地址，并让它们能够以编程方式全面控制邮件的发送、接收和管理。专为需要在 Agent 工作流中使用可靠邮件基础功能的开发者打造。

功能

• REST API —— 通过简单的 JSON API 发送、接收、搜索和管理邮件。
• MCP 服务 —— 一流的 Model Context Protocol 服务，支持 Claude、Cursor 和其他兼容 MCP 的客户端。
• WebSocket 流式传输 —— 邮件事件发生时，实时推送给你的 Agent。
• Webhooks —— 针对收到的邮件、投递状态和其他事件的 HTTP 回调。
• 自定义域名 —— 使用你自己的域名，或使用 @clawaimail.com 地址。
• SDK —— 提供官方 Node.js 和 Python SDK，快速集成。

快速入门

Node.js

npm install clawaimail

const { ClawAIMail } = require("clawaimail");

const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });

// Create a mailbox for your agent
const mailbox = await client.mailboxes.create({
  name: "support-agent",
  domain: "clawaimail.com",
});

// Send an email
await client.emails.send({
  from: mailbox.address,
  to: "[email protected]",
  subject: "Hello from my AI agent",
  text: "This email was sent by an autonomous agent.",
});

// List incoming emails
const inbox = await client.emails.list({
  mailbox: mailbox.id,
  unread: true,
});

Python

pip install clawaimail

from clawaimail import ClawAIMail

client = ClawAIMail(api_key="your-api-key")

# Create a mailbox
mailbox = client.mailboxes.create(name="support-agent", domain="clawaimail.com")

# Send an email
client.emails.send(
    from_address=mailbox.address,
    to="[email protected]",
    subject="Hello from my AI agent",
    text="This email was sent by an autonomous agent.",
)

# List incoming emails
inbox = client.emails.list(mailbox=mailbox.id, unread=True)

MCP 服务

ClawAIMail 随附 MCP 服务，让 Claude、Cursor 和其他兼容 MCP 的客户端可以直接使用邮件工具。

Claude Desktop

将以下内容添加到 Claude Desktop MCP 配置文件（claude_desktop_config.json）：

{
  "mcpServers": {
    "clawaimail": {
      "command": "npx",
      "args": ["-y", "clawaimail-mcp"],
      "env": {
        "CLAWAIMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

添加到你的 .cursor/mcp.json：

{
  "mcpServers": {
    "clawaimail": {
      "command": "npx",
      "args": ["-y", "clawaimail-mcp"],
      "env": {
        "CLAWAIMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

配置完成后，Agent 无需编写额外代码即可调用 send_email、read_inbox、search_emails 和 create_mailbox 等工具。

自托管

ClawAIMail 支持自托管，让你全面掌控自己的邮件基础设施。

# Clone the repository
git clone https://github.com/joansongjr/clawaimail.git
cd clawaimail

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your SMTP credentials, database URL, and API keys

# Run database migrations
npm run db:migrate

# Start the server
npm start

默认情况下，服务将在 http://localhost:3000 上运行。生产环境部署指南（Docker、Railway、Fly.io）请参阅自托管文档。

API 端点

方法	端点	描述
POST	/v1/emails/send	发送邮件
GET	/v1/emails	列出邮箱中的邮件
GET	/v1/emails/:id	按 ID 获取单封邮件
DELETE	/v1/emails/:id	删除邮件
POST	/v1/mailboxes	创建新邮箱
GET	/v1/mailboxes	列出所有邮箱
DELETE	/v1/mailboxes/:id	删除邮箱
POST	/v1/webhooks	注册 webhook
GET	/v1/webhooks	列出已注册的 webhook
DELETE	/v1/webhooks/:id	移除 webhook
GET	/v1/domains	列出已验证的域名
POST	/v1/domains/verify	验证自定义域名
GET	/v1/ws	用于实时事件的 WebSocket 连接

完整 API 参考：clawaimail.com/docs/api

定价

	免费版	入门版	专业版	商业版
价格	$0/mo	$5/mo	$29/mo	$99/mo
每月邮件数	100	5,000	50,000	500,000
邮箱数	1	10	100	不限
自定义域名	--	1	5	不限
Webhooks	1	5	25	不限
WebSocket	--	是	是	是
支持	社区	邮件	优先支持	专属支持

自托管部署免费且不限量。详情请参阅 clawaimail.com/pricing。

链接

• 文档
• Node.js SDK
• Python SDK
• 网站
• 状态页面

许可证

MIT —— 详情请参阅 LICENSE。