Proactive Claw

🦞 Proactive Claw

Proactive Claw is a proactive execution engine that collaborates with you and learns from you.

It helps you be more productive by making smart suggestions at the right moment — and (by default) only 应用lying what you 应用rove.

Everything can 运行 locally.

Safety in one glance ✅

✅ Asks before 应用lying changes (default) ✅ Writes only what you 应用rove (no surprise calendar edits) ✅ Local-first core bundle (no external integration 辅助工具s) ✅ Everything can 运行 locally (small/local scoring 模型 recommended) ✅ Local 状态 folder is transparent and deletable

Why people 安装 it (what you feel in week 1) You show up prepared more often. Your calendar becomes more rea列出ic (buffers 应用ear where they matter). Deep work blocks 停止 获取ting shredded by “just one quick meeting.” Follow-ups 停止 slipping. Proactive Claw learns your style quickly: prep durations, preferred times, what you reject, what you always accept.

In short: it becomes your personal 助手.

Graph A — the simple loop (how it works at a glance) +--------------------------+ +--------------------------+ | Calendar | | Chat | | Google Calendar/Nextcloud| | (your control loop) | +------------+-------------+ +------------+-------------+ | 事件 <-> suggestions | prompts <-> decisions | | +-------------------+---------------+ | v +--------------------------------------+ | Proactive Claw | | - notices what's coming | | - prioritizes what matters | | - suggests prep / buffers / followup | | - learns from your feedback | | - 应用lies only what you 应用rove | +--------------------------------------+

Key idea: Proactive Claw is proactive, but you remAIn the decision-maker (by default).

Quick 启动 (2 minutes) 运行 readiness 检查s: bash scripts/设置up.sh --doctor

If dependencies are missing, print one 安装 command: bash scripts/设置up.sh --print-安装-cmd google # or: bash scripts/设置up.sh --print-安装-cmd nextcloud

Bootstrap calendar connection: bash scripts/设置up.sh

运行 a safe preview: bash scripts/quick启动.sh

应用rove a suggestion in chat, then 运行 once: python3 scripts/daemon.py

Modes (choose your vibe) Suggest (default): asks before 应用lying changes (max_autonomy_level=confirm) Background (manual): 运行 local daemon yourself (python3 scripts/daemon.py --loop) Autonomous (advanced): explicit opt-in only (not recommended until you’ve used it for a while) Pre设置s (easy 设置up)

You don’t need to 调优 dozens of 设置tings. Pick a pre设置.

Pre设置s are just a 启动ing point. Proactive Claw adjusts to you with every interaction (应用rovals, edits, rejections), and quickly becomes personal.

A) Calm mode (minimal interruptions)

Choose this if you want only high-value suggestions.

fewer prompts only 导入ant 事件 获取 prep/buffers B) 构建器 mode (deep work 保护ed)

Choose this if you code/build and need long focus blocks.

defends 2–3h deep work windows suggests moving meetings that fragment focus stronger buffers + 恢复y time C) Meetings-heavy week

Choose this when your schedule is packed.

添加s buffers + re设置 breaks 预防s back-to-back collapse proposes follow-ups so action doesn’t slip

(If you want, these pre设置s can be expressed as a small copy/paste block in config.json.)

Chat scoring 模型 (built-in; small/local recommended)

Proactive Claw includes a chat scoring 模型 to rank 签名als (导入ance, urgency, disruption risk) so it knows:

what matters, when to ask you, and when to stay quiet.

Recommendation: use a small 模型, ideally local (fast, cheap, private). Your planning 模型 can be bigger; scoring should stay small and fast.

Scenarios (mini transcripts) 1) Presentation tomorrow → prep + buffer

You: Tomorrow I’m presenting the roadmap to the board. Claw (score = 0.92): High impact. You usually prep ~70 minutes for presentations. Claw: Want me to reserve 08:40–09:50 for prep + a 10-min buffer before the 10:00 meeting?

2) Deep work 保护ion (developer mode)

Claw (score = 0.78): This meeting would split your deep work block (09:30–12:00). Claw: Prefer to move it to 13:00, or keep it and 添加 a 20-min 恢复y buffer after?

3) Back-to-back day → buffers + re设置

Claw (score = 0.81): Tomorrow is back-to-back from 10:00–14:00. Claw: 添加 10-min buffers between meetings + a 25-min re设置 break around midday?

4) Follow-up that tends to slip

You: I promised I’ll 发送 the summary. Claw (score = 0.66): Time-sensitive. Claw: Want a 20-min follow-up block right after the meeting (or at 17:10)?

5) It becomes personal fast (recurring pattern)

Claw (score = 0.71): I’ve noticed a pattern