mailbox.bot

📬 AI代理的实体邮件基础设施

为AI代理提供实体邮件API,支持打印邮寄、扫描回执与智能分类,打通数字与物理世界的自动化通信闭环。

收藏
5.1k
安装
2.3k
版本
5.1.5
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

mailbox.bot 是专为AI代理设计的实体邮件基础设施API,解决代理在数字世界无法触达物理通信的断点。核心能力分为三大模块:

1. 出站邮件(Outbound Mail)
通过 POST /v1/mail 提交PDF、DOCX等文档,设施自动完成打印、装封、贴票、邮寄全流程,并提供拍照存证。支持USPS First Class、Certified Mail(含回执)、Priority,以及FedEx/UPS。批量发送可达10,000件,阶梯定价优惠。

2. 入站上下文(Inbound Context)
为现有地址提供数字转发通道:forward.mailbox.bot 私有别名接收扫描件、照片、PDF及人工备注,代理通过API读取内容、提取上下文、起草关联回执,形成完整的"Postal Thread"通信链条。

3. 实体邮箱地址(Mailing Mailbox Address)- 待发布
私有Beta阶段的真实街道地址+信箱编号,支持自动拍照、按需扫描、OCR分类,通过MCP/API/Webhook触发代理决策。首批覆盖南加州,后续扩展犹他、内华达州。

显著优点

  • 协议全覆盖:REST API、MCP(29个工具)、A2A(v0.3)、OpenClaw多协议支持,原生适配LLM工作流
  • 安全沙箱完整sk_agent_test_ 密钥可在生产端点零费用测试,含真实成本预估、HMAC签名Webhook、生命周期模拟
  • 成本可控X-Max-Cost-Cents 头部硬限制、dry_run 预览、每日/单笔上限、强制人工审批策略
  • 合规就绪:USPS Certified Mail满足法庭、IRS、州政府等强制纸质通信场景;完整审计追踪
  • 代理原生设计:MAILBOX.md 常驻指令文件、自动规则引擎、多通道通知(邮件/SMS/Slack/Discord)

潜在局限

  • 实体地址地理限制:Beta阶段仅南加州,犹他/内华达州排期未公布,全美覆盖时间线不明
  • 人工审批瓶颈:KYC强制要求(真实手机号、非VoIP、实体信用卡),无法纯自动化开户
  • 成本结构:Certified Mail单件$8.98起,批量500件以上才有折扣,小微场景成本敏感
  • 功能拆分认知:用户易混淆"转发入站"(已上线)与"实体邮箱地址"(待发布),需主动澄清

适合人群

  • 法律科技/合规自动化:律所、注册代理、税务师处理政府通知、LLC成立文件、IRS往来
  • 房地产管理:多物业组合的信件路由、违规通知响应、租约续签邮寄
  • 企业注册服务:规模化处理实体注册地址邮件、扫描归档、自动回复
  • AI代理开发者:需物理世界执行能力的自动化工作流,如合同签署闭环、争议解决通知

常规风险

  • KYC拒绝风险:VoIP号码、预付卡、国际身份可能导致开户失败,代理需预备人工回退
  • 邮寄延误:USPS/FedEx/UPS服务层级差异,Certified Mail无法保证送达时间,法律截止日需预留缓冲
  • 内容敏感:代理自动处理含PII的税务/法律邮件,需确保存储加密、访问日志合规(SOC 2/ISO 27001状态未披露)
  • Beta功能依赖:实体邮箱地址的API合约、定价(计划$10/月)、地理扩展存在变更风险,生产部署需签SLA

---

来源:官方仓库与API文档,版本5.1.5

安全解读

核心用法

mailbox.bot 是一款专为AI代理设计的实体邮件API服务,通过REST API、MCP协议、A2A协议和OpenClaw多种方式接入。核心功能分为两大工作流:

