morning-email-rollup

核心用法

Morning Email Rollup 是一款自动化晨间信息聚合工具，专为需要高效处理大量邮件和日程的职场人士设计。该技能每日定时（默认早8点）执行以下流程：首先通过 gog CLI 查询 Google Calendar 获取当日日程，同时搜索 Gmail 中标记为重要或星标的近24小时邮件；随后利用 Google Gemini AI（gemini-2.0-flash 模型）为每封邮件生成一句话自然语言摘要；最终将日历事件与邮件摘要格式化为易读的 Telegram 消息，包含红绿圆点标识已读/未读状态。

用户可通过环境变量 GOG_ACCOUNT 配置 Gmail 账户，支持手动运行或设置 cron 定时任务。默认展示10封邮件，可通过 MAX_EMAILS 参数调整数量，搜索条件、摘要风格、AI 模型均可自定义修改。

显著优点

1. AI 驱动的智能摘要：不同于简单的内容截取，Gemini 生成的摘要具备语义理解能力，能提炼邮件核心意图，大幅降低信息过载。

2. 多源信息整合：首创性地将邮件与日历事件统一呈现，帮助用户在单一界面掌握当日待办与通信重点，避免多应用切换。

3. 优雅的降级机制：当 gog 未安装、日历无事件或 Gemini 不可用时，系统静默跳过对应模块而非报错，确保核心功能可用性。

4. 高度可定制：从搜索语法（支持 Gmail 高级搜索操作符）、摘要长度到 cron 时区，几乎每个环节都开放给用户调整。

5. 安全编码实践：使用 mktemp 管理临时文件、正则验证邮件 ID、限制输入长度、完善的错误处理，体现良好的 Shell 脚本工程素养。

潜在缺点与局限性

1. Google 生态依赖：必须使用 Gmail 和 Google Calendar，对使用 Outlook、企业自建邮箱或注重隐私替代方案的用户不适用。

2. AI 摘要的隐私权衡：邮件内容需发送至 Google Gemini API 处理，虽经匿名化处理但仍存在数据出境风险，金融、医疗等敏感行业需谨慎评估。

3. Telegram 推送限制：输出渠道绑定 Telegram，若用户偏好邮件、Slack 或企业微信等其他平台，需自行修改脚本适配。

4. 重要性判断依赖 Gmail 算法："重要"标签由 Gmail 自动判定，可能存在误判或漏判，需用户手动星标补充。

5. 无多账户支持：当前仅支持单一 Google 账户，职场人士常用的多邮箱（工作+个人）场景需部署多个实例。

适合的目标群体

• 高管与管理者：需快速掌握团队动态和会议安排，无时间逐封阅读邮件
• 销售与客户成功：跟进大量客户沟通，需识别高优先级商机邮件
• 远程工作者：跨时区协作导致邮件堆积，需晨间快速同步状态
• 效率工具爱好者：追求 Inbox Zero 理念，希望自动化信息筛选流程
• Google Workspace 重度用户：已深度使用 Gmail、Calendar 生态，寻求增强体验

使用风险

• API 配额与成本：Gemini API 存在调用限制，超量可能产生费用或降级为无摘要模式
• 依赖项维护：gog 和 gemini CLI 工具需独立安装更新，版本不兼容可能导致功能异常
• 时区配置错误：cron 时区设置不当会导致推送时间错位，影响晨间使用习惯
• OAuth 令牌失效：Google 账户认证过期后需重新授权，期间服务中断
• 日志文件膨胀：长期运行后 $HOME/clawd/morning-email-rollup-log.md 可能累积过大，建议定期清理

核心用法

Morning Email Rollup 是一个自动化每日信息汇总工具，专为需要高效管理邮件和日程的用户设计。它每天上午8点（可自定义时区）自动执行以下任务：

1. 日历同步：通过 gog CLI 获取当日 Google Calendar 事件，支持12小时制时间显示
2. 邮件筛选：智能搜索过去24小时内标记为"重要"或"星标"的 Gmail 邮件
3. AI 摘要：调用 Google Gemini 2.0 Flash 模型为每封邮件生成一句话自然语言摘要
4. 状态标记：用 🔴/🟢 标识未读/已读状态，一目了然
5. 推送交付：格式化后通过 Telegram 发送完整日报

基础配置：仅需设置 GOG_ACCOUNT 环境变量，即可绑定 Gmail/Google Calendar 账号。

显著优点

• 零配置启动：依赖系统标准工具（gog, gemini, jq），无额外包管理负担
• 智能优先级：基于 Gmail 原生"重要"算法，自动过滤噪音邮件
• 自然语言摘要：非简单的内容截取，而是真正的语义理解总结
• 容错设计：gog 未安装时优雅跳过日历模块，Gemini 不可用时回退到清理后的正文
• 完全可定制：邮件数量、搜索条件、摘要风格、AI 模型均可调整
• T2 可信来源：由 clawdbot 组织维护，代码开源可审计

潜在缺点与局限性

• Google 生态锁定：必须使用 Gmail 和 Google Calendar，不支持 Outlook/Exchange
• 隐私权衡：邮件内容需发送至 Gemini API 处理，虽为 Google 官方服务，但涉及数据出境
• 外部命令依赖：gog 和 gemini CLI 需单独安装认证，首次配置有一定门槛
• 无本地 AI：摘要依赖云端 Gemini，离线环境无法工作
• 字符截断：邮件正文限制5000字符，超长邮件可能丢失上下文
• 时区固定：默认 Denver 时间，需手动修改 cron 配置

适合人群

• 高频邮件用户：日均收件50+，需要快速筛选重点
• 远程工作者：跨时区协作，需早间快速同步日程
• 效率工具爱好者：追求自动化、厌恶手动查邮件
• Telegram 重度用户：习惯通过即时通讯接收通知
• 隐私接受度中等：信任 Google 生态，愿用 AI 换效率

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 外部命令注入 | 低 | 通过 PATH 解析命令，建议受控环境运行 |

| 敏感数据暴露 | 低 | 邮件内容发送至 Google Gemini，属功能必需 |

| 临时文件安全 | 可忽略 | 使用 `mktemp` 生成安全随机路径 |

| API 依赖 | 中 | Gmail/Calendar/Gemini 任一失效则功能降级 |

| 日志权限 | 低 | 日志写入 `$HOME/clawd/`，建议检查目录权限 |

总体评估：Grade A（75分），标准安全级别，功能与声明一致，适合生产环境使用。建议关注输入验证和明确告知用户数据流向。