5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
61 lines
2.6 KiB
Markdown
61 lines
2.6 KiB
Markdown
---
|
||
read_when:
|
||
- 添加或修改智能体 CLI 入口点
|
||
summary: 直接通过 `openclaw agent` CLI 运行（支持可选的消息投递）
|
||
title: 智能体发送
|
||
x-i18n:
|
||
generated_at: "2026-02-01T21:39:16Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: a84d6a304333eebe155da2bf24cf5fc0482022a0a48ab34aa1465cd6e667022d
|
||
source_path: tools/agent-send.md
|
||
workflow: 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 会**回退**到嵌入式本地运行。
|
||
|
||
## 示例
|
||
|
||
```bash
|
||
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
|