Proactive Claw

核心用法

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 替代方案；错误重试机制 |

核心用法

Proactive Claw 作为 OpenClaw 生态的主动执行引擎，通过与 Google Calendar 或 Nextcloud CalDAV 的双向同步，实现"感知-建议-学习-优化"的闭环。安装后运行 scripts/setup.sh 完成依赖配置与 OAuth/CalDAV 授权，即可通过 python3 scripts/daemon.py --simulate 预览效果。

系统默认运行于建议模式（Suggest）：分析即将到来的日程，在聊天界面推送智能建议——包括会议前的准备时段、防止日程冲突的缓冲间隙、深度工作窗口保护，以及易遗漏的跟进提醒。用户通过聊天界面批准或拒绝后，修改才会写入日历。高级用户可选择自主模式，但需显式开启。

提供三种预设快速上手：Calm 模式（最少打扰，仅高价值建议）、Builder 模式（保护 2-3 小时深度工作块）、Meetings-heavy 模式（密集会议周自动添加缓冲与重置休息）。所有学习数据（准备时长偏好、接受/拒绝模式、会议类型规律）存储于本地 SQLite，随交互快速个性化。

显著优点

本地优先架构是最大亮点：OAuth 令牌、日历元数据、学习模型全部留存于 ~/.openclaw/workspace/skills/proactive-claw/，无需信任第三方服务器。配合推荐的本地小型评分模型，可实现完全离线的隐私保护。

安全边界设计专业：默认"确认后执行"策略杜绝意外修改；代码级强制仅写入专用 Actions 日历，主日历只读访问；30+ 功能开关全部默认关闭，遵循最小权限原则。

学习效率高：通过记录用户的批准、编辑、拒绝行为，快速收敛个人风格——从初始预设到个性化建议通常仅需 1-2 周交互。评分模型（0-1 重要性分数）确保建议时机精准，避免通知疲劳。

开放后端选择：同时支持 Google Calendar（OAuth）与 Nextcloud CalDAV（自托管），后者满足对数据主权有要求的用户。

潜在缺点与局限性

依赖手动干预的启动流程：Python 依赖（google-api-python-client、caldav 等）需用户根据 setup.sh 提示手动安装，虽降低供应链攻击面，却提高了非技术用户门槛。

功能边界需清晰认知：核心包不含后台守护进程与第三方集成，这些功能拆分至 proactive-claw-integrations 扩展包。需要常驻运行的用户需额外安装。

T3 来源信任成本：开发者标识为随机字符串个人账号，无企业背书或基金会托管。虽代码质量达专业水准，企业用户仍需额外审计。

配置复杂度：30+ 功能开关对新手不够友好，虽有向导脚本，但理解各参数含义仍需阅读文档。

适合的目标群体

• 知识工作者：开发者、设计师、研究员等需要保护深度工作时段的用户
• 日程密集管理者：顾问、产品经理等会议频繁、需智能缓冲与跟进提醒的人群
• 隐私敏感用户：倾向本地数据处理、不愿日历数据流经第三方 SaaS 的个人
• 自托管爱好者：已部署 Nextcloud 生态、追求数据主权的用户
• 效率工具探索者：愿意投入 1-2 周训练期、换取长期个性化日程体验的用户

使用风险

性能与资源：本地评分模型虽推荐小型以保速度，但若选用较大模型，低配置设备可能出现延迟。

依赖项维护：Google/Nextcloud API 库需持续关注安全更新，建议按报告建议锁定 requirements.txt 版本并定期 pip-audit 扫描。

OAuth 令牌安全：虽本地存储，但设备丢失或共享时仍存在泄露风险，建议结合设备全盘加密。

学习期误判：初期建议可能不符合实际习惯，频繁拒绝虽会收敛，但前两周需一定耐心投入。

自主模式风险：显式开启后系统可自动应用修改，建议充分验证建议质量后再启用，避免日程冲突。