openclaw/docs/cli/agent.md

summary, read_when

summary	read_when
CLI reference for `clawdbot agent` (send one agent turn via the Gateway)	You want to run one agent turn from scripts (optionally deliver reply)

clawdbot agent

Run an agent turn via the Gateway (use --local for embedded).

Related:

• Agent send tool: Agent send

Examples

clawdbot agent --to +15555550123 --message "status update" --deliver
clawdbot agent --session-id 1234 --message "Summarize inbox" --thinking medium