跳转到内容

Agent send

openclaw agent 从命令行运行单个 Agent 轮次，而无需传入聊天消息。将其用于脚本化工作流、测试和程序化交付。

快速开始

运行简单的 Agent 轮次
Terminal window
```
openclaw agent --message "What is the weather today?"
```
这会通过 Gateway(网关) 发送消息并打印回复。

定位特定的 Agent 或会话

# Target a specific agent
openclaw agent --agent ops --message "Summarize logs"

# Target a phone number (derives session key)
openclaw agent --to +15555550123 --message "Status update"

# Reuse an existing session
openclaw agent --session-id abc123 --message "Continue the task"

将回复投递到渠道

# Deliver to WhatsApp (default channel)
openclaw agent --to +15555550123 --message "Report ready" --deliver

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

标志

标志	描述
`--message \<text\>`	要发送的消息（必填）
`--to \<dest\>`	从目标（电话、聊天 ID）派生会话密钥
`--agent \<id\>`	以已配置的 Agent 为目标（使用其 `main` 会话）
`--session-id \<id\>`	通过 ID 重用现有会话
`--local`	强制使用本地嵌入式运行时（跳过 Gateway(网关)）
`--deliver`	将回复发送到聊天渠道
`--channel \<name\>`	投递渠道（whatsapp、telegram、discord、slack 等）
`--reply-to \<target\>`	投递目标覆盖
`--reply-channel \<name\>`	投递渠道覆盖
`--reply-account \<id\>`	投递账户 ID 覆盖
`--thinking \<level\>`	为所选模型配置文件设置思考级别
`--verbose \<on\|full\|off\>`	设置详细级别
`--timeout \<seconds\>`	覆盖 Agent 超时时间
`--json`	输出结构化 JSON

行为

默认情况下，CLI 通过 Gateway(网关) 运行。添加 --local 以强制使用当前机器上的嵌入式运行时。
如果 Gateway(网关) 无法访问，CLI 将回退到本地嵌入式运行。
会话选择：--to 派生会话密钥（群组/渠道目标保持隔离；直接聊天折叠为 main）。
思考和详细标志会持久化到会话存储中。
输出：默认为纯文本，或使用 --json 获取结构化负载和元数据。
使用 --json --deliver 时，JSON 包含已发送、已抑制、部分发送和发送失败的传递状态。请参阅 JSON 传递状态。

示例

# Simple turn with JSON output
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json

# Turn with thinking level
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium

# Deliver to a different channel than the session
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

相关

Agent CLI 参考

完整的 openclaw agent 标志和选项参考。

后台子代理生成。

会话密钥的工作原理，以及 --to、--agent 和 --session-id 如何解析它们。

在代理会话中使用的本机命令目录。