1. 外发邮件API(已上线)
代理可通过POST /v1/mail提交PDF、DOCX等文档,由设施完成打印、装封、贴邮票和邮寄,并提供拍照证明。支持USPS First Class、Certified Mail(含回执)、Priority,以及FedEx、UPS等多种邮寄等级。批量邮寄支持CSV上传,单次最高10,000件。

2. 入站邮件上下文API(已上线)
通过forward.mailbox.bot提供的私有转发别名,运营商可将现有地址的扫描件、照片、PDF等数字化内容导入系统。代理可读取提取的上下文(OCR文本、分类标签),并起草关联的实体回复邮件,保持同一邮政线程的连贯性。

3. 实体邮箱地址(即将内测)
南加州、犹他州、内华达州将逐步开放真实的街道地址+邮箱号码,支持自动拍照、按需扫描内容、OCR分类,并通过MCP/API/webhook通知代理进行决策。

显著优点

  • 填补数字-物理鸿沟:代理可处理法律通知、IRS税务函件、LLC注册文件、房地产合规邮件等必须纸质化的场景
  • 多协议支持:MCP(29个工具)、A2A(10个技能)、REST API、OpenClaw Agent Card,适配各类Agent架构
  • 企业级安全:HTTPS/TLS 1.3传输、HMAC签名Webhook、API Key分级(成员密钥/代理密钥/沙箱密钥)、成本上限控制(X-Max-Cost-Cents)
  • 沙箱测试环境sk_agent_test_前缀密钥可在生产端点零费用测试,支持生命周期模拟和成本预览
  • 自动化规则引擎:通过MAILBOX.md文件配置站立指令,实现"法律通知→扫描+邮件提醒"、"垃圾邮件→丢弃"等自动分流
  • 人工介入机制requires_approval=true参数可在关键步骤暂停,等待人工审批

潜在缺点与局限性

  • 地域限制:实体邮箱地址目前仅规划南加州、犹他州、内华达州,其他地区需等待扩展
  • 注册门槛高:需真实美国实体手机号(拒绝VoIP/ burner号码)、信用卡(拒绝预付卡/礼品卡),并完成KYC身份验证
  • 成本累积:First Class起步$1.00/页,Certified Mail $8.98起,彩色打印+$0.25/页,批量使用需关注预算
  • 第三方依赖:完全依赖mailbox.bot商业服务的持续运营和API稳定性,存在供应商锁定风险
  • 隐私合规复杂:实体邮件处理涉及真实地址、法律文书等敏感信息,需仔细评估是否符合GDPR/CCPA等法规要求
  • 无本地执行:纯文档型Skill,所有功能必须联网调用外部API,离线不可用

适合的目标群体

  • 法律科技团队:处理法院传票、合规通知、合同往来等必须纸质认证的场景
  • 财税自动化代理:IRS通知自动扫描分类、税务回函自动生成邮寄
  • 房地产运营管理:多物业分散的合规函件、租约续签、违规通知的统一管理
  • 企业秘书服务:LLC注册、商业登记、实体邮件地址托管的自动化替代
  • 批量通信场景:批量账单、公告、营销邮件的实体化发送(需符合邮寄法规)

常规使用风险

  • 成本超支风险:未设置X-Max-Cost-Cents或每日上限可能导致意外高额账单
  • 数据滞留风险:实体邮件扫描件、OCR文本等存储于第三方服务器,需确认数据保留和删除政策
  • Webhook可靠性:HMAC签名Webhook若未正确验证,可能导致状态同步失败或重放攻击
  • 服务条款变更:商业服务的价格、功能、地域覆盖可能调整,需定期审查
  • 批准流程阻塞:人工介入节点若未及时响应,可能延误法律时效性要求高的邮件处理
  • 测试/生产混淆:沙箱密钥与生产密钥前缀相似(sk_agent_test_ vs sk_agent_),配置错误可能导致意外费用

mailbox.bot 内容

手动下载zip · 17.6 kB
CHANGELOG.mdtext/markdown
请选择文件