Daily Briefing

核心用法

daily-briefing 采用系统技能编排模式运行：代理通过调用封装脚本收集本地数据（日历、提醒、联系人、邮件），自主获取天气信息，经语义分析筛选重要邮件后，生成一份紧凑温暖的每日简报。支持交互式配置与无人值守的cron模式两种运行方式。

执行流程

1. 模式检测：交互模式下缺失关键信息时主动询问；cron模式下静默使用默认值
2. 数据收集：调用 run_daily_briefing.sh 脚本聚合iCloud/Google日历、Apple提醒事项、联系人及邮件数据
3. 天气获取：代理直接使用 curl 请求 wttr.in API，按用户偏好单位（C/F）解析温度、降水概率
4. 邮件智能筛选：基于语义分析识别订单物流、交易提醒、安全警报、订阅续费等高优先级邮件，过滤营销广告与批量招聘邮件
5. 简报生成：严格遵循输出契约，按固定格式组合问候语、天气、生日、日程、提醒、重要邮件及每日寄语

显著优点

• 零配置即可运行：内置容错机制，缺少可选依赖或数据时优雅降级，从不中断
• 隐私优先设计：邮件分析完全本地执行，无需外部API；iCloud邮件使用应用专属密码，不存储主密码
• cron原生友好：非交互模式下无弹窗、无文件修改、无后台任务，stdout直接可用
• 情感化设计：语调温暖克制，避免生产力焦虑，如"Take things one step at a time today—you've got this"

潜在缺点与局限

• 平台锁定：仅支持macOS，依赖Apple生态（提醒事项、通讯录、iCloud日历）
• 邮件安全权衡：iCloud需要应用专属密码明文存储于配置文件，虽有隔离但仍存泄露风险
• 天气可靠性：wttr.in为免费服务，存在速率限制与偶发不可用情况
• 语义分析局限：邮件重要性判断依赖代理能力，复杂场景可能出现误判
• 扩展性受限：数据源固定为Google/iCloud，不支持Exchange或其他企业日历

适合人群

• macOS重度用户，深度整合Apple reminders/calendar/contacts生态
• 追求晨间仪式感的远程工作者与自由职业者
• 需要自动化每日概览推送的技术用户（配合cron/快捷指令）
• 对邮件噪音敏感、希望AI辅助筛选优先事项的效率追求者

常规风险

• TCC权限：首次运行需授予终端/调用进程访问日历、提醒事项、通讯录的权限
• 配置文件安全：~/.openclaw/openclaw.json 包含邮件密码，需确保文件权限为600
• 网络依赖：天气与部分邮件服务（Gmail API）需外网连接
• 数据残留：/tmp/daily_briefing_data.json 含当日完整生活数据，多用户系统需注意清理

核心功能

daily-briefing 是一款专为 macOS 设计的系统级晨间简报技能，采用「Orchestrator 模式」——通过本地脚本安全聚合多源数据，再由 AI 生成温暖、简洁的每日摘要。

数据整合能力

• 天气: 调用 wttr.in 服务获取实时天气与预报，自动选择当前温度或最高温度，附带降水概率提醒
• 日历: 支持 Google Calendar（gog）与 iCloud Calendar（icalpal）双源聚合，可配置前瞻天数
• 提醒事项: 集成 Apple Reminders，支持今日到期与逾期提醒筛选
• 生日提醒: 从通讯录与 Google Contacts 提取，支持 14 天前瞻预警
• 重要邮件: 可选启用 AI 语义分析，自动筛选订单物流、交易通知、安全提醒等 actionable 邮件，排除营销噪音

输出特性

• 严格遵循格式合约：首行必须包含时段化问候语（Good morning/afternoon/evening/night）与天气句子
• Telegram 友好排版：短行、宽松间距、emoji 分区，目标 5-15 行
• 「温柔礼物」语调：平静、慈悲、无压迫感，告别 productivity anxiety

执行模式

• 交互模式: 缺失配置时友好询问，支持功能开关向导
• Cron 模式: 零交互、零文件修改、零后台任务，安全自动化

显著优点

| 维度 | 亮点 |

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

| **隐私优先** | 全部数据处理本地完成，邮件语义分析不调用外部 API；TCC 权限框架下用户完全可控 |

| **渐进可用** | 仅需 `curl` + `bash` 即可运行核心功能，日历/邮件等高级功能按需安装 |

| **配置灵活** | JSON 配置热更新，每项数据源独立开关，lookahead、筛选条件细粒度可调 |

| **容错设计** | 任一数据源失败不阻断整体流程，优雅降级（如天气失效显示「I can't access weather right now」） |

| **开源可信** | ClawHub 官方维护，MIT 协议，代码透明，社区信誉良好（T2 来源可信度） |

局限性与注意事项

平台绑定

• 仅限 macOS（依赖 osascript、Apple Reminders、Contacts.app 等系统服务）
• iCloud Mail 需用户手动生成应用专用密码，配置体验待优化

邮件分析边界

• 语义分析依赖本地 AI，复杂语境可能出现误判
• 营销邮件过滤规则需持续迭代（当前已排除 LinkedIn Job Alert、批量招聘、产品更新等噪音）

安全建议

• 配置文件中的 emails.icloudPassword 当前为明文存储，建议改用 macOS Keychain
• 临时文件 /tmp/daily_briefing_data.json 虽采用原子写入，共享系统环境建议关注权限

适合人群

• 效率极简主义者: 希望每日信息一站式获取，拒绝打开 5 个 app
• 隐私敏感用户: 不愿将日历、邮件数据上传至第三方 SaaS
• 自动化爱好者: 希望通过 cron 在指定时间（如 7:00 AM）接收 Telegram/终端推送
• macOS 生态深度用户: 已广泛使用 Apple Reminders、iCloud、Google 服务

常规风险

| 风险项 | 等级 | 说明 |

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

| 敏感数据访问 | 低 | 联系人、日历、邮件需 TCC 授权，用户可控 |

| 凭证明文存储 | 低 | iCloud 密码建议迁移至 Keychain |

| 临时文件泄露 | 信息级 | 原子写入已缓解，建议 `--cleanup` 定期清理 |

| 天气服务依赖 | 低 | wttr.in 为知名开源服务，HTTPS 加密，无隐私数据上传 |