clawdbot/docs/cli/wake.md

summary, read_when

summary	read_when
CLI reference for `clawdbot wake` (enqueue a system event and optionally trigger an immediate heartbeat)	You want to “poke” a running Gateway to process a system event You use `wake` with cron jobs or remote nodes

clawdbot wake

Enqueue a system event on the Gateway and optionally trigger an immediate heartbeat.

This is a lightweight “poke” for automation flows where you don’t want to run a full command, but you do want the Gateway to react quickly.

Related:

• Cron jobs: Cron
• Gateway heartbeat: Heartbeat

Common commands

clawdbot wake --text "sync"
clawdbot wake --text "sync" --mode now

Flags

• --text <text>: system event text.
• --mode <mode>: now or next-heartbeat (default).
• --json: machine-readable output.

Notes

• Requires a running Gateway reachable by your current config (local or remote).
• If you’re using sandboxing, wake still targets the Gateway; sandboxing does not block the command itself.