跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw agent

通过 Gateway 网关运行一个智能体轮次（嵌入式模式使用 --local）。 使用 --agent <id> 直接指定已配置的智能体。 至少传入一个会话选择器：
  • --to <dest>
  • --session-id <id>
  • --agent <id>
相关：

​
选项

  • -m, --message <text>：必需的消息正文
  • -t, --to <dest>：用于派生会话键的接收方
  • --session-id <id>：显式会话 ID
  • --agent <id>：智能体 ID；覆盖路由绑定
  • --model <id>：本次运行的模型覆盖项（provider/model 或模型 ID）
  • --thinking <level>：智能体思考级别（off、minimal、low、medium、high，以及提供商支持的自定义级别，例如 xhigh、adaptive 或 max）
  • --verbose <on|off>：为该会话持久化详细级别
  • --channel <channel>：投递渠道；省略时使用主会话渠道
  • --reply-to <target>：投递目标覆盖项
  • --reply-channel <channel>：投递渠道覆盖项
  • --reply-account <id>：投递账号覆盖项
  • --local：直接运行嵌入式智能体（在插件注册表预加载之后）
  • --deliver：将回复发送回所选渠道/目标
  • --timeout <seconds>：覆盖智能体超时时间（默认 600 或配置值）
  • --json：输出 JSON

​
示例

openclaw agent --to +15555550123 --message "status update" --deliver
openclaw agent --agent ops --message "Summarize logs"
openclaw agent --agent ops --model openai/gpt-5.4 --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 --agent ops --message "Generate report" --deliver --reply-channel slack --reply-to "#reports"
openclaw agent --agent ops --message "Run locally" --local

​
说明

  • Gateway 网关模式会在 Gateway 网关请求失败时回退到嵌入式智能体。使用 --local 可从一开始就强制执行嵌入式运行。
  • --local 仍会先预加载插件注册表，因此插件提供的提供商、工具和渠道在嵌入式运行期间仍然可用。
  • --local 和嵌入式回退运行会被视为一次性运行。为该本地进程打开的内置 MCP loopback 资源和预热的 Claude stdio 会话会在回复后被回收，因此脚本调用不会让本地子进程保持运行。
  • 由 Gateway 网关支持的运行会把 Gateway 网关拥有的 MCP loopback 资源留在正在运行的 Gateway 网关进程下；较旧的客户端可能仍会发送历史清理标志，但 Gateway 网关会将其作为兼容性空操作接受。
  • --channel、--reply-channel 和 --reply-account 影响回复投递，而不是会话路由。
  • --json 会保留 stdout 专用于 JSON 响应。Gateway 网关、插件和嵌入式回退诊断会路由到 stderr，因此脚本可以直接解析 stdout。
  • 嵌入式回退 JSON 包含 meta.transport: "embedded" 和 meta.fallbackFrom: "gateway"，因此脚本可以将回退运行与 Gateway 网关运行区分开。
  • 如果 Gateway 网关接受了智能体运行，但 CLI 在等待最终回复时超时，嵌入式回退会使用新的显式 gateway-fallback-* 会话/运行 ID，并报告 meta.fallbackReason: "gateway_timeout" 以及回退会话字段。这样可避免与 Gateway 网关拥有的转录锁竞争，或静默替换原始路由会话。
  • 当此命令触发 models.json 重新生成时，由 SecretRef 管理的提供商凭据会以非秘密标记形式持久化（例如环境变量名称、secretref-env:ENV_VAR_NAME 或 secretref-managed），而不是解析后的秘密明文。
  • 标记写入以来源为权威：OpenClaw 会从活跃来源配置快照持久化标记，而不是从已解析的运行时秘密值持久化。

​
相关