Skip to main content
openclaw agent 从命令行运行单个 agent 回合，无需传入 聊天消息。可用于脚本化工作流、测试和 程序化投递。

​
快速开始

1

运行一个简单的 agent 回合

openclaw agent --agent main --message "What is the weather today?"
这会通过 Gateway 发送消息并打印回复。
2

指定特定的 agent 或会话

# 指定特定的 agent
openclaw agent --agent ops --message "总结日志"

# 指定一个电话号码（派生 session key）
openclaw agent --to +15555550123 --message "状态更新"

# 复用一个现有会话
openclaw agent --session-id abc123 --message "Continue the task"

# 目标指定一个精确的 session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"
3

将回复投递到渠道

# 投递到 WhatsApp（默认渠道）
openclaw agent --to +15555550123 --message "报告已准备好" --deliver

# 投递到 Slack
openclaw agent --agent ops --message "生成报告" \
  --deliver --reply-channel slack --reply-to "#reports"

​
标志

FlagDescription
--message \<text\>要发送的消息（必填）
--to \<dest\>从目标（电话、聊天 id）派生 session key
--session-key \<key\>使用显式的 session key
--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\>为所选模型配置文件设置 thinking 级别
--verbose \<on|full|off\>设置 verbose 级别
--timeout \<seconds\>覆盖 agent 超时时间
--json输出结构化 JSON

​
行为

  • 默认情况下，CLI 会 通过 Gateway 运行。添加 --local 可强制在当前机器上使用 嵌入式运行时。
  • 如果 Gateway 无法访问，CLI 会 回退 到本地嵌入式运行。
  • 会话选择：--to 会派生 session key（群组/频道目标 保持隔离；直接聊天会折叠为 main）。
  • --session-key 选择一个显式 key。带 agent 前缀的 key 必须使用 agent:<agent-id>:<session-key>，并且当两者都提供时，--agent 必须与该 agent id 匹配。裸露的非 sentinel key 在提供 --agent 时会被限定到 --agent 的作用域；例如， --agent ops --session-key incident-42 会路由到 agent:ops:incident-42。如果没有 --agent，裸露的非 sentinel key 会限定到 配置的默认 agent。字面量 global 和 unknown 只有在未提供 --agent 时才保持 不加作用域；在这种情况下，嵌入式回退和存储归属会使用配置的默认 agent。
  • Thinking 和 verbose 标志会持久化到 session store 中。
  • 输出：默认是纯文本，或者使用 --json 输出结构化载荷 + 元数据。
  • 使用 --json --deliver 时，JSON 会包含已发送、 被抑制、部分发送和发送失败的投递状态。请参见 JSON delivery status。

​
示例

# 使用 JSON 输出的简单回合
openclaw agent --to +15555550123 --message "跟踪日志" --verbose on --json

# 指定 thinking 级别的回合
openclaw agent --session-id 1234 --message "总结收件箱" --thinking medium

# 精确的 session key
openclaw agent --session-key agent:ops:incident-42 --message "Summarize status"

# 限定到某个 agent 的旧式 key
openclaw agent --agent ops --session-key incident-42 --message "Summarize status"

# 投递到与会话不同的渠道
openclaw agent --agent ops --message "Alert" --deliver --reply-channel telegram --reply-to "@admin"

​
相关内容

Agent CLI reference

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

Sub-agents

后台子 agent 启动。

Sessions

session key 的工作方式，以及 --to、--agent 和 --session-id 如何解析它们。

Slash commands

agent 会话中使用的原生命令目录。