mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-26 20:35:39 -06:00
Josh Avant
97a53a9b35
* feat: audit admitted channel participant identity * fix: preserve Telegram identity through thread recovery * fix: signal held gateway process groups * fix: keep audit evidence passive in collect routing * fix: validate copied channel participant evidence * fix: bind channel participant evidence to host ingress * fix: honor Telegram proof credential roles * fix: restart held Telegram proof through gateway * fix: repair channel identity CI regressions * test(matrix): bind thread routing owner * fix: preserve direct DM SDK compatibility * fix: bind channel provenance at host runtime * test(feishu): provide channel context builder * fix: defer record-bound channel runtime resolution * fix: keep channel admission evidence core-private * fix(audit): bind channel admission to plugin lifecycle * fix(audit): bind ingress provenance to final context * refactor(audit): split admission scope keys * test(queue): cover combined metadata carriers * refactor(audit): keep lifecycle helpers private * fix(queue): preserve combined turn authority * test(channels): provide ingress context builders * test(channels): align integrated CI fixtures * test(clickclack): resolve model-loop ingress * docs: preserve channel participant evidence invariant
106 lines
4.2 KiB
Markdown
106 lines
4.2 KiB
Markdown
---
|
|
summary: "Synthetic Slack-class channel plugin for deterministic OpenClaw QA scenarios"
|
|
title: "QA channel"
|
|
read_when:
|
|
- You are wiring the synthetic QA transport into a local or CI test run
|
|
- You need the bundled qa-channel config surface
|
|
- You are iterating on end-to-end QA automation
|
|
---
|
|
|
|
`qa-channel` is a repo-local synthetic message transport for automated OpenClaw QA (`extensions/qa-channel`, private package, excluded from packaged installs). It is not a production channel - it exists to exercise the same channel plugin boundary used by real transports while keeping state deterministic and fully inspectable.
|
|
|
|
## What it does
|
|
|
|
- Slack-class target grammar:
|
|
- `dm:<user>`
|
|
- `channel:<room>`
|
|
- `group:<room>`
|
|
- `thread:<room>/<thread>`
|
|
- Shared `channel:` and `group:` conversations are surfaced to agents as group/channel room turns, so they exercise the same visible-reply and message-tool routing policy used by Discord, Slack, Telegram, and similar transports.
|
|
- HTTP-backed synthetic bus for inbound message injection, outbound transcript capture, thread creation, reactions, edits, deletes, and search/read actions.
|
|
- Host-side self-check runner that writes a Markdown report to `.artifacts/qa-e2e/`.
|
|
|
|
## Config
|
|
|
|
```json
|
|
{
|
|
"channels": {
|
|
"qa-channel": {
|
|
"baseUrl": "http://127.0.0.1:43123",
|
|
"botUserId": "openclaw",
|
|
"botDisplayName": "OpenClaw QA",
|
|
"allowFrom": ["*"],
|
|
"pollTimeoutMs": 1000
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
Account keys:
|
|
|
|
- `enabled` - master toggle for this account.
|
|
- `name` - optional display label.
|
|
- `baseUrl` - synthetic bus URL. The account counts as configured once this is set.
|
|
- `botUserId` - synthetic bot user id used in target grammar (default: `openclaw`).
|
|
- `botDisplayName` - display name for outbound messages (default: `OpenClaw QA`).
|
|
- `pollTimeoutMs` - long-poll wait window. Integer between 100 and 30000 (default: 1000).
|
|
- `allowFrom` - sender allowlist (user ids or `"*"`; default: `["*"]`). DMs are
|
|
always `open` policy; allowlisted group policy also uses these synthetic
|
|
sender ids.
|
|
- `groupPolicy` - shared-room policy: `"open"` (default), `"allowlist"`, or
|
|
`"disabled"`.
|
|
- `groupAllowFrom` - optional shared-room sender allowlist. When omitted under
|
|
`"allowlist"`, QA Channel falls back to `allowFrom`.
|
|
- `groups.<room>.requireMention` - require a bot mention before replying in a
|
|
specific group/channel room (default: false). `groups."*"` sets the default;
|
|
per-room `tools` / `toolsBySender` set tool policy overrides.
|
|
- `defaultTo` - fallback target when none is supplied.
|
|
- `actions.messages` / `actions.reactions` / `actions.search` / `actions.threads` - per-action tool gating.
|
|
|
|
Multi-account keys at the top level:
|
|
|
|
- `accounts` - record of named per-account overrides keyed by account id.
|
|
- `defaultAccount` - preferred account id when multiple are configured.
|
|
|
|
## Runners
|
|
|
|
Host-side self-check (writes a Markdown report under `.artifacts/qa-e2e/`):
|
|
|
|
```bash
|
|
pnpm qa:e2e
|
|
```
|
|
|
|
This routes through `qa-lab`, starts the in-repo QA bus, boots the `qa-channel` runtime slice, and runs a deterministic self-check.
|
|
|
|
Full repo-backed scenario suite:
|
|
|
|
```bash
|
|
pnpm openclaw qa suite
|
|
```
|
|
|
|
The isolated `channel-participant-identity-inspection` scenario enables
|
|
execution identity before startup, exercises DM, group, senderless, same- and
|
|
mixed-participant collect paths, proves an ingress rejection creates no audit
|
|
rows, and compares JSON plus human CLI inspection across Gateway restart:
|
|
|
|
```bash
|
|
pnpm openclaw qa suite --scenario channel-participant-identity-inspection
|
|
```
|
|
|
|
Runs scenarios in parallel against the QA gateway lane. See [QA overview](/concepts/qa-e2e-automation) for scenarios, profiles, and provider modes.
|
|
|
|
Docker-backed QA site (gateway + QA Lab debugger UI in one stack):
|
|
|
|
```bash
|
|
pnpm qa:lab:up
|
|
```
|
|
|
|
Builds the QA site, starts the Docker-backed gateway + QA Lab stack, and prints the QA Lab URL. From there you can pick scenarios, choose the model lane, launch individual runs, and watch results live. The QA Lab debugger is separate from the shipped Control UI bundle.
|
|
|
|
## Related
|
|
|
|
- [QA overview](/concepts/qa-e2e-automation) - overall stack, transport adapters, the Matrix live lane, and scenario authoring
|
|
- [Pairing](/channels/pairing)
|
|
- [Groups](/channels/groups)
|
|
- [Channels overview](/channels)
|