Agent 发送

​

快速开始

openclaw agent --agent main --message "What is the weather today?"

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

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

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

# 复用一个现有会话
openclaw agent --session-id abc123 --message "继续任务"

# 目标指定一个精确的 session key
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 必须与该 agent id 匹配。裸的非哨兵键在提供 --agent 时会限定到 --agent；例如，--agent ops --session-key incident-42 会路由到 agent:ops:incident-42。如果没有 --agent，裸的非哨兵键会限定到已配置的默认代理。字面量 global 和 unknown 仅在未提供 --agent 时才保持不限定范围。
• --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

# 精确 session key
openclaw agent --session-key agent:ops:incident-42 --message "总结状态"

# 限定到某个 agent 的旧式 key
openclaw agent --agent ops --session-key incident-42 --message "总结状态"

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

​

相关内容