> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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。

## 运行器

主机侧自检（在 `.artifacts/qa-e2e/` 下写入 Markdown 报告）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm qa:e2e
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm openclaw qa suite
```

针对 QA Gateway 网关通道并行运行场景。有关场景、配置文件和提供商模式，请参阅 [QA overview](/zh-CN/concepts/qa-e2e-automation)。

Docker 支撑的 QA 站点（Gateway 网关 + QA Lab 调试器 UI 位于同一栈中）：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm qa:lab:up
```

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

## 相关

* [QA overview](/zh-CN/concepts/qa-e2e-automation) - 整体栈、传输协议适配器、场景编写
* [Matrix QA](/zh-CN/concepts/qa-matrix) - 驱动真实渠道的实时传输协议运行器示例
* [配对](/zh-CN/channels/pairing)
* [群组](/zh-CN/channels/groups)
* [渠道概览](/zh-CN/channels)