OpenClaw 白皮书

openclaw agent（直接智能体运行）

openclaw agent 运行单个智能体回合，无需入站聊天消息。 默认情况下它通过 Gateway 网关运行；添加 --local 以强制在当前机器上使用嵌入式运行时。

行为

  • ✦必需：--message <text>
  • ✦会话选择：
    • ✦--to <dest> 派生会话键（群组/频道目标保持隔离；直接聊天折叠到 main），或
    • ✦--session-id <id> 通过 ID 重用现有会话，或
    • ✦--agent <id> 直接定位已配置的智能体（使用该智能体的 main 会话键）
  • ✦运行与正常入站回复相同的嵌入式智能体运行时。
  • ✦思考/详细标志持久化到会话存储中。
  • ✦输出：
    • ✦默认：打印回复文本（加上 MEDIA:<url> 行）
    • ✦--json：打印结构化负载 + 元数据
  • ✦可选使用 --deliver + --channel 将回复投递回渠道（目标格式与 openclaw message --target 匹配）。
  • ✦使用 --reply-channel/--reply-to/--reply-account 覆盖投递而不更改会话。
如果 Gateway 网关不可达，CLI 会回退到嵌入式本地运行。

示例

bash
openclaw agent --to +15555550123 --message "status update"
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --session-id 1234 --message "Summarize inbox" --thinking medium
openclaw agent --to +15555550123 --message "Trace logs" --verbose on --json
openclaw agent --to +15555550123 --message "Summon reply" --deliver
openclaw agent --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"

标志

  • ✦--local：本地运行（需要你的 shell 中有模型提供商 API 密钥）
  • ✦--deliver：将回复发送到所选渠道
  • ✦--channel：投递渠道（whatsapp|telegram|discord|googlechat|slack|signal|imessage，默认：whatsapp）
  • ✦--reply-to：投递目标覆盖
  • ✦--reply-channel：投递渠道覆盖
  • ✦--reply-account：投递账户 ID 覆盖
  • ✦--thinking <off|minimal|low|medium|high|xhigh>：持久化思考级别（仅限 GPT-5.2 + Codex 模型）
  • ✦--verbose <on|full|off>：持久化详细级别
  • ✦--timeout <seconds>：覆盖智能体超时
  • ✦--json：输出结构化 JSON