核心用法
Agent Mailbox Skill 是一个专为智能体经济设计的去中心化消息系统，支持 Agent 与 Agent、Handler 与 Agent、Handler 与 Handler 之间的异步通信。安装后通过 CLI 命令（openclaw mail check/read/send）或 TypeScript API 即可实现消息收发。系统采用文件队列机制，消息默认以 Markdown/YAML 格式存储于本地 ~/.openclaw/workspace/mailbox/ 目录，无需后端服务器即可运行。用户可通过 Mailbox 类实例化邮箱对象，调用 send()、getUnread()、reply()、archive() 等方法完成完整的消息生命周期管理。
显著优点
极致隐私安全：本地优先架构是最大亮点——消息默认仅存于用户机器，不上传任何第三方服务器，配合零运行时依赖设计，从根本上消除数据泄露风险。零运维成本：无需数据库、无需云服务、无需 API 密钥即可启动，大幅降低基础设施门槛。灵活扩展：可选云同步配置允许用户自主对接私有后端，避免供应商锁定。消息支持优先级标记（normal/high/urgent）、过期时间、元数据嵌入等丰富字段，适配任务委托、赏金协调、团队协作等复杂场景。生态兼容：与 OpenClaw 框架深度集成，可通过 cron 定时任务实现心跳轮询，自动处理高优先级消息。
潜在缺点与局限性
网络协同受限：纯本地存储导致多设备同步依赖手动配置或额外开发，跨机器通信需依赖可选的云同步功能。检索能力有限：当前版本仅支持基础文件名搜索，缺乏全文索引、标签分类、智能筛选等高级功能。消息可靠性：本地文件存储在系统崩溃时可能损坏，无内置消息持久化备份机制。生态成熟度：作为 MVP 版本，广播（一对多）、消息加密、Webhook 回调等功能尚在路线图，暂不满足企业级高并发场景需求。
适合的目标群体
多智能体开发者：需要构建 Agent 协作网络、实现任务分发与结果聚合的技术团队。隐私敏感用户：对数据主权有严格要求，拒绝将通信内容托管于中心化云服务的个人或组织。原型验证场景：快速搭建无需后端的消息工作流，验证 Agent 经济模型的可行性。去中心化信仰者：认同"bottom-up"构建理念，希望自主控制基础设施的极客与研究者。
使用风险
供应链安全：尽管当前零运行时依赖，若未来版本引入第三方包需重新审计。T3 来源可信度：个人开发者维护，长期更新稳定性存疑，建议生产环境使用前进行额外代码审查。Webhook 配置风险：示例代码中的回调功能若配置不当，可能导致数据发送至未经验证的端点。性能瓶颈：高频消息场景下文件 I/O 可能成为瓶颈，缺乏分布式队列的横向扩展能力。数据丢失：本地存储无自动备份，用户需自行实现容灾策略。