email-to-calendar

核心用法

email-to-calendar 是一款智能邮件事件提取与日历同步工具，提供两种工作模式：直接收件箱监控（扫描所有未读邮件）和转发邮件处理（处理发送至专用地址的转发邮件）。用户通过配置 config.json 设定规则后，Skill 自动读取邮件内容、提取事件信息（标题、日期、时间、地点、URL、截止日期等），经用户确认后创建或更新 Google Calendar 事件。

关键操作流程包括：启动活动日志会话 → 检查邮件处理状态 → 应用忽略/自动创建规则 → 提取结构化事件数据 → 三重重复检测（本地跟踪索引 → 语义匹配 → 日历搜索）→ 用户确认创建 → 自动邮件归档。对于含截止日期的活动（如 RSVP、购票），系统会创建主事件+截止提醒双事件，并可触发邮件通知。

显著优点

1. 智能去重机制：三层检测（本地索引、语义匹配、日历搜索）有效避免重复创建，支持事件更新而非重复添加。
2. 完善的撤销与追踪：24小时内可撤销任何操作，完整的变更日志和活动日志便于审计。
3. 截止日期感知：自动识别 RSVP、注册、购票等截止期限，创建独立提醒事件并发送通知邮件。
4. 灵活的配置规则：支持忽略模式（跳过新闻通讯等）和自动创建模式（对特定发件人或主题自动处理）。
5. 模块化架构：Python 工具模块 + Bash 包装脚本分离职责，154+ 单元测试保障稳定性。

潜在缺点与局限性

1. 时区处理简化：所有时间假设为本地时区，跨时区场景需手动调整。
2. 依赖外部 CLI：核心功能依赖 gog 命令行工具，若该工具变更或失效将影响 Skill 运行。
3. LLM 提取不确定性：邮件内容解析依赖大语言模型，复杂格式或非标准日期表达可能识别错误。
4. 无实时同步：基于轮询或手动触发，非真正的实时邮件监听。
5. Google 生态锁定：当前仅支持 Google Calendar/Gmail，虽架构预留扩展性但实际迁移成本存在。

适合的目标群体

• 高频邮件用户：每日接收大量活动邀请、会议通知的职场人士
• 行政助理/运营人员：需要统一管理多人日程的团队协调者
• 会议密集型岗位：销售、项目经理、咨询顾问等
• 自动化爱好者：希望减少手动复制粘贴日历事件的效率追求者
• Google Workspace 用户：深度使用 Gmail 和 Google Calendar 的群体

使用风险

• 数据持久化风险：所有事件跟踪、待处理邀请、活动日志存储于本地 JSON 文件，需关注 ~/.openclaw/workspace/memory// 目录的备份与磁盘空间。
• 权限依赖风险：Skill 依赖 gog CLI 的 OAuth 授权，授权失效或令牌过期需重新配置。
• 误创建风险：尽管有确认步骤，但自动创建规则配置不当可能导致不需要的事件进入日历。
• 版本兼容性：gog CLI 或 Google API 变更可能导致脚本失效，需及时更新 Skill 版本。