2026 OpenClaw Frontend-QA in der Praxis:
Playwright-Shards, Report-Merge, Flake-Schwellen und PR-Zusammenfassung auf dem Remote Mac

Verwenden Sie .openclaw/reports/$GIT_SHA/ als Vertragswurzel auf dem Remote Mac. Jeder Shard schreibt nach raw/shard-$i/blob/. Nach dem Kopieren merge-reports nach merged/html und merged/junit.xml ausführen. Legen Sie flake_stats.json daneben ab, damit OpenClaw-Vorlagen deterministische Pfade lesen können, ohne den Baum zu scannen.

mkdir -p ".openclaw/reports/${GIT_SHA}/raw/shard-${SHARD}/blob"
PLAYWRIGHT_SHARD=${SHARD} PLAYWRIGHT_TOTAL=${TOTAL} npx playwright test --reporter=blob
# Fan-in-Host:
npx playwright merge-reports ".openclaw/reports/${GIT_SHA}/raw/shard-"*"/blob" \
  --reporter=html,junit

Zitierfähige Fakten: GitHub Branch-Protection liest typischerweise einen junit-Pfad. Der Blob-Reporter ist der unterstützte Merge-Input in aktuellen Playwright-Versionen. WebKit-Kaltstarts kosten auf dem ersten Launch oft zig Sekunden — das gehört in die Shard-Zeitplanung, nicht nur in timeout-Literale.

Browser und Playwright bleiben vollständig auf dem Mac. Das OpenClaw-Gateway (Ingress, Schema-Validierung, optionales Modell für Textzusammenfassung) bekommt nur strukturierte Artefakte: gemergte junit-Zähler, Top-fehlgeschlagene Testtitel, Wandzeit-Schiefstand zwischen Shards und signierte Artefakt-URLs. Rohe Traces nicht durch das Modell streamen, außer bei gezielter Triage; stattdessen verlinken wie im Trace- und HAR-Playbook. Summaries mit Idempotency-Key: ${GIT_SHA}:${CI_PIPELINE_ID}:pw posten und <!-- openclaw-pw:${GIT_SHA} --> einbetten, damit PR-Kommentar-Updates idempotent bleiben.

• Das Gateway validiert JSON-Schema-Version pw_summary/v1, bevor Git berührt wird.
• Secrets verlassen den Runner nicht; OpenClaw erhält presigned GET-URLs mit kurzer TTL.
• Wenn Auth mitten im Lauf scheitert, die Observability-Felder aus dem Token-Auth-Artikel nutzen statt zu raten.

Sei p die Fehlerwahrscheinlichkeit pro Versuch für einen flaky Fall und ε Ihr Rest-Risiko-Budget nach automatisierten Retries (Unabhängigkeit als Erstnäherung). Lösen Sie p^(r+1) ≤ ε, also r_max = min(3, ceil(ln(ε)/ln(p) - 1)) mit harter Obergrenze aus Policy. Beispiel: p = 0,2 und ε = 0,01 erfordert r+1 ≥ 3, weil 0,2^2 > 0,01 während 0,2^3 ≤ 0,01 — damit zwei Retries nach dem ersten Lauf. Für die Suite: flake_budget = floor(0,15 * total_tests), damit ein lautes Modul nicht den gesamten Pool verbraucht.

Bekannte Flakes taggen, in einem langsameren Quarantäne-project fahren und im Merge-Report sowohl Erstversuch als auch Retry-Spalten zeigen — so bleibt Grün glaubwürdig für die PR-Zusammenfassung.

• Fixture-Timeout unter WebKit: expect-Timeouts erst anheben, wenn actionTimeout und reale Last stimmen — prüfen, ob der Mac parallele Shards thermisch drosselt.
• Navigation-Timeout zu Preview-URLs: Kaltstart-Probes an die Kadenz aus Deploy-Hook-Smoke (Vercel) oder Ihrem eigenen Warm-up koppeln, damit Tests erst starten, wenn die Edge 200 liefert.
• Merge-Schritt hängt: Prüfen, ob jeder Shard einen vollständigen Blob hochgeladen hat; partielle Kopien erzeugen stille Merge-Hänger — Ordner vor dem Fan-in checksummieren.

1. GIT_SHA, TOTAL und pro Job SHARD exportieren; Start verweigern, wenn das Tupel unvollständig ist.
2. Browser einmal pro Maschinen-Image installieren; PLAYWRIGHT_BROWSERS_PATH außerhalb der Workspace-Kopie cachen.
3. Tests mit Blob-Reporter unter .openclaw/reports/$GIT_SHA/raw/shard-$SHARD/blob ausführen.
4. Auf dem Fan-in-Runner Blobs mergen, HTML und junit erzeugen, Flake-Deltas aus junit-Zeitstempeln berechnen.
5. pr_playwright_summary.md mit Abschnitten für Failures, Flakes, Shard-Schiefstand und Artefakt-Links bauen.
6. Per OpenClaw mit Idempotency-Key posten und bei gleichem SHA den bestehenden PR-Kommentar-Marker aktualisieren.

Für kontinuierliche Läufe (nachts, auf PR-Labels) lohnt sich dieselbe Pipeline auf dem Remote Mac wie für Merge-Queue: einheitliche Pfade, identische Playwright-Version, reproduzierbare OpenClaw-Webhooks — siehe auch Docker × Playwright auf Remote Mac für Isolationsvarianten.