邮件简报摘要

使用此技能发送过去 1 天内收到的简报类邮件的汇总内容。

每次调用时，均需在开始时读取 settings.json。有关配置结构及维护者说明，请参阅 REFERENCE.md。

适用场景

当用户希望执行以下操作时，可使用此技能：

• 发送简报摘要邮件
• 将简报摘要发送给多人
• 每日早晨或按其他周期定时发送摘要
• 更新哪些标签被视为简报类邮件
• 更新哪些发件人被视为简报类邮件
• 更新摘要邮件的接收人列表

配置项

每次调用开始时均需读取 settings.json。

该配置文件包含以下字段：

• newsletter_labels_csv
• newsletter_senders_csv
• digest_recipient_emails_csv
• recipient_delivery_mode

规则如下：

• 若 newsletter_senders_csv 已配置，则 newsletter_labels_csv 可为空或 null
• 若 newsletter_labels_csv 已配置，则 newsletter_senders_csv 可为空或 null
• 两者不可同时为空或 null
• 若两者均被配置，则 Gmail 搜索需对两组条件采用 OR 语义进行合并
• digest_recipient_emails_csv 可包含一个或多个以英文逗号分隔的邮箱地址
• recipient_delivery_mode 控制向多个收件人发送邮件的方式
• 支持的取值：
  • individual：为每位收件人单独发送一封邮件
  • group：将所有收件人填入 To 字段，仅发送一封邮件
• 若未指定 recipient_delivery_mode，则默认使用 group

智能体工作流程

1. 立即发送一条简短确认消息，例如：“我正在准备邮件简报摘要。”
2. 读取 settings.json。
3. 校验至少配置了一个简报筛选条件（标签或发件人），且至少配置了一个接收人邮箱。
4. 以阻塞方式执行打包好的脚本：~/.openclaw/skills/email-newsletter-digest/scripts/newsletter-digest.py，并设置充足的超时时间，以便等待其标准输出结果。请勿将其后台运行，也不得依赖后续轮询机制来完成该技能。
5. 对每封匹配的简报邮件生成摘要，构建完整摘要内容，并按配置的 recipient_delivery_mode 发送。
6. 运行完成后，发送一条简短完成消息，明确列出收件人及所含简报数量。

若用户要求更新标签、发件人、收件人或收件人投递模式：

• 编辑 settings.json
• 保持逗号分隔格式
• 移除重复项与空条目

若用户要求设置定时任务：

• 使用 OpenClaw 自带的调度机制或系统 cron
• 不得要求用户提供 shell 命令
• 若用户仅说明“每天早晨”而未指定具体时间，则使用系统时区下合理的早晨时间（如 08:00）

核心规则

• 使用 gog gmail messages search 获取单封简报邮件。
• 优先使用 gog gmail thread get --full 提取正文内容。
• 若提取到的正文类似占位符（placeholder），则回退至 gog gmail get --json 并从中选取最优 MIME 部分进行提取。
• 使用 summarize 将每封简报转化为要点式摘要（bullet points）。
• 除非用户明确指定其他摘要模型，否则由 summarize 使用其自身已配置或默认的模型。
• 依据 Gmail message id 去重，确保每封简报在单次运行中仅被摘要一次。
• 仅包含过去 1 天内收到的匹配邮件。
• 若未找到任何简报邮件，应明确告知用户，且不发送任何邮件。
• 若整个运行失败，或全部摘要均失败，则应向已配置的收件人发送失败通知邮件，并尽可能附上可能的原因。
• 若仅部分简报摘要失败，仍应正常发送摘要邮件，并额外发送一封警告邮件说明失败详情。
• 始终以自然语言交互为先。切勿指导用户自行运行 Python 或 shell 命令。

查询构造

根据 settings.json 中的配置构造 Gmail 搜索查询：

• 仅使用标签：
  • label:Newsletters newer_than:1d
• 仅使用发件人：
  • (from:a@example.com OR from:b@example.com) newer_than:1d
• 标签与发件人均已配置：
  • (label:Newsletters OR label:finance OR from:a@example.com OR from:b@example.com) newer_than:1d

反馈规范

• 开始处理前，必须首先确认用户请求。
• 成功运行后，须说明摘要邮件已发送给哪些收件人，以及共包含多少封简报。
• 针对配置变更，需准确说明具体修改内容。
• 针对定时任务，需以自然语言明确确认执行周期（如“每天上午 8 点”）。
• 若 gog 或 summarize 执行出错，必须将错误信息直接呈现给用户，不得隐藏。
• 严禁静默失败。若摘要邮件无法发送，必须清晰、直白地告知用户具体原因。