快速开始

QA channel

qa-channel 是用于自动化 OpenClaw QA 的内置合成消息传输协议。它不是生产渠道,而是为了在保持状态确定且完全可检查的同时,演练真实传输协议使用的同一渠道插件边界。

它的作用

  • Slack 类目标语法:
    • dm:<user>
    • channel:<room>
    • group:<room>
    • thread:<room>/<thread>
  • 共享的 channel:group: 对话会作为群组/渠道房间轮次暴露给智能体,因此它们会演练 Discord、Slack、Telegram 和类似传输协议使用的同一可见回复与消息工具路由策略。
  • 基于 HTTP 的合成总线,用于入站消息注入、出站转录捕获、线程创建、回应、编辑、删除以及搜索/读取操作。
  • 主机侧自检运行器,会将 Markdown 报告写入 .artifacts/qa-e2e/

配置

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

账号键名:

  • enabled - 此账号的主开关。
  • name - 可选显示标签。
  • baseUrl - 合成总线 URL。
  • botUserId - 目标语法中使用的 Matrix 风格机器人用户 ID。
  • botDisplayName - 出站消息的显示名称。
  • pollTimeoutMs - 长轮询等待窗口。介于 100 和 30000 之间的整数。
  • allowFrom - 发送者允许列表(用户 ID 或 "*")。
  • defaultTo - 未提供目标时的回退目标。
  • actions.messages / actions.reactions / actions.search / actions.threads - 按操作控制的工具门控。

顶层多账号键名:

  • accounts - 按账号 ID 索引的命名账号级覆盖项记录。
  • defaultAccount - 配置多个账号时的首选账号 ID。

运行器

主机侧自检(在 .artifacts/qa-e2e/ 下写入 Markdown 报告):

pnpm qa:e2e

这会通过 qa-lab 路由,启动仓库内 QA 总线,引导内置 qa-channel 运行时切片,并运行确定性的自检。

完整的仓库支持场景套件:

pnpm openclaw qa suite

会针对 QA Gateway 网关通道并行运行场景。场景、配置集和提供商模式请参阅 QA overview

基于 Docker 的 QA 站点(Gateway 网关 + QA Lab 调试器 UI 位于同一个栈中):

pnpm qa:lab:up

构建 QA 站点,启动基于 Docker 的 Gateway 网关 + QA Lab 栈,并打印 QA Lab URL。随后你可以选择场景、选择模型通道、启动单次运行,并实时查看结果。QA Lab 调试器与已发布的 Control UI 包相互独立。

相关内容