Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw agent 会从命令行运行单个智能体轮次，无需传入聊天消息。可用于脚本化工作流、测试和程序化投递。
快速开始
标志
| 标志 | 描述 |
|---|---|
--message \<text\> | 要发送的消息（必需） |
--to \<dest\> | 从目标（电话、聊天 ID）派生会话键 |
--agent \<id\> | 指定已配置的智能体（使用其 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\> | 覆盖智能体超时时间 |
--json | 输出结构化 JSON |
行为
- 默认情况下，CLI 会通过 Gateway 网关。添加
--local可强制使用当前机器上的嵌入式运行时。 - 如果 Gateway 网关不可达，CLI 会回退到本地嵌入式运行。
- 会话选择：
--to派生会话键（群组/渠道目标会保留隔离；直接聊天会合并到main）。 - 思考和详细输出标志会持久化到会话存储。
- 输出：默认是纯文本，或使用
--json输出结构化载荷 + 元数据。 - 使用
--json --deliver时，JSON 会包含已发送、已抑制、部分发送和发送失败的投递状态。参见 JSON 投递状态。
示例
相关内容
智能体 CLI 参考
完整的
openclaw agent 标志和选项参考。子智能体
后台子智能体生成。
会话
会话键的工作方式，以及
--to、--agent 和 --session-id 如何解析它们。斜杠命令
在智能体会话中使用的原生命令目录。