概述
OpenClaw 私有 QA 栈以比单元测试更真实的 channel 形态来验证系统行为。包含合成 channel(qa-channel)、调试 UI(qa-lab)、实时传输通道(Matrix/Telegram/Discord/Slack)和 Mantis 可视化验证系统。
核心要点
- 统一命令入口:所有 QA 流程通过
pnpm openclaw qa <subcommand>运行 - 四个主要组件:
qa-channel(合成消息 channel)、qa-lab(调试 UI 和 QA bus)、实时传输适配器(Matrix/Telegram/Discord/Slack)、qa/仓库支持的场景文件 - 实时传输契约:Matrix、Telegram、Discord、Slack 共享一个契约检查清单(canary、mention gating、bot-to-bot、allowlist block、top-level reply、restart resume、thread follow-up 等)
- 两种 mock 通道:
mock-openai(场景感知,默认确定性 mock)、aimock(AIMock 支持,实验性协议/混沌覆盖) - 场景文件:存于
qa/scenarios/,按产品能力分组,包含元数据、文档引用、可执行qa-flow - 并发执行:
qa-channel默认并发 4,可用--concurrency调整
配置/使用
常用命令:
pnpm openclaw qa run # 内置 QA 自检
pnpm openclaw qa suite # 运行仓库支持的场景
pnpm openclaw qa matrix --profile fast --fail-fast # Matrix 实时通道
pnpm openclaw qa telegram # Telegram 实时通道
pnpm openclaw qa discord # Discord 实时通道
pnpm openclaw qa slack # Slack 实时通道
pnpm openclaw qa coverage # 打印场景覆盖清单
pnpm openclaw qa ui # 启动 QA 调试 UI实时传输覆盖矩阵:
| 通道 | Canary | Mention | Bot-to-bot | Allowlist | Top-level | Restart | Thread |
|---|---|---|---|---|---|---|---|
| Matrix | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Telegram | ✓ | ✓ | ✓ | ||||
| Discord | ✓ | ✓ | ✓ | ||||
| Slack | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Convex 凭证池(共享实时传输凭证):
pnpm openclaw qa credentials doctor # 检查凭证池
pnpm openclaw qa credentials add --kind slack --payload-file creds.json
pnpm openclaw qa credentials list --kind slack --status all --json相关页面
- mantis — 实时传输 Bug 的 Before/After 验证
- qa-matrix — Matrix QA 专项(Docker 支持的 Tuwunel 服务器)
- mantis-slack-desktop-runbook — Slack 桌面 QA 操作手册
- concepts/channel-docking — 渠道对接机制