nyrn
/
openclaw
mirror of https://github.com/openclaw/openclaw.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
openclaw/docs/automation/index.md

3.8 KiB
Raw Blame History

summary read_when title
Overview of all automation mechanisms: heartbeat, cron, tasks, hooks, webhooks, and more
Deciding how to automate work with OpenClaw
Choosing between heartbeat, cron, hooks, and webhooks
Looking for the right automation entry point
Automation Overview

Automation

OpenClaw provides several automation mechanisms, each suited to different use cases. This page helps you choose the right one.

Quick decision guide

flowchart TD
    A{Run on a schedule?} -->|Yes| B{Exact timing needed?}
    A -->|No| C{React to events?}
    B -->|Yes| D[Cron]
    B -->|No| E[Heartbeat]
    C -->|Yes| F[Hooks]
    C -->|No| G[Standing Orders]

Mechanisms at a glance

Mechanism What it does Runs in Creates task record
Heartbeat Periodic main-session turn — batches multiple checks Main session No
Cron Scheduled jobs with precise timing Main or isolated session Yes (all types)
Background Tasks Tracks detached work (cron, ACP, subagents, CLI) N/A (ledger) N/A
Hooks Event-driven scripts triggered by agent lifecycle events Hook runner No
Standing Orders Persistent instructions injected into the system prompt Main session No
Webhooks Receive inbound HTTP events and route to the agent Gateway HTTP No

Specialized automation

Mechanism What it does
Gmail PubSub Real-time Gmail notifications via Google PubSub
Polling Periodic data source checks (RSS, APIs, etc.)
Auth Monitoring Credential health and expiry alerts

How they work together

The most effective setups combine multiple mechanisms:

  1. Heartbeat handles routine monitoring (inbox, calendar, notifications) in one batched turn every 30 minutes.
  2. Cron handles precise schedules (daily reports, weekly reviews) and one-shot reminders.
  3. Hooks react to specific events (tool calls, session resets, compaction) with custom scripts.
  4. Standing Orders give the agent persistent context ("always check the project board before replying").
  5. Background Tasks automatically track all detached work so you can inspect and audit it.

See Cron vs Heartbeat for a detailed comparison of the two scheduling mechanisms.

Older ClawFlow references

Older release notes and docs may mention ClawFlow or openclaw flows, but the current CLI surface in this repo is openclaw tasks.

See Background Tasks for the supported task ledger commands, plus ClawFlow and CLI: flows for compatibility notes.

Related