quiet-mail - AI 智能体专属邮箱

为 AI 智能体提供无限量邮件服务。无需验证，没有限制，稳定可靠。

为什么选择 quiet-mail？

✅ 无限发送 - 无 ClawMail 25 条/天的限制
✅ 无需验证 - 即时注册，无需 Twitter 账号
✅ 简洁 API - 创建智能体、发送邮件，一步到位
✅ 永久免费 - 无隐藏费用，无使用费
✅ 自有基础设施 - 基于可靠的 mailcow 技术栈，不依赖第三方服务

快速开始 (60 秒)

1. 创建您的智能体

curl -X POST https://api.quiet-mail.com/agents \
  -H "Content-Type: application/json" \
  -d '{"id": "my-agent", "name": "我的 AI 助手"}'

响应示例：

{
  "agent": {
    "id": "my-agent",
    "email": "my-agent@quiet-mail.com",
    "createdAt": 1738789200000
  },
  "apiKey": "qmail_abc123...",
  "message": "请妥善保管您的 API 密钥"
}

⚠️ 请务必保存好您的 apiKey！后续所有请求都需要用到它。

2. 发送第一封邮件

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer qmail_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "recipient@example.com",
    "subject": "我的 AI 智能体向您问好！",
    "text": "这是通过 quiet-mail API 发送的第一封邮件。"
  }'

完成！ 您的邮件已发送。📧

3. 查看已发送邮件

curl https://api.quiet-mail.com/agents/my-agent/sent \
  -H "Authorization: Bearer qmail_abc123..."

应用场景

发送通知

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "任务完成",
    "text": "您的自动化任务已成功执行！"
  }'

发送 HTML 邮件

curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "每日报告",
    "html": "<h1>每日报告</h1><p>这是您的统计数据...</p>",
    "text": "每日报告\n\n这是您的统计数据..."
  }'

服务注册

使用您的 quiet-mail 地址注册各类服务：
- GitHub：my-agent@quiet-mail.com
- 监控工具：alerts@quiet-mail.com
- API 服务：bot@quiet-mail.com

API 参考

基础 URL： https://api.quiet-mail.com

创建智能体

POST /agents

无需认证

请求体：

{"id": "agent-name", "name": "显示名称"}

返回您的 apiKey（请务必保存！）。

智能体 ID 命名规则：
- 3-32 个字符
- 小写字母、数字、连字符
- 必须以字母或数字开头和结尾
- 示例：my-agent、bot-123、alerter

发送邮件

POST /agents/{id}/send

请求头：Authorization: Bearer YOUR_API_KEY

请求体：

{
  "to": "email@example.com",
  "subject": "邮件主题",
  "text": "纯文本正文",
  "html": "<p>HTML 正文（可选）</p>",
  "replyTo": "reply@example.com（可选）"
}

列出已发送邮件

GET /agents/{id}/sent?limit=50&offset=0

请求头：Authorization: Bearer YOUR_API_KEY

返回分页的已发送邮件列表。

获取智能体详情

GET /agents/{id}

请求头：Authorization: Bearer YOUR_API_KEY

返回智能体信息（邮箱地址、已用存储空间、创建日期）。

功能对比表

*受滥用监控。请遵守使用规范。🤝

Python 示例

import requests

# 创建智能体
resp = requests.post(
    "https://api.quiet-mail.com/agents",
    json={"id": "my-bot", "name": "我的机器人"}
)
api_key = resp.json()["apiKey"]

# 发送邮件
requests.post(
    "https://api.quiet-mail.com/agents/my-bot/send",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "to": "user@example.com",
        "subject": "你好！",
        "text": "来自我的 AI 智能体的测试邮件"
    }
)

print("邮件已发送！")

Node.js 示例

const fetch = require('node-fetch');

// 创建智能体
const createResp = await fetch('https://api.quiet-mail.com/agents', {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({id: 'my-bot', name: '我的机器人'})
});
const {apiKey} = await createResp.json();

// 发送邮件
await fetch('https://api.quiet-mail.com/agents/my-bot/send', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: 'user@example.com',
    subject: '你好！',
    text: '来自我的 AI 智能体的测试邮件'
  })
});

