Agent 发送
从 CLI 运行智能体轮次，并可选择将回复发送到渠道
openclaw agent 可从命令行运行单个智能体轮次，无需接收入站聊天消息。适用于脚本化工作流、测试和程序化交付。完整的标志和行为参考：
智能体 CLI 参考。
快速开始
运行一个简单的智能体轮次
openclaw agent --agent main --message "今天天气如何？"通过 Gateway 网关发送消息并打印回复。
从文件发送多行提示词
openclaw agent --agent ops --message-file ./task.md读取有效的 UTF-8 文件作为智能体消息正文。
指定智能体或会话
# 指定智能体
openclaw agent --agent ops --message "汇总日志"
# 指定电话号码（派生会话键）
openclaw agent --to +15555550123 --message "状态更新"
# 复用现有会话
openclaw agent --session-id abc123 --message "继续执行任务"
# 指定确切的会话键
openclaw agent --session-key agent:ops:incident-42 --message "汇总状态"将回复发送到渠道
# 发送到 WhatsApp（默认渠道）
openclaw agent --to +15555550123 --message "报告已就绪" --deliver
# 发送到 Slack
openclaw agent --agent ops --message "生成报告" \
--deliver --reply-channel slack --reply-to "#reports"标志
| 标志 | 说明 |
|---|---|
--message <text> | 要发送的内联消息 |
--message-file <path> | 从有效的 UTF-8 文件读取消息（最大 4 MiB） |
--to <dest> | 从目标（电话号码、聊天 ID）派生会话键 |
--session-key <key> | 使用显式会话键 |
--agent <id> | 指定已配置的智能体（使用其 main 会话） |
--session-id <id> | 按 ID 复用现有会话 |
--model <id> | 覆盖本次运行的模型（provider/model 或模型 ID） |
--local | 强制使用本地嵌入式运行时（跳过 Gateway 网关） |
--deliver | 将回复发送到聊天渠道 |
--channel <name> | 交付渠道；与 --agent + --to 一起使用时，也适用于私信范围 |
--reply-to <target> | 覆盖交付目标 |
--reply-channel <name> | 覆盖交付渠道 |
--reply-account <id> | 覆盖交付账户 ID |
--thinking <level> | 设置所选模型配置的思考级别 |
--verbose <on|full|off> | 为会话持久化详细输出级别（full 还会记录工具输出） |
--timeout <seconds> | 覆盖智能体超时时间（默认值为 600，或使用配置值） |
--json | 输出结构化 JSON |
行为
- 默认情况下，CLI 通过 Gateway 网关运行。添加
--local可强制使用 当前机器上的嵌入式运行时。 --message和--message-file必须且只能传入其中一个。文件消息会在移除可选的 UTF-8 BOM 后保留 多行内容。大于 4 MiB 的文件会在分派前被拒绝。- 短暂握手重试后，如果 Gateway 网关超时或连接关闭，
命令将失败并在 stderr 中显示提示；CLI 绝不会静默地通过嵌入式运行时重新运行该轮次。
Gateway 网关仍可能完成已接受的轮次，因此在重试或使用
--local重新运行之前， 请先验证 Gateway 网关和会话状态。 - 会话选择：
--to会派生会话键（群组/渠道目标 保持隔离；直接聊天会归并到main）。同时使用--agent、--channel和--to时，路由遵循该渠道的规范 接收方和session.dmScope。稳定的纯出站身份使用 提供商拥有的会话，并与智能体的主会话隔离。 --session-key选择显式键。带智能体前缀的键必须使用agent:<agent-id>:<session-key>；同时提供两者时，--agent必须与该智能体 ID 匹配。提供--agent时，不含哨兵值的裸键会限定到其范围； 例如，--agent ops --session-key incident-42会路由到agent:ops:incident-42。如果没有--agent，不含哨兵值的裸键会限定 到已配置的默认智能体。仅当未提供--agent时，字面值global和unknown才保持不限定范围。--reply-channel和--reply-account仅影响交付。- 思考和详细输出标志会持久化到会话存储中。
- 输出：默认为纯文本，也可使用
--json输出结构化载荷和元数据。 - 使用
--json --deliver时，JSON 会包含已发送、 已抑制、部分完成和失败发送的交付状态。请参阅 JSON 交付状态。
示例
# 输出 JSON 的简单轮次
openclaw agent --to +15555550123 --message "追踪日志" --verbose on --json
# 覆盖模型的轮次
openclaw agent --agent ops --model openai/gpt-5.4 --message "汇总日志"
# 设置思考级别的轮次
openclaw agent --session-id 1234 --message "汇总收件箱" --thinking medium
# 从文件读取多行提示词
openclaw agent --agent ops --message-file ./task.md
# 确切的会话键
openclaw agent --session-key agent:ops:incident-42 --message "汇总状态"
# 限定到智能体范围的旧版键
openclaw agent --agent ops --session-key incident-42 --message "汇总状态"
# 交付到与会话不同的渠道
openclaw agent --agent ops --message "警报" --deliver --reply-channel telegram --reply-to "@admin"相关内容
- 智能体 CLI 参考：完整的
openclaw agent标志和选项参考。 - 子智能体：在后台生成子智能体。
- 会话：会话键的工作原理，以及
--to、--agent和--session-id如何解析它们。 - 斜杠命令：智能体会话中使用的原生命令目录。