Wake the Agent on a File Cursor, Not on a Heartbeat

Removes the empty-poll turn entirely. OpenClaw's heartbeat bills a full agent turn per interval whether or not anything happened — 48 turns/day at the 30m baseline, 24/day at the 1h Anthropic-OAuth default. An event-driven wake bills only on real events, so an idle day costs no tokens (the watcher daemon still runs) — while reacting in seconds instead of up to an hour. Advanced 7 min read

Anything that isn't a directly pushed message — cron output, log lines, inbox changes, external feeds — is only noticed at heartbeat granularity, and every heartbeat burns a full LLM turn even when nothing happened. Hold byte-offset cursors on the plaintext files those sources already write, wake the agent only on an actual append, and coalesce bursts into one turn. A polling loop's cost scales with wall-clock time; an event loop's cost scales with real events.

🔒 Pro tip · Advanced

Unlock this tip — and 105 more

This is one of 106 advanced, fact-checked tactics reserved for Pro. Get the full 128-tip library, a searchable archive, and a new tip every morning. Free for 7 days, then $9/mo.

Prefer to browse? The 22 Beginner tips are free forever.