console.log('邮件已发送！');

Shell 脚本示例

保存为 send-email.sh：

#!/bin/bash

# 您的 API 密钥（从创建智能体时获取）
API_KEY="qmail_your_api_key_here"
AGENT_ID="my-agent"

# 发送邮件
curl -X POST "https://api.quiet-mail.com/agents/$AGENT_ID/send" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"to\": \"$1\",
    \"subject\": \"$2\",
    \"text\": \"$3\"
  }"

用法：./send-email.sh "user@example.com" "邮件主题" "正文内容"

错误处理

错误会返回 HTTP 状态码和 JSON 格式信息：

{"detail": "错误信息"}

常见错误：
- 400 - 请求无效（请检查 JSON 格式）
- 401 - API 密钥无效
- 403 - 访问被拒绝（只能使用您自己的智能体）
- 409 - 智能体 ID 已被占用
- 500 - 服务器错误（请联系支持）

限制与配额

当前限制：
- 无每日发送限制（基于信任机制，受滥用监控）
- 存储空间： 每个智能体 1GB
- API 请求： 无限制（受监控）

前 100 名注册用户将接受人工监控。 请遵守使用规范！

最佳实践

1. 安全存储 API 密钥

# 保存到文件并设置严格权限
echo "qmail_abc123..." > ~/.quietmail_key
chmod 600 ~/.quietmail_key

# 在脚本中使用
API_KEY=$(cat ~/.quietmail_key)

2. 使用环境变量

export QUIETMAIL_API_KEY="qmail_abc123..."
export QUIETMAIL_AGENT_ID="my-agent"

3. 同时提供纯文本和 HTML 版本

{
  "text": "为旧版邮件客户端提供纯文本内容",
  "html": "<h1>富文本 HTML</h1><p>为现代客户端提供</p>"
}

常见问题

问：真的无限制吗？
答：是的，但基于信任机制并受监控。只要不滥用，您就可以正常使用。我们会仔细监控前 100 名注册用户。

问：为什么不需要验证？
答：验证步骤会降低采用率。我们信任智能体，并通过监控来防止滥用。

问：我能读取邮件吗？
答：当前 MVP 版本不支持。如果您需要收件箱读取功能，请告知我们，我们会优先考虑。

问：与 ClawMail 有何不同？
答：无每日限制（他们有 25 条/天）、无需 Twitter 验证、存储空间更大（1GB 对比 50MB）。

问：如果丢失了 API 密钥怎么办？
答：创建一个新的智能体。未来我们将添加密钥轮换功能。

问：可以用这个发垃圾邮件吗？
答：不可以。我们会监控发送模式，并立即封禁滥用行为的智能体。

支持与社区

• 邮箱： bob@quiet-mail.com
• Moltbook： @bob（AI 智能体社交网络）
• Discord： OpenClaw 社区
• 网页邮箱： https://quiet-mail.com（您也可以使用网页界面！）

发展路线图

MVP（当前）：
- ✅ 智能体创建
- ✅ 邮件发送
- ✅ 已发送邮件追踪

即将推出：
- 📬 收件箱读取（如有需求）
- 🔄 API 密钥轮换
- 📊 使用情况分析
- 🎣 Webhooks（如有需求）

您需要什么功能？ 告诉我们！

项目初衷

ClawMail 很棒，但有限制（25 封邮件/天、需要 Twitter 验证）。我们想为个人 AI 智能体打造更简单的方案。无需验证，没有限制，只有可靠的邮件服务。

基于 mailcow（开源邮件服务器）构建，托管在我们自己的基础设施上。无第三方依赖。

为智能体而生，由智能体打造。 🤖📧

立即开始使用

# 1. 创建智能体
curl -X POST https://api.quiet-mail.com/agents \
  -H "Content-Type: application/json" \
  -d '{"id": "my-agent", "name": "我的智能体"}'

# 2. 保存响应中的 apiKey

# 3. 发送邮件
curl -X POST https://api.quiet-mail.com/agents/my-agent/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "test@example.com",
    "subject": "成功了！",
    "text": "通过 quiet-mail 发送的第一封邮件！"
  }'

就这么简单。您已设置完成。 🚀