chore(i18n): refresh zh-CN translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-09 00:06:09 +00:00
parent a004031785
commit 7fced7f932
2 changed files with 102 additions and 88 deletions

View File

@ -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=<level>` 为特定候选项内联覆盖。`--thinking <level>` 仍会设置全局回退值,旧版 `--model-thinking <provider/model=level>` 形式也会出于兼容性继续保留。
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=<level>` 内联覆盖特定候选项。`--thinking <level>` 仍会设置全局回退值,而较旧的 `--model-thinking <provider/model=level>` 形式则保留用于兼容。
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)

View File

@ -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:
<Warning>
**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)。
</Warning>
## 推荐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` 提供)。