Agent 发送

​

快速开始

openclaw agent --agent main --message "今天天气如何？"

openclaw agent --agent ops --message-file ./task.md

# 指定智能体
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"

​

标志

​

行为

• 默认情况下，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"

​

相关内容