openclaw agent（直接运行 Agent）

openclaw agent 可以直接运行一次 Agent 对话，不需要接收聊天消息触发。 默认情况下会通过 Gateway 运行；加上 --local 参数可以强制在当前机器上使用内嵌的 Runtime。

行为说明

  • 必需参数：--message <text>
  • Session 选择方式：
    • --to <dest> 自动推导 session key（群组/频道目标保持隔离；私聊会合并到 main），或者
    • --session-id <id> 通过 id 复用现有 session，或者
    • --agent <id> 直接指定配置好的 agent（使用该 agent 的 main session key）
  • 运行的 Agent Runtime 和正常接收消息时一样。
  • Thinking/verbose 标志会持久化到 session 存储中。
  • 输出方式：
    • 默认：打印回复文本（加上 MEDIA:<url> 行）
    • --json：打印结构化的 payload + 元数据
  • 可选：用 --deliver + --channel 把回复发送回某个 Channel（目标格式和 openclaw message --target 一致）。
  • 用 --reply-channel/--reply-to/--reply-account 可以覆盖发送目标，但不改变 session。

如果 Gateway 无法访问，CLI 会自动降级到本地内嵌运行。

示例

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 keys）
  • --deliver：把回复发送到指定 channel
  • --channel：发送目标 channel（whatsapp|telegram|discord|googlechat|slack|signal|imessage，默认：whatsapp）
  • --reply-to：覆盖发送目标
  • --reply-channel：覆盖发送 channel
  • --reply-account：覆盖发送账号 id
  • --thinking <off|minimal|low|medium|high|xhigh>：持久化 thinking 级别（仅 GPT-5.2 + Codex 模型支持）
  • --verbose <on|full|off>：持久化 verbose 级别
  • --timeout <seconds>：覆盖 agent 超时时间
  • --json：输出结构化 JSON