Moltbot/docs/zh-CN/tools/agent-send.md

read_when, summary, title, x-i18n

read_when	summary	title	x-i18n
添加或修改智能体 CLI 入口点	直接通过 `openclaw agent` CLI 运行（支持可选的消息投递）	智能体发送	generated_at model provider source_hash source_path workflow 2026-02-01T21:39:16Z claude-opus-4-5 pi a84d6a304333eebe155da2bf24cf5fc0482022a0a48ab34aa1465cd6e667022d tools/agent-send.md 15

openclaw agent（直接运行智能体）

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

行为

• 必需：--message <text>
• 会话选择：
  • --to <dest> 推导会话密钥（群组/渠道目标保持隔离；直接聊天合并为 main），或
  • --session-id <id> 通过 id 复用现有会话，或
  • --agent <id> 直接指向已配置的智能体（使用该智能体的 main 会话密钥）
• 运行与正常入站回复相同的嵌入式智能体运行时。
• thinking/verbose 标志会持久化到会话存储中。
• 输出：
  • 默认：打印回复文本（加上 MEDIA:<url> 行）
  • --json：打印结构化载荷 + 元数据
• 可选通过 --deliver + --channel 将回复投递回渠道（目标格式与 openclaw message --target 一致）。
• 使用 --reply-channel/--reply-to/--reply-account 可在不改变会话的情况下覆盖投递设置。

如果 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 密钥）
• --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