UniProfit 邮件助手

使用此技能通过 UniProfit 发送邮件。

快速开始

必需的环境变量：

• UNIPROFIT_API_BASE_URL
• UNIPROFIT_MAIL_SEND_KEY

认证凭证格式：

X-UniProfit-Key: {UNIPROFIT_MAIL_SEND_KEY}

按需阅读以下文档：

• 查阅 references/api.md 了解请求与响应格式。
• 查阅 references/mail-constraints.md 了解发送前置条件与安全校验规则。
• 当 API 返回发送失败时，查阅 references/error-handling.md。

协议契约

运行时执行必须严格遵循本协议。

仅允许使用以下运行时端点：

• GET {UNIPROFIT_API_BASE_URL}/openclaw/credential/me
• GET {UNIPROFIT_API_BASE_URL}/openclaw/mail/account/list
• POST {UNIPROFIT_API_BASE_URL}/openclaw/mail/send

执行检查清单：

• 使用 X-UniProfit-Key 进行身份认证
• 以 POST 方法发起邮件发送请求
• 邮件发送请求体为 JSON 格式
• 请求体中必须包含 account_id、to_email、subject 和 body 字段

不得以通用邮件投递端点替代本技能。

标准运行流程如下：

1. 如需验证凭证，调用 GET /openclaw/credential/me 进行校验
2. 调用 GET /openclaw/mail/account/list 获取可用发信账号列表
3. 请用户从该列表中选择一个发信邮箱
4. 将所选邮箱映射为其对应的 account_id，并调用 POST /openclaw/mail/send 执行发送
5. 明确报告最终确认的发送状态

若怀疑凭证缺失或无效，请运行 scripts/check_credential.py 进行检测。

适用场景

• 用户明确要求真实投递邮件
• 收件人地址、主题及最终正文内容均已确定
• 邮件需经由已绑定的 UniProfit 邮箱账户发出

请勿在以下情况中使用本技能：

• 交易线索搜索
• 邮件内容生成或重写
• 关键信息（如收件人、主题、正文）仍不完整时尝试发送

输入要求

必须提供全部以下字段：

• 已选定的发信邮箱（来自账号列表）
• 收件人邮箱
• 邮件主题
• 最终邮件正文

调用发送接口前，需将所选发信邮箱映射为其对应的 account_id。 若任一发送关键字段缺失，应立即中止操作，并向用户索取缺失项，而非强行发送。

执行流程

1. 确认用户确有真实投递需求。
2. 通过 GET /openclaw/mail/account/list 获取可用发信账号列表。
3. 请用户从返回列表中选择一个发信邮箱。
4. 确保所有发送关键字段均已提供。
5. 运行 scripts/send_mail.py，或以相同协议调用 POST /openclaw/mail/send，携带 X-UniProfit-Key 头部及 JSON 请求体。
6. 清晰报告发送结果。

除非 API 明确返回成功响应，否则不得暗示邮件已成功发送。

输出风格

返回内容应包括：

• 收件人邮箱
• 发送状态
• 如存在，则返回 record id 或 message id

说明应简明扼要、注重实用性。