Heartbeat
The heartbeat system lets Clawbolt proactively reach out with reminders and follow-ups. Instead of waiting for you to message first, Clawbolt checks in periodically when there is something useful to say.
How it works
Section titled “How it works”The heartbeat runs on a timer and uses a two-stage design: cheap checks first, LLM only when needed.
Stage 1: Deterministic checks (no LLM cost)
Section titled “Stage 1: Deterministic checks (no LLM cost)”Fast database queries look for actionable items:
- Stale draft estimates: Estimates in “draft” status for more than 24 hours
- Due checklist items: Items scheduled for today (daily, weekdays, or one-time)
- Time-sensitive memory facts: Facts containing keywords like “remind”, “follow-up”, “deadline”
- Idle contractors: No inbound messages for a configurable number of days
Stage 2: LLM evaluation (only if flags found)
Section titled “Stage 2: LLM evaluation (only if flags found)”If any checks return results, the LLM composes an appropriate message. It can decide to send the message or take no action, based on priority and context.
Business hours awareness
Section titled “Business hours awareness”Clawbolt respects your schedule:
- Messages are only sent during your configured business hours (e.g., 7am-5pm)
- Your timezone is respected (set in your profile)
- Global quiet hours prevent late-night messages (default 8pm-7am)
Checklist items
Section titled “Checklist items”You can ask Clawbolt to create recurring reminders:
You: Remind me to check on the Garcia job every weekday morning
Clawbolt: I've added a weekday checklist item: "Check on the Garcia job"Schedules supported:
- Daily: Every day during active hours
- Weekdays: Monday through Friday
- Once: A one-time reminder
Rate limiting
Section titled “Rate limiting”The heartbeat system includes rate limiting to prevent spam. Outbound heartbeat messages are logged, and cooldown periods are enforced between messages.