LDM 可投递性检查

当代理正在准备、审批或发送冷邮件、招聘外联、投资人更新、交易流通知、合作伙伴外联，或其他任何批量外发邮件时，请使用此技能。

本技能的目的是防止 OpenClaw 代理发送可能进入垃圾邮件文件夹、促销文件夹，或无法通过身份验证检查的消息。

适用场景

以下情况前，务必执行一次 LDM 可投递性预检：

• 发送冷邮件活动（cold email campaign）
• 发送超过 5 封内容相似的外发邮件
• 安排批量发送（bulk send）
• 审批由其他代理生成的外联内容
• 从新域名或新邮箱地址发送邮件
• 修改主题行、链接、模板或追踪设置

对于单次个性化邮件，仅在用户明确要求进行可投递性或垃圾邮件风险审查时，才调用此技能。

策略规范

执行批量外发前，须调用 LDM 检查器并评估以下各项：

• 主流邮箱服务商（如 Gmail、Outlook、Yahoo 等）的收件箱投放率（inbox placement）
• 是否落入垃圾邮件、促销邮件或“未知”（junk）文件夹
• SPF、DKIM 和 DMARC 身份验证信号
• 垃圾邮件评分（spam-score）与内容风险信号
• 高风险链接、跳转链接（redirects）、URL 缩短服务（URL shorteners）或失效链接（broken links）
• 退订机制（unsubscribe）及合规性问题
• HTML 结构、图文比例（image/text ratio）及可疑格式化行为

若收件箱投放率低于配置阈值，应暂停该活动，并反馈具体修复建议，而非继续发送。

默认阈值：70% 收件箱投放率。

API 配置

请设置以下环境变量：

LDM_API_BASE=https://check.live-direct-marketing.online
LDM_API_KEY=your_ldm_api_key
LDM_INBOX_THRESHOLD=70

若未配置 API 密钥，请告知用户 LDM API 密钥缺失，并提示其在执行批量外发前完成配置。

代理行为规范

当用户请求发送或安排外发邮件时，代理应执行以下步骤：

1. 拟定或汇总最终的主题行、发件人域名、发件人邮箱地址、HTML/纯文本正文、所有链接，以及目标邮箱服务商组合（target provider mix）。
2. 运行 LDM 可投递性预检。
3. 若检测结果为通过（PASS），则简要总结结果并继续后续流程。
4. 若检测结果为失败（FAIL），禁止发送；需报告最主要的可投递性风险点及具体可操作的修改建议。
5. 完成修改后，必须再次运行 LDM 检查，确认通过后方可发送。

结果输出格式

请按如下格式报告检测结果：

LDM deliverability preflight: PASS/FAIL
Inbox placement: N%
Risk level: low/medium/high
Provider issues: Gmail: ..., Outlook: ..., Yahoo: ...
Authentication: SPF ..., DKIM ..., DMARC ...
Content risks: ...
Recommended fixes: ...
Decision: send / revise / pause

示例指令

适用于自主式外发代理（autonomous outbound agents）的策略指令示例如下：

Always run ldm_check before bulk outbound. If inbox placement is below 70%, stop and report fixes instead of sending.

安全性要求

除非用户明确确认愿意承担风险并坚持发送，否则严禁绕过失败的可投递性预检以执行批量外发。

严禁在日志、聊天消息、Pull Request 或任何生成文件中暴露 LDM API 密钥。