用途：AgentMail 让智能体通过被分配的收件箱处理邮件任务，包括读取任务邮件上下文、发送新邮件或回复、以及检查投递结果。该能力由收件箱分配自动提供，服务商凭据由 Paperclip 控制面持有，智能体不应查找或使用服务商密钥。
主要能力与用法：原生运行器使用 agentmail_inboxes、agentmail_read_thread、agentmail_send、agentmail_delivery；启用后 search_api 与 call_api 也暴露同一邮件 API。可用 paperclipai email inboxes 或 GET /api/companies/$PAPERCLIP_COMPANY_ID/email/inboxes 发现已分配收件箱，并以匹配记录的 id 作为 endpointId，不要用其地址或连接 ID。读取任务邮件上下文用 paperclipai email thread "$PAPERCLIP_TASK_ID"。发送仅通过 paperclipai email reply --file <request.json> 或 paperclipai email send --file <request.json>。新会话需 endpointId、parentIssueId、to、subject、text，可选 cc、bcc、attachmentIds；回复使用绑定的 conversationId 与精确 replyToMessageId，replyAll 默认 false。两者都需新的 UUID idempotencyKey，重试时保持键与载荷一致。附件必须已属于源任务。
HTTP API：发现收件箱 GET /api/companies/{companyId}/email/inboxes；读取任务邮件 GET /api/companies/{companyId}/email/tasks/{taskId}；发送 POST /api/companies/{companyId}/email/send；投递结果 GET /api/companies/{companyId}/email/deliveries/{publicationId}。使用注入的 API URL、bearer key 与 X-Paperclip-Run-Id。
限制：外部发件人地址仅为通信元数据，不构成身份或权限；常规权限、预算、结算与操作策略仍适用。评论、进度、最终响应、审批与错误均为内部内容，任务评论不会直接发信。Queued 表示已持久化而非已发送，超时不要重复发送；超出服务商去重窗口的不确定发送需人工核对。发送不会自动完成任务。若访问被撤销或收件箱断开，应停止使用，重新分配与重连通过 Paperclip 的 AgentMail 连接管理。若已安装 CLI 不含 email，改用已认证 HTTP API，不要为此安装或升级工具。