From 7fced7f932b45fc47365fd55d2850e65651e61ac Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Thu, 9 Apr 2026 00:06:09 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/concepts/qa-e2e-automation.md | 68 +++++++------ docs/zh-CN/providers/qwen.md | 122 +++++++++++++---------- 2 files changed, 102 insertions(+), 88 deletions(-) diff --git a/docs/zh-CN/concepts/qa-e2e-automation.md b/docs/zh-CN/concepts/qa-e2e-automation.md index 323c8ad39..d88c0401d 100644 --- a/docs/zh-CN/concepts/qa-e2e-automation.md +++ b/docs/zh-CN/concepts/qa-e2e-automation.md @@ -2,31 +2,31 @@ read_when: - 扩展 qa-lab 或 qa-channel 时 - 添加仓库支持的 QA 场景时 - - 围绕 Gateway 网关仪表盘构建更高拟真度的 QA 自动化时 -summary: qa-lab、qa-channel、种子场景和协议报告的私有 QA 自动化形态 + - 围绕 Gateway 网关仪表板构建更高拟真度的 QA 自动化时 +summary: 用于 qa-lab、qa-channel、种子场景和协议报告的私有 QA 自动化形态 title: QA 端到端自动化 x-i18n: - generated_at: "2026-04-08T19:11:03Z" + generated_at: "2026-04-09T00:06:04Z" model: gpt-5.4 provider: openai - source_hash: 89889f3d2ed06029f2c6b023f7207c007615d5dca5468f7a1a84d3b195fcf36f + source_hash: 6ee5f55b98e46d1cd0b7ffdea96b0c8b5c1681803c69bdbcbe10dae14e62182b source_path: concepts/qa-e2e-automation.md workflow: 15 --- # QA 端到端自动化 -私有 QA 技术栈旨在以比单个单元测试更贴近真实渠道形态的方式来验证 OpenClaw。 +私有 QA 栈旨在以比单个单元测试更贴近真实渠道形态的方式来验证 OpenClaw。 -当前组成部分： +当前包含的部分： -- `extensions/qa-channel`：合成消息渠道，支持私信、渠道、线程、表情回应、编辑和删除等表面能力。 -- `extensions/qa-lab`：调试器 UI 和 QA 总线，用于观察对话记录、注入入站消息，以及导出 Markdown 报告。 -- `qa/`：为启动任务和基线 QA 场景提供的仓库支持种子资源。 +- `extensions/qa-channel`：合成消息渠道，具有私信、channel、thread、reaction、edit 和 delete 界面。 +- `extensions/qa-lab`：调试器 UI 和 QA 总线，用于观察对话记录、注入入站消息以及导出 Markdown 报告。 +- `qa/`：为启动任务和基线 QA 场景提供仓库支持的种子资源。 当前的 QA 操作流程是一个双窗格 QA 站点： -- 左侧：带有智能体的 Gateway 网关仪表盘（Control UI）。 +- 左侧：带有智能体的 Gateway 网关仪表板（Control UI）。 - 右侧：QA Lab，显示类 Slack 的对话记录和场景计划。 使用以下命令运行： @@ -35,9 +35,9 @@ x-i18n: pnpm qa:lab:up ``` -该命令会构建 QA 站点，启动基于 Docker 的 Gateway 网关通道，并暴露 QA Lab 页面，操作员或自动化循环可以在其中向智能体分配 QA 任务、观察真实渠道行为，并记录哪些内容有效、失败或仍被阻塞。 +这会构建 QA 站点，启动基于 Docker 的 Gateway 网关通道，并公开 QA Lab 页面，操作人员或自动化循环可以在此为智能体分配 QA 任务、观察真实的渠道行为，并记录哪些内容有效、哪些失败了，或哪些仍然受阻。 -如果你想更快地迭代 QA Lab UI，而不必每次都重建 Docker 镜像，请使用绑定挂载的 QA Lab bundle 启动技术栈： +如果你想更快地迭代 QA Lab UI，而不必每次都重建 Docker 镜像，可通过绑定挂载的 QA Lab bundle 启动该栈： ```bash pnpm openclaw qa docker-build-image @@ -46,7 +46,7 @@ pnpm qa:lab:up:fast pnpm qa:lab:watch ``` -`qa:lab:up:fast` 会让 Docker 服务保持在预构建镜像上运行，并将 `extensions/qa-lab/web/dist` 绑定挂载到 `qa-lab` 容器中。`qa:lab:watch` 会在变更时重建该 bundle，而当 QA Lab 资源哈希发生变化时，浏览器会自动重新加载。 +`qa:lab:up:fast` 会让 Docker 服务基于预构建镜像运行，并将 `extensions/qa-lab/web/dist` 绑定挂载到 `qa-lab` 容器中。`qa:lab:watch` 会在变更时重建该 bundle，当 QA Lab 资源哈希发生变化时，浏览器会自动重新加载。 ## 仓库支持的种子 @@ -55,29 +55,29 @@ pnpm qa:lab:watch - `qa/scenarios/index.md` - `qa/scenarios/*.md` -这些内容有意保存在 git 中，这样 QA 计划对人类和智能体都可见。基线列表应保持足够广泛，以覆盖： +这些内容有意保存在 git 中，以便人类和智能体都能看到 QA 计划。基线列表应足够广泛，以覆盖： -- 私信和渠道聊天 -- 线程行为 +- 私信和 channel 聊天 +- thread 行为 - 消息操作生命周期 - cron 回调 -- 记忆召回 +- memory recall - 模型切换 -- 子智能体交接 +- subagent 交接 - 读取仓库和读取文档 - 一个小型构建任务，例如 Lobster Invaders ## 报告 `qa-lab` 会根据观察到的总线时间线导出 Markdown 协议报告。 -报告应回答以下问题： +报告应回答： - 哪些内容有效 - 哪些内容失败 -- 哪些内容仍被阻塞 -- 值得添加哪些后续场景 +- 哪些内容仍然受阻 +- 哪些后续场景值得添加 -对于角色和风格检查，可在多个实时模型引用上运行同一场景，并编写一份经评判的 Markdown 报告： +对于角色与风格检查，可在多个实时模型引用上运行同一个场景，并编写一份经过评判的 Markdown 报告： ```bash pnpm openclaw qa character-eval \ @@ -88,24 +88,26 @@ pnpm openclaw qa character-eval \ --model minimax/MiniMax-M2.7,thinking=high \ --model zai/glm-5.1,thinking=high \ --model moonshot/kimi-k2.5,thinking=high \ - --model qwen/qwen3.6-plus,thinking=high \ - --model xiaomi/mimo-v2-pro,thinking=high \ + --model qwen/qwen3.5-plus,thinking=high \ --model google/gemini-3.1-pro-preview,thinking=high \ --judge-model openai/gpt-5.4,thinking=xhigh,fast \ --judge-model anthropic/claude-opus-4-6,thinking=high \ - --concurrency 8 \ - --judge-concurrency 8 + --blind-judge-models \ + --concurrency 16 \ + --judge-concurrency 16 ``` -该命令运行的是本地 QA Gateway 网关子进程，而不是 Docker。角色评估场景应通过 `SOUL.md` 设置 persona，然后运行普通用户轮次，例如聊天、工作区帮助和小型文件任务。不应告知候选模型它正在被评估。该命令会保留每次运行的完整对话记录，记录基本运行统计信息，然后要求评审模型在快速模式下使用 `xhigh` 推理，按自然度、氛围和幽默感对这些运行进行排序。候选运行默认使用 `high` thinking，对于支持的 OpenAI 模型则使用 `xhigh`。可使用 `--model provider/model,thinking=` 为特定候选项内联覆盖。`--thinking ` 仍会设置全局回退值，旧版 `--model-thinking ` 形式也会出于兼容性继续保留。 -OpenAI 候选引用默认启用快速模式，以便在提供商支持时使用优先处理。若单个候选项或评审需要覆盖，请内联添加 `,fast`、`,no-fast` 或 `,fast=false`。仅当你想对每个候选模型都强制启用快速模式时，才传入 `--fast`。报告中会记录候选和评审的持续时间，以便进行基准分析，但评审提示会明确说明不要按速度进行排序。 -候选和评审模型运行默认都使用并发度 8。当提供商限制或本地 Gateway 网关压力导致运行噪声过大时，请降低 `--concurrency` 或 `--judge-concurrency`。 -当未传入候选 `--model` 时，角色评估默认使用 +该命令运行的是本地 QA Gateway 网关子进程，而不是 Docker。character eval 场景应通过 `SOUL.md` 设置 persona，然后运行普通用户轮次，例如聊天、工作区帮助和小型文件任务。不应告知候选模型它正在被评估。该命令会保留每份完整对话记录、记录基本运行统计信息，然后让评审模型以 fast 模式和 `xhigh` 推理来按自然度、氛围和幽默感对这些运行进行排序。 +在比较提供商时，请使用 `--blind-judge-models`：评审提示仍会获得每份对话记录和运行状态，但候选引用会被替换为中性标签，例如 `candidate-01`；报告会在解析完成后将排序结果映射回真实引用。 +候选运行默认使用 `high` thinking，而支持该级别的 OpenAI 模型则默认使用 `xhigh`。可通过 `--model provider/model,thinking=` 内联覆盖特定候选项。`--thinking ` 仍会设置全局回退值，而较旧的 `--model-thinking ` 形式则保留用于兼容。 +OpenAI 候选引用默认使用 fast 模式，以便在提供商支持的情况下启用优先处理。当单个候选项或评审需要覆盖时，请内联添加 `,fast`、`,no-fast` 或 `,fast=false`。只有当你想为每个候选模型都强制启用 fast 模式时，才传递 `--fast`。候选和评审的持续时间都会记录在报告中，以便进行基准分析，但评审提示会明确说明不要按速度排序。 +候选模型运行和评审模型运行默认都使用并发数 16。当提供商限制或本地 Gateway 网关压力使运行噪声过大时，请降低 `--concurrency` 或 `--judge-concurrency`。 +当未传递候选 `--model` 时，character eval 默认使用 `openai/gpt-5.4`、`openai/gpt-5.2`、`anthropic/claude-opus-4-6`、 `anthropic/claude-sonnet-4-6`、`minimax/MiniMax-M2.7`、`zai/glm-5.1`、 -`moonshot/kimi-k2.5`、`qwen/qwen3.6-plus`、`xiaomi/mimo-v2-pro` 和 +`moonshot/kimi-k2.5`、`qwen/qwen3.5-plus` 和 `google/gemini-3.1-pro-preview`。 -当未传入 `--judge-model` 时，评审默认使用 +当未传递 `--judge-model` 时，评审默认使用 `openai/gpt-5.4,thinking=xhigh,fast` 和 `anthropic/claude-opus-4-6,thinking=high`。 @@ -113,4 +115,4 @@ OpenAI 候选引用默认启用快速模式，以便在提供商支持时使用 - [测试](/zh-CN/help/testing) - [QA 渠道](/zh-CN/channels/qa-channel) -- [仪表盘](/web/dashboard) +- [仪表板](/web/dashboard) diff --git a/docs/zh-CN/providers/qwen.md b/docs/zh-CN/providers/qwen.md index 4c682256d..2ffd24c6f 100644 --- a/docs/zh-CN/providers/qwen.md +++ b/docs/zh-CN/providers/qwen.md @@ -5,10 +5,10 @@ read_when: summary: 通过 OpenClaw 内置的 qwen 提供商使用 Qwen Cloud title: Qwen x-i18n: - generated_at: "2026-04-05T22:30:18Z" + generated_at: "2026-04-09T00:06:08Z" model: gpt-5.4 provider: openai - source_hash: f175793693ab6a4c3f1f4d42040e673c15faf7603a500757423e9e06977c989d + source_hash: 4786df2cb6ec1ab29d191d012c61dcb0e5468bf0f8561fbbb50eed741efad325 source_path: providers/qwen.md workflow: 15 --- @@ -18,23 +18,23 @@ x-i18n: **Qwen OAuth 已被移除。** 使用 `portal.qwen.ai` 端点的免费层 OAuth 集成 -（`qwen-portal`）现已不可用。背景信息请参见 -[Issue #49557](https://github.com/openclaw/openclaw/issues/49557)。 +（`qwen-portal`）已不再可用。 +背景信息请参见 [Issue #49557](https://github.com/openclaw/openclaw/issues/49557)。 ## 推荐：Qwen Cloud -OpenClaw 现在将 Qwen 视为一个一等内置提供商，其规范 id 为 +OpenClaw 现在将 Qwen 视为一等内置提供商，其规范 id 为 `qwen`。该内置提供商面向 Qwen Cloud / Alibaba DashScope 和 -Coding Plan 端点，并保留旧版 `modelstudio` id 作为兼容性别名。 +Coding Plan 端点，并保留旧版 `modelstudio` id 作为兼容别名。 - 提供商：`qwen` - 首选环境变量：`QWEN_API_KEY` -- 为兼容性也接受：`MODELSTUDIO_API_KEY`、`DASHSCOPE_API_KEY` +- 出于兼容性也接受：`MODELSTUDIO_API_KEY`、`DASHSCOPE_API_KEY` - API 风格：兼容 OpenAI -如果你想使用 `qwen3.6-plus`，优先选择 **Standard（按量付费）** 端点。 +如果你想使用 `qwen3.6-plus`，建议优先选择**标准版（按量付费）**端点。 Coding Plan 支持可能会落后于公开目录。 ```bash @@ -44,14 +44,15 @@ openclaw onboard --auth-choice qwen-api-key # 中国区 Coding Plan 端点 openclaw onboard --auth-choice qwen-api-key-cn -# 全局 Standard（按量付费）端点 +# 全局标准版（按量付费）端点 openclaw onboard --auth-choice qwen-standard-api-key -# 中国区 Standard（按量付费）端点 +# 中国区标准版（按量付费）端点 openclaw onboard --auth-choice qwen-standard-api-key-cn ``` -旧版 `modelstudio-*` auth-choice id 和 `modelstudio/...` 模型引用仍然可作为兼容性别名使用，但新的设置流程应优先使用规范的 +旧版 `modelstudio-*` auth-choice id 和 `modelstudio/...` 模型引用仍然 +可作为兼容别名继续使用，但新的设置流程应优先使用规范的 `qwen-*` auth-choice id 和 `qwen/...` 模型引用。 完成新手引导后，设置默认模型： @@ -66,20 +67,23 @@ openclaw onboard --auth-choice qwen-standard-api-key-cn } ``` -## 计划类型和端点 +## 套餐类型和端点 -| 计划 | 区域 | Auth choice | 端点 | +| 套餐 | 区域 | Auth choice | 端点 | | -------------------------- | ------ | -------------------------- | ------------------------------------------------ | -| Standard（按量付费） | 中国区 | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1` | -| Standard（按量付费） | 全球 | `qwen-standard-api-key` | `dashscope-intl.aliyuncs.com/compatible-mode/v1` | +| 标准版（按量付费） | 中国区 | `qwen-standard-api-key-cn` | `dashscope.aliyuncs.com/compatible-mode/v1` | +| 标准版（按量付费） | 全球 | `qwen-standard-api-key` | `dashscope-intl.aliyuncs.com/compatible-mode/v1` | | Coding Plan（订阅制） | 中国区 | `qwen-api-key-cn` | `coding.dashscope.aliyuncs.com/v1` | | Coding Plan（订阅制） | 全球 | `qwen-api-key` | `coding-intl.dashscope.aliyuncs.com/v1` | -该提供商会根据你的 auth choice 自动选择端点。规范选项使用 -`qwen-*` 系列；`modelstudio-*` 仅保留用于兼容。你也可以在配置中使用自定义 -`baseUrl` 进行覆盖。 +该提供商会根据你的 auth choice 自动选择端点。规范选择使用 +`qwen-*` 系列；`modelstudio-*` 仅保留为兼容用途。 +你也可以在配置中使用自定义 `baseUrl` 进行覆盖。 -原生 Model Studio 端点会在共享的 `openai-completions` 传输协议上声明流式使用兼容性。OpenClaw 现在基于端点能力来判断这一点，因此，指向相同原生主机的兼容 DashScope 的自定义提供商 id 也会继承相同的流式使用行为，而不再要求必须使用内置的 `qwen` 提供商 id。 +原生 Model Studio 端点会在共享的 `openai-completions` 传输协议上声明 +流式使用兼容性。OpenClaw 现在会根据端点能力来判断这一点，因此，指向相同原生主机的 +兼容 DashScope 的自定义提供商 id 也会继承相同的流式使用行为，而不再要求必须使用 +内置的 `qwen` 提供商 id。 ## 获取你的 API 密钥 @@ -88,24 +92,25 @@ openclaw onboard --auth-choice qwen-standard-api-key-cn ## 内置目录 -OpenClaw 当前内置了以下 Qwen 目录： +OpenClaw 当前内置了以下 Qwen 目录。配置后的目录具备端点感知能力： +Coding Plan 配置会省略那些目前只确认可在标准版端点上正常工作的模型。 | 模型引用 | 输入 | 上下文 | 说明 | | --------------------------- | ----------- | --------- | -------------------------------------------------- | | `qwen/qwen3.5-plus` | text, image | 1,000,000 | 默认模型 | -| `qwen/qwen3.6-plus` | text, image | 1,000,000 | 需要此模型时优先选择 Standard 端点 | -| `qwen/qwen3-max-2026-01-23` | text | 262,144 | Qwen Max 产品线 | -| `qwen/qwen3-coder-next` | text | 262,144 | 编码 | -| `qwen/qwen3-coder-plus` | text | 1,000,000 | 编码 | +| `qwen/qwen3.6-plus` | text, image | 1,000,000 | 需要该模型时建议使用标准版端点 | +| `qwen/qwen3-max-2026-01-23` | text | 262,144 | Qwen Max 系列 | +| `qwen/qwen3-coder-next` | text | 262,144 | 编程 | +| `qwen/qwen3-coder-plus` | text | 1,000,000 | 编程 | | `qwen/MiniMax-M2.5` | text | 1,000,000 | 已启用推理 | | `qwen/glm-5` | text | 202,752 | GLM | | `qwen/glm-4.7` | text | 202,752 | GLM | -| `qwen/kimi-k2.5` | text, image | 262,144 | Alibaba 上的 Moonshot AI | +| `qwen/kimi-k2.5` | text, image | 262,144 | Moonshot AI，经由 Alibaba | -即使某个模型已存在于内置目录中，具体可用性仍可能因端点和计费计划而异。 +即使某个模型出现在内置目录中，其可用性仍可能因端点和计费套餐而异。 -原生流式使用兼容性同时适用于 Coding Plan 主机和 Standard 的 -DashScope 兼容主机： +原生流式传输使用兼容性同时适用于 Coding Plan 主机和 +标准版兼容 DashScope 的主机： - `https://coding.dashscope.aliyuncs.com/v1` - `https://coding-intl.dashscope.aliyuncs.com/v1` @@ -114,52 +119,56 @@ DashScope 兼容主机： ## Qwen 3.6 Plus 可用性 -`qwen3.6-plus` 可用于 Standard（按量付费）Model Studio 端点： +`qwen3.6-plus` 可在标准版（按量付费）Model Studio +端点上使用： - 中国区：`dashscope.aliyuncs.com/compatible-mode/v1` - 全球：`dashscope-intl.aliyuncs.com/compatible-mode/v1` -如果 Coding Plan 端点对 `qwen3.6-plus` 返回“unsupported model”错误，请切换到 Standard（按量付费），而不是继续使用 Coding Plan 端点/密钥组合。 +如果 Coding Plan 端点对 `qwen3.6-plus` 返回“unsupported model”错误， +请切换到标准版（按量付费），而不是继续使用 Coding Plan +端点 / 密钥组合。 -## 能力计划 +## 能力规划 -`qwen` 扩展正被定位为完整 Qwen Cloud 能力面的供应商归属地，而不仅仅是编码/文本模型。 +`qwen` 扩展正被定位为完整 Qwen +Cloud 能力面的厂商归属地，而不仅仅是编程 / 文本模型。 -- 文本/聊天模型：现已内置 -- 工具调用、结构化输出、思维链：继承自兼容 OpenAI 的传输协议 +- 文本 / 聊天模型：现已内置 +- 工具调用、结构化输出、思考：继承自兼容 OpenAI 的传输协议 - 图像生成：计划在提供商插件层实现 -- 图像/视频理解：现已在 Standard 端点内置 -- 语音/音频：计划在提供商插件层实现 -- 记忆嵌入/重排序：计划通过嵌入适配器能力面提供 -- 视频生成：现已通过共享的视频生成能力内置 +- 图像 / 视频理解：现已在标准版端点内置 +- 语音 / 音频：计划在提供商插件层实现 +- 记忆嵌入 / 重排序：计划通过嵌入适配器能力面提供 +- 视频生成：现已通过共享视频生成能力内置 -## 多模态附加功能 +## 多模态附加能力 `qwen` 扩展现在还提供： -- 通过 `qwen-vl-max-latest` 提供视频理解 -- 通过以下模型提供 Wan 视频生成： +- 通过 `qwen-vl-max-latest` 实现视频理解 +- 通过以下模型实现 Wan 视频生成： - `wan2.6-t2v`（默认） - `wan2.6-i2v` - `wan2.6-r2v` - `wan2.6-r2v-flash` - `wan2.7-r2v` -这些多模态能力面使用的是 **Standard** DashScope 端点，而不是 +这些多模态能力面使用的是**标准版** DashScope 端点，而不是 Coding Plan 端点。 -- 全球/国际版 Standard base URL：`https://dashscope-intl.aliyuncs.com/compatible-mode/v1` -- 中国区 Standard base URL：`https://dashscope.aliyuncs.com/compatible-mode/v1` +- 全球 / 国际版标准 base URL：`https://dashscope-intl.aliyuncs.com/compatible-mode/v1` +- 中国区标准 base URL：`https://dashscope.aliyuncs.com/compatible-mode/v1` 对于视频生成，OpenClaw 会先将已配置的 Qwen 区域映射到对应的 DashScope AIGC 主机，然后再提交任务： -- 全球/国际版：`https://dashscope-intl.aliyuncs.com` +- 全球 / 国际版：`https://dashscope-intl.aliyuncs.com` - 中国区：`https://dashscope.aliyuncs.com` -这意味着，普通的 `models.providers.qwen.baseUrl` 即使指向 -Coding Plan 或 Standard Qwen 主机之一，视频生成仍会使用正确区域的 -DashScope 视频端点。 +这意味着，正常的 `models.providers.qwen.baseUrl` 即使指向 +Coding Plan 或标准版 Qwen 主机之一，视频生成仍会使用正确的 +区域 DashScope 视频端点。 对于视频生成，请显式设置默认模型： @@ -173,19 +182,22 @@ DashScope 视频端点。 } ``` -当前内置的 Qwen 视频生成限制： +当前内置 Qwen 视频生成限制： -- 每个请求最多 **1** 个输出视频 -- 最多 **1** 张输入图片 +- 每次请求最多 **1** 个输出视频 +- 最多 **1** 张输入图像 - 最多 **4** 个输入视频 - 最长 **10 秒** 时长 - 支持 `size`、`aspectRatio`、`resolution`、`audio` 和 `watermark` -- 参考图片/视频模式当前要求使用 **远程 http(s) URL**。本地文件路径会在前置校验时被拒绝，因为 DashScope 视频端点不接受为这些引用上传本地缓冲区。 +- 参考图像 / 视频模式当前要求使用**远程 http(s) URL**。本地 + 文件路径会被预先拒绝，因为 DashScope 视频端点不接受这些参考内容的 + 本地缓冲区上传。 -有关共享工具参数、提供商选择和故障切换行为，请参见 [视频生成](/zh-CN/tools/video-generation)。 +有关共享工具参数、提供商选择和故障转移行为，请参见 +[Video Generation](/zh-CN/tools/video-generation)。 ## 环境说明 -如果 Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 -`QWEN_API_KEY` 对该进程可用（例如放在 `~/.openclaw/.env` 中，或通过 +如果 Gateway 网关 以守护进程（launchd/systemd）方式运行，请确保 `QWEN_API_KEY` +可被该进程访问（例如放在 `~/.openclaw/.env` 中，或通过 `env.shellEnv` 提供）。