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

# QA 频道

`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 bus，加载 `qa-channel` 运行时切片，并运行确定性的自检。

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

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

并行针对 QA 网关通道运行场景。有关场景、配置文件和提供者模式，请参见 [QA 概览](/concepts/qa-e2e-automation)。

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

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

会构建 QA 站点，启动 Docker 支持的网关 + QA Lab 栈，并打印 QA Lab URL。从那里你可以选择场景、选择模型通道、启动单独运行，并实时查看结果。QA Lab 调试器与已发布的 Control UI 包是分开的。

## 相关内容

* [QA 概览](/concepts/qa-e2e-automation) - 整体技术栈、传输适配器、Matrix 实时通道和场景编写
* [配对](/channels/pairing)
* [群组](/channels/groups)
* [渠道概览](/channels)