QA channel

qa-channel 是用于自动化 OpenClaw QA 的仓库本地合成消息传输（extensions/qa-channel，私有软件包，不包含在打包安装中）。它不是生产渠道，而是用于通过真实传输所使用的同一渠道插件边界进行测试，同时确保状态具有确定性且完全可检查。

功能

• 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 - 目标语法中使用的合成机器人用户 ID（默认值：openclaw）。
• botDisplayName - 出站消息的显示名称（默认值：OpenClaw QA）。
• pollTimeoutMs - 长轮询等待窗口。介于 100 和 30000 之间的整数（默认值：1000）。
• allowFrom - 发送者允许列表（用户 ID 或 "*"；默认值：["*"]）。私信始终采用 open 策略；采用允许列表的群组策略也使用这些合成 发送者 ID。
• groupPolicy - 共享房间策略："open"（默认值）、"allowlist" 或 "disabled"。
• groupAllowFrom - 可选的共享房间发送者允许列表。在 "allowlist" 下省略时，QA Channel 会回退到 allowFrom。
• groups.<room>.requireMention - 在特定群组/频道房间中回复前要求提及机器人 （默认值：false）。groups."*" 设置默认值； 每个房间的 tools / toolsBySender 设置工具策略覆盖项。
• defaultTo - 未提供目标时使用的后备目标。
• actions.messages / actions.reactions / actions.search / actions.threads - 按操作控制工具使用。

顶层多账户键：

• accounts - 以账户 ID 为键的具名账户级覆盖项记录。
• defaultAccount - 配置多个账户时的首选账户 ID。

运行程序

主机端自检（将 Markdown 报告写入 .artifacts/qa-e2e/ 下）：

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 软件包。

相关内容

• QA overview - 整体堆栈、传输适配器、Matrix 配置文件和场景编写
• 配对
• 群组
• 渠道概览