Skip to content

QA 渠道(qa-channel)

qa-channel 是用于自动化 OpenClaw QA 测试的内置合成消息传输渠道。

它不是生产渠道。它的存在是为了在保持状态完全可确定、可检查的同时,使用与真实渠道插件相同的渠道插件边界进行测试。

当前功能

  • Slack 格式的目标语法:
    • dm:<user>
    • channel:<room>
    • thread:<room>/<thread>
  • HTTP 驱动的合成总线,支持:
    • 入站消息注入
    • 出站转录捕获
    • 线程创建、消息回应、编辑、删除
    • 搜索和读取操作
  • 内置宿主侧自检运行器,输出 Markdown 报告

配置

json
{
  "channels": {
    "qa-channel": {
      "baseUrl": "http://127.0.0.1:43123",
      "botUserId": "openclaw",
      "botDisplayName": "OpenClaw QA",
      "allowFrom": ["*"],
      "pollTimeoutMs": 1000
    }
  }
}

支持的配置项:

  • baseUrl — QA 总线的 HTTP 地址
  • botUserId — bot 的用户 ID
  • botDisplayName — bot 的显示名
  • pollTimeoutMs — 轮询超时(毫秒)
  • allowFrom — 允许触发的用户列表(["*"] 表示全部允许)
  • defaultTo — 默认投递目标
  • actions.messages / actions.reactions / actions.search / actions.threads — 各操作开关

运行测试

基础端到端测试(通过内置 qa-lab 扩展):

bash
pnpm qa:e2e

启动 QA 总线、运行确定性自检,并在 .artifacts/qa-e2e/ 下生成 Markdown 报告。

私有调试 UI:

bash
pnpm qa:lab:build
pnpm openclaw qa ui

完整 QA 测试套件:

bash
pnpm openclaw qa suite

在本地 URL 启动私有 QA 调试器(与生产 Control UI 独立)。

适用场景

  • 在 CI/CD 环境中验证渠道插件边界
  • 搭建可重现的端到端测试场景
  • 迭代自动化 QA 流程

相关文档