Skip to content

Commit ae06d84

Browse files
committed
docs(qa): clarify Matrix smoke provider mode
1 parent 380f274 commit ae06d84

1 file changed

Lines changed: 17 additions & 5 deletions

File tree

docs/concepts/qa-e2e-automation.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -178,10 +178,21 @@ QA Lab, so package Docker release lanes do not run `qa` commands. Use
178178
`pnpm qa:observability:smoke` from a built source checkout when changing
179179
diagnostics instrumentation.
180180

181-
For a transport-real Matrix smoke lane, run:
181+
For a transport-real Matrix smoke lane that does not require model-provider
182+
credentials, run the fast profile with the deterministic mock OpenAI provider:
182183

183184
```bash
184-
pnpm openclaw qa matrix --profile fast --fail-fast
185+
OPENCLAW_QA_MATRIX_NO_REPLY_WINDOW_MS=3000 \
186+
pnpm openclaw qa matrix --provider-mode mock-openai --profile fast --fail-fast
187+
```
188+
189+
For the live-frontier provider lane, supply OpenAI-compatible credentials
190+
explicitly:
191+
192+
```bash
193+
OPENCLAW_LIVE_OPENAI_KEY="${OPENAI_API_KEY}" \
194+
OPENCLAW_QA_MATRIX_NO_REPLY_WINDOW_MS=3000 \
195+
pnpm openclaw qa matrix --provider-mode live-frontier --profile fast --fail-fast
185196
```
186197

187198
The full CLI reference, profile/scenario catalog, env vars, and artifact layout for this lane live in [Matrix QA](/concepts/qa-matrix). At a glance: it provisions a disposable Tuwunel homeserver in Docker, registers temporary driver/SUT/observer users, runs the real Matrix plugin inside a child QA gateway scoped to that transport (no `qa-channel`), then writes a Markdown report, JSON summary, observed-events artifact, and combined output log under `.artifacts/qa-e2e/matrix-<timestamp>/`.
@@ -201,9 +212,10 @@ environment. That viewer profile is only for visual capture; the pass/fail
201212
decision still comes from the Discord REST oracle.
202213

203214
CI uses the same command surface in `.github/workflows/qa-live-transports-convex.yml`.
204-
Scheduled and default manual runs execute the fast Matrix profile with live
205-
frontier credentials, `--fast`, and `OPENCLAW_QA_MATRIX_NO_REPLY_WINDOW_MS=3000`.
206-
Manual `matrix_profile=all` fans out into the five profile shards.
215+
Scheduled and default manual runs execute the fast Matrix profile with
216+
QA-provided live-frontier credentials, `--fast`, and
217+
`OPENCLAW_QA_MATRIX_NO_REPLY_WINDOW_MS=3000`. Manual `matrix_profile=all` fans
218+
out into the five profile shards.
207219

208220
For transport-real Telegram, Discord, Slack, and WhatsApp smoke lanes:
209221

0 commit comments

Comments
 (0)