openclaw/docs/cli/agent.md

summary, read_when, title

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

openclaw agent

Run an agent turn via the Gateway (use --local for embedded). Use --agent <id> to target a configured agent directly.

Related:

• Agent send tool: Agent send

Examples

openclaw agent --to +15555550123 --message "status update" --deliver
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"