概述

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

实时传输覆盖矩阵:

通道CanaryMentionBot-to-botAllowlistTop-levelRestartThread
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 — 渠道对接机制