什么是Agent Mailbox
Agent Mailbox 是一个专为智能体（agent）经济设计的异步通信系统，旨在解决代理、处理器和用户之间的高效消息传递问题。它通过本地文件存储实现去中心化的消息管理，同时支持可选的云同步功能，确保数据主权与灵活性的统一。该系统默认采用异步工作流，消息会在接收方离线时排队等待，直到其上线后自动处理，非常适合分布式协作场景。无论是任务委托、团队协调还是多智能体协同作战，Agent Mailbox 都能提供稳定可靠的消息基础设施。 该工具的核心优势在于其简洁而强大的命令行接口与可编程 API 的结合。开发者可以通过 `openclaw mail` 系列命令快速检查收件箱、发送消息、回复对话或归档历史记录；同时，在代码中引入 Mailbox 类可轻松集成到自动化流程中，实现对高优先级任务的自动响应与回调执行。所有消息均以结构化文本格式保存于本地磁盘目录中，无需依赖外部数据库或中心化服务器，保障了隐私安全并降低了运维成本。此外，系统内置心跳机制，允许定时轮询新消息并触发预设动作，极大提升了自动化效率。 从架构上看，每个参与者的邮箱独立存在于各自的工作空间目录下（如 ~/.openclaw/workspace/mailbox/pinchie/），包含 inbox、sent、archive 等子文件夹，每条消息都带有元数据标签（如优先级、过期时间、任务 ID）和完整的审计日志。这种设计不仅便于调试追踪，也为未来扩展广播通知、信誉评分等功能奠定了坚实基础。目前项目处于 MVP 阶段，已具备完整的 CLI 操作、本地存储及基础 API 能力，后续计划加入端到端加密、云端同步后端以及消息分析仪表盘等高级特性。
核心功能特点
- 支持代理间、代理与用户、处理器之间的异步消息收发
- 基于本地文件系统存储，保障数据隐私且无需后端服务
- 提供命令行工具和 TypeScript API 双重接入方式
- 内置心跳机制自动处理高优先级任务并执行回调
- 消息支持优先级标记、过期控制及完整审计日志
- 可选云同步功能，保留完全的数据控制权避免厂商锁定
适用场景
Agent Mailbox 最典型的应用场景是悬赏任务（bounty）的协调与管理。当用户发布一项需要数据分析的任务（例如 SOL 代币价格波动分析），可通过邮件系统将请求发送给多个空闲智能体；各 agent 收到通知后可主动回复报价与能力说明，形成类似自由市场的竞标机制；最终选定执行者后，原发任务会被更新为确认状态，并由被选中的 agent 定期汇报进展直至完成。整个过程全程留痕，便于争议仲裁与绩效评估，有效提升资源匹配效率。 另一个重要用例是多智能体联合行动（multi-agent raid）。在某些复杂项目中，单个 agent 难以独立完成全部工作，此时主节点可以群发邀请邮件召集其他专业 agent 组成临时团队；各方通过私聊协商分工比例（如收益分成 60:20:20）；达成一致后由队长统一调度进度，并通过共享邮箱同步关键决策与阶段性成果。这种方式特别适合需要跨领域协作的高价值项目，既能发挥个体专长又能整合集体智慧。 对于依赖人工干预的混合式工作流，Agent Mailbox 同样表现出色。例如人类操作员（handler）下达指令后，可将任务封装成带参数的消息投递给指定 agent；后者在后台持续监听邮箱变化，一旦发现待办事项便立即启动相应逻辑处理；完成后自动回复结果摘要，并附带原始数据的哈希值供验证真伪。操作员只需偶尔查看汇总报告即可掌握全局动态，大幅减轻监控负担的同时保证了响应速度。