From f99bf36dcefd1e1a07e626b88bb3c26b97af82d3 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Fri, 24 Apr 2026 19:42:21 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@88c91675e277505fb64c13a00988757e092a38c9 --- .openclaw-sync/source.json | 4 ++-- docs/concepts/qa-e2e-automation.md | 13 +++++++++++++ docs/help/testing.md | 7 ++++++- 3 files changed, 21 insertions(+), 3 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index d21cf3fad..6aa00557b 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "47f6a98909b53810519d9ee84202fa1276ddccb3", - "syncedAt": "2026-04-24T19:40:05.166Z" + "sha": "88c91675e277505fb64c13a00988757e092a38c9", + "syncedAt": "2026-04-24T19:40:53.231Z" } diff --git a/docs/concepts/qa-e2e-automation.md b/docs/concepts/qa-e2e-automation.md index eb9d63adb..f8a4de1d4 100644 --- a/docs/concepts/qa-e2e-automation.md +++ b/docs/concepts/qa-e2e-automation.md @@ -64,6 +64,9 @@ the child config scoped to the transport under test, so Matrix runs without a combined stdout/stderr log into the selected Matrix QA output directory. To capture the outer `scripts/run-node.mjs` build/launcher output too, set `OPENCLAW_RUN_NODE_OUTPUT_LOG=` to a repo-local log file. +Matrix progress is printed by default. `OPENCLAW_QA_MATRIX_TIMEOUT_MS` bounds +the full run, and `OPENCLAW_QA_MATRIX_CLEANUP_TIMEOUT_MS` bounds cleanup so a +stuck Docker teardown reports the exact recovery command instead of hanging. For a transport-real Telegram smoke lane, run: @@ -83,6 +86,16 @@ you want artifacts without a failing exit code. The Telegram report and summary include per-reply RTT from the driver message send request to the observed SUT reply, starting with the canary. +Before using pooled live credentials, run: + +```bash +pnpm openclaw qa credentials doctor +``` + +The doctor checks Convex broker env, validates endpoint settings, and verifies +admin/list reachability when the maintainer secret is present. It reports only +set/missing status for secrets. + For a transport-real Discord smoke lane, run: ```bash diff --git a/docs/help/testing.md b/docs/help/testing.md index 001e4b08b..ad00b8cae 100644 --- a/docs/help/testing.md +++ b/docs/help/testing.md @@ -147,6 +147,7 @@ runs the same lanes before release approval. - Uses the pinned stable Tuwunel image `ghcr.io/matrix-construct/tuwunel:v1.5.1` by default. Override with `OPENCLAW_QA_MATRIX_TUWUNEL_IMAGE` when you need to test a different image. - Matrix does not expose shared credential-source flags because the lane provisions disposable users locally. - Writes a Matrix QA report, summary, observed-events artifact, and combined stdout/stderr output log under `.artifacts/qa-e2e/...`. + - Emits progress by default and enforces a hard run timeout with `OPENCLAW_QA_MATRIX_TIMEOUT_MS` (default 30 minutes). Cleanup is bounded by `OPENCLAW_QA_MATRIX_CLEANUP_TIMEOUT_MS` and failures include the recovery `docker compose ... down --remove-orphans` command. - `pnpm openclaw qa telegram` - Runs the Telegram live QA lane against a real private group using the driver and SUT bot tokens from env. - Requires `OPENCLAW_QA_TELEGRAM_GROUP_ID`, `OPENCLAW_QA_TELEGRAM_DRIVER_BOT_TOKEN`, and `OPENCLAW_QA_TELEGRAM_SUT_BOT_TOKEN`. The group id must be the numeric Telegram chat id. @@ -205,12 +206,16 @@ Maintainer admin commands (pool add/remove/list) require CLI helpers for maintainers: ```bash +pnpm openclaw qa credentials doctor pnpm openclaw qa credentials add --kind telegram --payload-file qa/telegram-credential.json pnpm openclaw qa credentials list --kind telegram pnpm openclaw qa credentials remove --credential-id ``` -Use `--json` for machine-readable output in scripts and CI utilities. +Use `doctor` before live runs to check the Convex site URL, broker secrets, +endpoint prefix, HTTP timeout, and admin/list reachability without printing +secret values. Use `--json` for machine-readable output in scripts and CI +utilities. Default endpoint contract (`OPENCLAW_QA_CONVEX_SITE_URL` + `/qa-credentials/v1`):