From 09370e98837fa77be11a440f9792e5ce242e9a99 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Wed, 29 Apr 2026 18:42:55 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/cli/agent.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/docs/zh-CN/cli/agent.md b/docs/zh-CN/cli/agent.md index 00db5e4dc..d1dc98c30 100644 --- a/docs/zh-CN/cli/agent.md +++ b/docs/zh-CN/cli/agent.md @@ -1,21 +1,21 @@ --- read_when: - - 你想从脚本运行一轮智能体（可选发送回复） + - 你想通过脚本运行一次智能体轮次（可选择发送回复） summary: '`openclaw agent` 的 CLI 参考（通过 Gateway 网关发送一个智能体轮次）' title: 智能体 x-i18n: - generated_at: "2026-04-28T11:46:59Z" + generated_at: "2026-04-29T18:42:32Z" model: gpt-5.5 provider: openai - source_hash: e9a8772cc6387fda6084856868516160507877fb2dcdadfc130284a8dec44913 + source_hash: b77668949040933c5281f2f183e48cc2593d09252470483b9ae38dcffd13d071 source_path: cli/agent.md workflow: 16 --- # `openclaw agent` -通过 Gateway 网关运行一次智能体回合（嵌入式使用 `--local`）。 -使用 `--agent ` 直接指定一个已配置的智能体。 +通过 Gateway 网关运行一个智能体轮次（嵌入式模式使用 `--local`）。 +使用 `--agent ` 直接指定已配置的智能体。 至少传入一个会话选择器： @@ -23,7 +23,7 @@ x-i18n: - `--session-id ` - `--agent ` -相关内容： +相关： - 智能体发送工具：[智能体发送](/zh-CN/tools/agent-send) @@ -35,7 +35,7 @@ x-i18n: - `--agent `：智能体 ID；覆盖路由绑定 - `--model `：本次运行的模型覆盖项（`provider/model` 或模型 ID） - `--thinking `：智能体思考级别（`off`、`minimal`、`low`、`medium`、`high`，以及提供商支持的自定义级别，例如 `xhigh`、`adaptive` 或 `max`） -- `--verbose `：为会话持久化详细级别 +- `--verbose `：为该会话持久化详细级别 - `--channel `：投递渠道；省略时使用主会话渠道 - `--reply-to `：投递目标覆盖项 - `--reply-channel `：投递渠道覆盖项 @@ -57,19 +57,20 @@ openclaw agent --agent ops --message "Generate report" --deliver --reply-channel openclaw agent --agent ops --message "Run locally" --local ``` -## 注意事项 +## 说明 -- 当 Gateway 网关请求失败时，Gateway 网关模式会回退到嵌入式智能体。使用 `--local` 可在一开始就强制执行嵌入式运行。 +- Gateway 网关模式会在 Gateway 网关请求失败时回退到嵌入式智能体。使用 `--local` 可从一开始就强制执行嵌入式运行。 - `--local` 仍会先预加载插件注册表，因此插件提供的提供商、工具和渠道在嵌入式运行期间仍然可用。 -- `--local` 和嵌入式回退运行会被视为一次性运行。为该本地进程打开的内置 MCP loopback 资源和预热的 Claude stdio 会话会在回复后被释放，因此脚本化调用不会让本地子进程持续存活。 -- 由 Gateway 网关支持的运行会将 Gateway 网关拥有的 MCP loopback 资源留在正在运行的 Gateway 网关进程下；较旧的客户端可能仍会发送历史清理标志，但 Gateway 网关会将其作为兼容性的无操作接受。 +- `--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 网关运行。 -- 当此命令触发 `models.json` 重新生成时，由 SecretRef 管理的提供商凭据会以非密钥标记持久化（例如环境变量名称、`secretref-env:ENV_VAR_NAME` 或 `secretref-managed`），而不是解析后的密钥明文。 -- 标记写入以源为权威：OpenClaw 会从活动源配置快照持久化标记，而不是从解析后的运行时密钥值持久化。 +- 嵌入式回退 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 会从活跃来源配置快照持久化标记，而不是从已解析的运行时秘密值持久化。 -## 相关内容 +## 相关 - [CLI 参考](/zh-CN/cli) - [智能体运行时](/zh-CN/concepts/agent)