OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

快速开始

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/。

配置

json
{  "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/）：

bash
pnpm qa:e2e

此命令通过 qa-lab 进行路由，启动仓库内的 QA 总线，引导 qa-channel 运行时切片，并运行确定性自检。

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

bash
pnpm openclaw qa suite

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

基于 Docker 的 QA 站点（Gateway 网关 + QA Lab 调试器 UI，位于同一技术栈中）：

bash
pnpm qa:lab:up

构建 QA 站点，启动基于 Docker 的 Gateway 网关 + QA Lab 技术栈，并输出 QA Lab URL。你可以在其中选择场景和模型通道、启动单次运行，并实时查看结果。QA Lab 调试器与发布的 Control UI 包相互独立。

相关内容

Was this useful?
On this page

On this page