测试
OpenClaw 拥有三套 Vitest 测试套件（单元/集成、e2e、live），外加 Docker 运行器。本页介绍每套测试套件覆盖的内容、针对特定工作流应运行哪条命令、live 测试如何发现凭据，以及如何为真实世界的 provider/model 缺陷添加回归测试。
Note
QA 技术栈（qa-lab、qa-channel、live 传输通道） 在另外的文档中介绍：
- QA 概览 - 架构、命令面、场景编写，以及 Matrix live 通道。
- 成熟度记分卡 - 发布 QA 证据如何支持稳定性和 LTS 决策。
- QA 通道 - 用于基于 repo 场景的合成传输插件。
本页涵盖常规测试套件以及 Docker/Parallels 运行器。下面的 QA 专用运行器 列出具体的 qa 命令，并指向上述参考资料。
本页是一个索引。测试工具集分为六个页面进行说明，每个页面对应一种读者职责。请打开与你的任务匹配的页面。
| 页面 | 阅读时机 |
|---|---|
| 测试套件与命令 | 你需要选择测试套件、命令或离线回归检查。 |
| Live 与 Docker/Parallels 工作流 | 你正在通过 live Docker 或 Parallels 通道调试真实 provider 或 model。 |
| Docker 测试运行器 | 你需要 Docker 的“works in Linux”通道、其调度器及其环境变量。 |
| QA 专用运行器 | 你正在运行 QA Lab 通道，或需要共享的 Convex 凭据契约。 |
| 契约测试 | 你更改了 channel、provider 或 plugin-sdk 的接口。 |
| 编写与添加测试 | 你正在编写测试、回归测试或可靠性评估。 |
各章节移动到了哪里¶
之前单页版本中的每个章节标题在这里都保留其锚点，因此诸如 /help/testing#qa-specific-runners 之类的现有链接仍然有效。每一项都指向当前承载相应内容的页面。
- 快速开始
- 测试临时目录
- Live 与 Docker/Parallels 工作流
- QA 专用运行器
- 通过 Convex 共享 Telegram 凭据（v1）
- 将 channel 添加到 QA
- 测试套件（在哪里运行什么）
- 单元 / 集成（默认）
- 项目、分片与作用域通道
- 嵌入式运行器覆盖
- Vitest 池与隔离默认值
- 快速本地迭代
- 性能调试
- 稳定性（网关）
- E2E（仓库聚合）
- E2E（网关冒烟）
- E2E（Control UI 模拟浏览器）
- E2E：OpenShell 后端冒烟
- Live（真实 provider + 真实 model）
- 我应该运行哪个套件？
- Live（触碰网络的）测试
- Docker 运行器（可选的“works in Linux”检查）
- 文档健全性检查
- 离线回归（CI 安全）
- Agent 可靠性评估（技能）
- 契约测试（plugin 与 channel 形态）
- 命令
- Channel 契约
- Provider 契约
- 何时运行
- 添加回归测试（指南）
相关¶
- 实时测试
- 测试更新与插件
- CI
- OpenClaw 代理运行时工作流 - 针对
src/agents/中代理运行时代码的构建、测试和实时验证循环
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw