Clawmail 是 joelclaw 的规范智能体协调契约，也是 pi 智能体唯一受支持的邮件访问入口。资料明确要求不要从智能体提示或角色指令中直接调用 mcp_agent_mail 的 HTTP 端点。
用途：在多智能体共享编辑同一仓库时，通过邮件式协调避免冲突，包括检查收件箱、通告工作范围、预留文件路径、续租、释放锁以及发送状态与交接更新。
主要能力：规范接口为 joelclaw mail ...（CLI）。允许使用 pi 包装工具，但它们底层仍调用 CLI，包括 mail_send、mail_inbox、mail_read、mail_reserve、mail_release、mail_status，分别对应 joelclaw mail send/inbox/read/reserve/release/status。主题前缀约定为 Starting:、Task:、Status:、Blocked:、Done:，便于搜索与日常引导。
使用方式：默认协议流程为先检查收件箱 joelclaw mail inbox --agent <AgentName> --unread；再通告范围 joelclaw mail send --from <AgentName> --to <AgentName|team> --subject "Starting: <work>" "intent + paths + expected output"；编辑前预留路径 joelclaw mail reserve --agent <AgentName> --paths "path/a.ts,path/b.ts" [--ttl-seconds 900]；长时间工作可续租 joelclaw mail renew --agent <AgentName> --paths "path/a.ts" [--extend-seconds 900]；提交或交接后释放 joelclaw mail release --agent <AgentName> --paths "..." 或 --all。其他命令包括 status、register、read、locks、search。
拓扑与限制：agent-mail 是中心服务，Flagg 在 127.0.0.1:8765 托管权威守护进程，Blaine 和 Panda 通过 com.joelclaw.agent-mail-tunnel 经 SSH 转发本地 127.0.0.1:8765 到 Flagg。卫星/中继客户端使用默认本地 URL，不得在卫星上启动独立 agent-mail 守护进程。可靠性方面，若包装输出 ok: true 但嵌套结果含错误，应视为失败；搜索降级时信号计数不可靠但仍应继续协议；CLI 标志被拒可能因 ~/.bun/bin/joelclaw 过期，需从 packages/cli/src/cli.ts 重建。资料未提供收费、价格或平台信息。