核心用法
Proactive Claw 是一款专为 OpenClaw 设计的主动式执行引擎，核心功能是作为个人智能助理协助管理日程。其工作流程围绕"感知-评分-规划-确认-执行-学习"的闭环展开：从 Google Calendar 或 Nextcloud CalDAV 摄取事件信息，利用本地轻量级评分模型对重要性、紧急性和干扰风险进行量化评估（0-1 分数），据此生成智能建议（如准备块、缓冲时间、深度工作保护、后续跟进等），最终在聊天界面中请求用户确认，仅执行已批准的修改，并从用户的批准、编辑、拒绝行为中学习偏好模式。
关键交互模式：
- Suggest 模式（默认）：所有变更需经用户确认（
max_autonomy_level=confirm） - Calm/Builder/Meetings-heavy 三种预设：分别对应最小打扰、深度工作保护、密集会议场景
- 本地优先架构：核心评分模型、状态存储、配置均可完全本地化运行
显著优点
1. 隐私优先的本地架构：核心功能不依赖外部服务，评分模型推荐使用小型本地模型，状态文件透明且可删除
2. 用户主权设计：默认"询问后执行"模式，杜绝未经同意的日历修改，适合对自动化持谨慎态度的用户
3. 快速个性化学习：通过反馈闭环（批准/拒绝/编辑）迅速收敛到个人偏好，如特定会议类型的准备时长、缓冲习惯等
4. 深度工作保护：Builder 模式主动识别并防御碎片化会议对长时间专注块的侵蚀
5. 多后端兼容：支持 Google Calendar（OAuth）和 Nextcloud CalDAV，为隐私敏感用户提供非 Google 选项
6. 低门槛预设配置：三种场景化预设避免繁琐的参数调优，同时保留进阶自定义空间
潜在缺点与局限性
1. 默认非自主运行：需频繁人机交互确认，追求"零打扰"全自动体验的用户需显式启用 Autonomous 模式（不推荐新手）
2. 评分模型依赖：重要性判断质量取决于本地模型的能力，小型模型可能在复杂场景下表现有限
3. 日历后端仍依赖外部：尽管核心本地运行，但日历数据仍存储于 Google 或 Nextcloud，非完全离线方案
4. 功能模块化拆分：后台守护进程和第三方集成助手置于独立包 proactive-claw-integrations 中，完整体验需额外安装
5. 学习收敛期：初期可能因偏好未收敛而产生"过多提示"或"准备块长度不符预期"的摩擦
适合人群
- 知识工作者：需要保护深度工作时间的开发者、研究员、创作者
- 日程密集型管理者：会议频繁、易遗漏跟进事项、需要智能缓冲规划的职场人士
- 隐私敏感用户：希望核心功能本地运行、避免云端 AI 处理个人日程数据的用户
- 自动化谨慎派：偏好"建议-确认"而非"直接执行"的保守型用户
- Nextcloud 生态用户：寻求 Google Calendar 替代方案的自托管爱好者
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| **误操作风险** | 错误批准可能导致日历冲突 | 默认确认模式；修改可撤销；状态文件透明可删 |
| **OAuth 凭证泄露** | `credentials.json` 和 `token.json` 本地存储 | 文件权限控制；可完全改用 Nextcloud CalDAV |
| **本地数据残留** | 学习历史、配置、日志存储于本地 | 卸载时手动删除 `~/.openclaw/workspace/skills/proactive-claw/` |
| **模型偏见/误判** | 评分模型可能错误评估事件重要性 | 提供反馈纠正；可调整评分阈值或更换模型 |
| **API 配额/连接** | Google Calendar API 调用限制或网络中断 | 支持 CalDAV 替代方案；错误重试机制 |