核心用法
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 依赖
gogCLI 的 OAuth 授权，授权失效或令牌过期需重新配置。 - 误创建风险：尽管有确认步骤，但自动创建规则配置不当可能导致不需要的事件进入日历。
- 版本兼容性：
gogCLI 或 Google API 变更可能导致脚本失效，需及时更新 Skill 版本。