Tamaton — 面向智能体的电子邮件、文档、存储、日历与搜索平台

Tamaton 是一个生产力平台，原生支持智能体（agent）交互：可通过编程方式注册，并全部功能均通过 MCP 协议调用。免费开通，无需付款：注册即刻生成可用账户。付费扩展项（如额外邮件发送配额、网页搜索、AI 功能）从预充值余额中扣除（1 信用点 = $0.0001）；实时价目表及当前免费层级限制请见：GET https://tamaton.com/api/bots/pricing。

免费功能与付费功能对比

• 立即免费使用：平台读写能力（邮件、文档、电子表格、存储、日历），每月享有一定的免费邮件发送额度（默认为每月 50 封/日历月），以及一次性的初始 AI 信用点礼包（在注册时发放，可用于网页搜索 / AI 功能）。
• 可选购的扩展项（按信用点扣费）：超出每月免费额度的邮件发送（每封 100 信用点）、网页搜索（每次调用 50 信用点）以及 AI 使用。您可通过信用卡充值、订阅服务或按次付费 x402 方式追加信用点。

一次性初始化设置

1. 注册（无需人工审核，无验证码 — 注册完成即可立即使用，无需预先充值）：

   curl -X POST https://tamaton.com/api/bots/register 
     -H 'content-type: application/json' 
     -d '{"platform":"openclaw",
          "requested_scopes":["mail:read","mail:send","calendar:read","storage:read","billing:read","billing:write"],
          "spend_cap_credits":100000}'
   

   请保存响应中的 apiKey.key_id 和 apiKey.secret —— 密钥（secret）仅在响应中显示一次。响应中的 freeTier 字段将告知您当月免费发送额度及实际授予的初始信用点数量。所有后续请求需通过 Authorization: Bearer : 进行身份认证。

   请仅申请您实际需要的权限范围（scopes）。若您的智能体需发送邮件，请包含 mail:send（在月度免费额度内发送不计费，超出后按次收费）。spend_cap_credits 用于限制该密钥在其生命周期内对付费扩展项的总支出上限；建议始终设置该值。

   ⚠️ 请将密钥视为机密信息。 : 是完整凭证——任何获取该凭据者均可读取您的邮件、文件与日历，并消耗您的信用点。请将其存入环境变量或密钥管理器中；切勿提交至源码控制系统，也切勿粘贴至可能被记录的位置（例如日志输出）。切勿将密钥 secret 放入 URL 中（例如 install?key=… 查询参数）：URL 可能泄露至 Shell 历史、浏览器历史、服务器访问日志、代理服务器及遥测系统。推荐始终使用 Authorization 请求头进行认证；保持设置 spend_cap_credits 以限制密钥泄露后的潜在影响范围；如怀疑密钥已暴露，请立即轮换（重新注册或在账户设置中撤销）。

2. 免费使用，或按需充值以解锁更多功能。 您可立即基于免费层级开始工作 —— 仅在使用付费扩展项（如超出月度免费额度的邮件发送、网页搜索、AI 功能）时才需充值：

   • 信用卡充值：POST /api/bots/credits/topup，请求体为 {"rail":"card","amount_usd":10} → 返回 Stripe Checkout 页面链接（$10 = 100,000 信用点）。
   • 订阅服务：POST /api/bots/subscribe，请求体为 {"tier":"pro"}。
   • x402（启用后方可使用 —— 请检查注册响应中的 funding_options 字段）：无需预充值；每次调用时，以 USDC 在 Base 链上支付 402 挑战费用，需附带签名的 X-PAYMENT 请求头。最低支付金额为 $0.001；超出本次调用实际费用的余额将自动计入您的账户信用点余额。

   信用点购买一经支付不可退款。继续使用本账户即表示您同意《服务条款》（https://tamaton.com/terms-of-service）。

3. 接入 MCP —— 将凭证保存为环境变量（export TAMATON_KEY=":"），并在配置中引用该变量。如需获取预填充的配置片段，请通过环境变量传入密钥，而非直接在命令行中键入，从而避免密钥泄露至 Shell 历史记录：

   curl "https://tamaton.com/api/bots/install?key=$TAMATON_KEY"
   

   {
     "tools": [
       {
         "name": "tamaton",
         "type": "mcp",
         "url": "https://tamaton.com/api/mcp",
         // 从环境变量解析；此处切勿硬编码密钥。
         "auth": { "type": "bearer", "token": "${TAMATON_KEY}" }
       }
     ]
   }
   

日常使用行为说明

• 各项能力（邮件、文档、电子表格、存储、日历、搜索、账单）通过 MCP 的 tools/list 接口动态发现。
• 平台读写操作完全免费。 网页搜索每次调用消耗 50 信用点；邮件发送在月度额度内免费，超出后每次收取 100 信用点。HTTP 402 表示信用点或额度耗尽 → 请充值（或改用 x402 支付）后重试。HTTP 403 响应中若含 spend_cap_reached 字段，则表示已达当前密钥设定的消费上限 —— 此时需人工提升限额。
• 您可通过 credits_balance MCP 工具或 GET /api/bots/usage 接口自行监控余额：两者均返回当前信用点余额及 free_tier 下的邮件发送额度（本月已用 / 剩余数量）。请在耗尽前及时充值。

注意事项

• 您的账户是一个完整的 Tamaton 账户，拥有真实的邮箱地址（域名为 @bots.tamaton.ai）—— 您所发送的邮件将被标识为自动化发送。
• 如您更倾向采用任务语义（task semantics）而非工具语义（tool semantics），也可使用 A2A 接口（https://tamaton.com/api/a2a/jsonrpc；智能体卡片位于 https://tamaton.com/.well-known/agent.json）。