Daily Briefing

核心用法

daily-briefing 采用 Orchestrator 系统技能模式：先调用本地脚本聚合数据（日历、提醒、联系人、邮件），再由 AI 生成温暖简洁的每日简报。用户可通过交互式配置或 ~/.openclaw/openclaw.json 自定义天气位置、温度单位、各模块开关及邮件筛选规则。支持 cron 自动化（静默输出）与 交互式聊天（引导配置）双模式。

显著优点

• 情感化设计：语调温暖克制，无 productivity pressure，以"gentle gift for the day"为核心理念
• 模块化可插拔：生日/日历/提醒/邮件四模块独立开关，依赖工具（gog/icalpal/himalaya）按需安装
• 智能邮件过滤：AI 语义分析识别真正需要关注的事务性邮件（物流、交易、安全警报），自动过滤营销与招聘垃圾邮件
• 故障容错极强：任意数据源缺失时优雅降级，始终保证输出完整简报
• 原生 macOS 集成：深度对接 Apple 生态（Contacts、Calendar、Reminders、iCloud Mail）

潜在局限

• 平台锁定：仅支持 macOS（依赖 Apple 私有框架 TCC 权限），Linux/Windows 用户无法使用
• 外部依赖较重：完整功能需额外安装 3 个 Homebrew 工具，初次配置门槛不低
• 隐私权衡：邮件分析需开启云端 AI 处理，敏感场景需谨慎；iCloud 邮箱强制要求应用专用密码
• 天气单点故障：wttr.in 服务不稳定时可能降级为"无法获取天气"
• 无历史记忆：每次独立运行，无法跨会话学习用户偏好

适合人群

• macOS 深度用户，希望自动化每日信息整合
• 追求"数字极简"、反感信息过载的焦虑缓解型用户
• 已将主力工作流绑定 Apple 生态（日历、提醒、iCloud 邮箱）的群体
• 需要为团队/家庭设置定时简报推送的技术爱好者

常规风险

• TCC 权限扩散：脚本需终端辅助功能权限，存在权限管理疏漏风险
• 凭证配置隐患：iCloud 应用专用密码以明文存储于配置文件
• 邮件误判：AI 语义分析可能漏检重要邮件或误标营销邮件为重要
• API 依赖：wttr.in 为免费服务，无 SLA 保障，极端天气场景可能延迟或失败

核心用法

daily-briefing 是一款 macOS 专属的每日简报生成工具，采用 System Skill (Orchestrator Pattern) 架构。其工作流程为：

1. 触发数据收集脚本 — 调用 run_daily_briefing.sh 执行本地 orchestrator
2. 读取聚合数据 — 从 /tmp/daily_briefing_data.json 获取天气、日历、提醒、生日、邮件等结构化数据
3. Agent 处理天气 — 直接通过 curl 从 wttr.in 获取天气信息
4. 语义分析邮件 — 使用 LLM 能力筛选重要邮件（订单、交易、安全提醒等），过滤促销和批量招聘邮件
5. 生成温暖简报 — 按严格格式输出 5-15 行紧凑型日报，支持 cron 自动化投递

关键配置项

• location + units(C/F)：天气设置
• birthdays.lookahead：生日提前提醒天数（默认14天）
• calendar.sources：支持 Google Calendar + iCloud Calendar
• emails.enabled：AI 邮件摘要（需配置 iCloud App-Specific Password）

显著优点

| 优势 | 说明 |

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

| **零云端数据上传** | 所有敏感数据（联系人、日历、邮件）均本地处理，仅天气查询走外部 API |

| **TCC 权限保护** | 访问 Contacts/Calendar/Reminders/Emails 受 macOS 系统级权限框架管控 |

| **优雅的降级策略** | 任何模块失败都不影响整体简报生成，天气缺失时自动 fallback |

| **Telegram 友好格式** | 短行、宽松间距、emoji 标题，适合即时通讯场景 |

| **智能邮件过滤** | 自动识别订单物流、交易提醒、安全警报，排除营销噪音 |

潜在局限与风险

| 局限/风险 | 详情 |

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

| **macOS 限定** | 依赖 `osascript` 和 TCC 框架，无法跨平台运行 |

| **外部工具依赖** | 需手动安装 `gog`、`icalpal`、`himalaya` 等 Homebrew 工具 |

| **个人开发者来源 (T3)** | 维护者身份不可追溯，长期更新存在不确定性 |

| **临时文件路径固定** | 使用 `/tmp/daily_briefing_data.json`，多用户环境需注意权限 |

| **邮件语义分析门槛** | 重要邮件判定依赖 LLM 能力，偶有误判可能 |

适合人群

• macOS 重度用户：已深度使用 Apple 生态（日历、提醒、iCloud 邮件）
• 自动化爱好者：希望通过 cron/Timely 等工具获取每日晨间简报
• 隐私敏感用户：拒绝将个人数据上传至第三方日历/邮件分析服务
• Telegram/Discord 活跃用户：需要简洁、可复制的每日摘要格式

常规风险

• 权限配置不当可能导致数据读取失败，建议首次使用先在交互模式验证
• iCloud 邮件功能需使用 App-Specific Password，误用主密码存在安全风险
• 外部工具版本漂移可能影响功能，建议定期 brew upgrade
• 天气服务 wttr.in 偶尔不稳定，已设计单次重试机制