Home

Switch language

Start Install GuideQuick StartDocs Overview
Docs ChannelsModels & APIGateway OpsTools & Skills
More ArticlesResourcesHelp Center
Get Started
Documentation navigation Tools & Skills
Tools & Skills 2 sections

Direct Agent Run

Agent Send

openclaw agent can run a single agent turn directly without waiting for an inbound channel message. It is useful for automation, testing, session reuse and targeted delivery.

Common Usage

Send a direct message

openclaw agent --to +15555550123 --message "status update"

Target a specific agent

openclaw agent --agent ops --message "Summarize logs"

Reuse a session with an explicit thinking level

openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

Deliver the result after execution

openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

Key Flags

--local: force local execution on the current machine instead of going through the Gateway first.

--deliver, --channel and --reply-*: control which channel receives the result.

--thinking and --verbose: persist reasoning and verbosity settings at the session level.

--json: emit structured output suitable for scripts.