2026 OpenClaw Frontend in der Praxis:
Remote Mac: Playwright trace.zip & HAR parsen — Min-Repro-Schritte automatisch in den PR
Wenn E2E-Flakes nur mit Screenshots kommentiert werden, verlieren Reviewer den Faden. Dieses HowTo führt eine reproduzierbare Kette auf einem Remote Mac: Playwright-Traces mit festen Exportparametern, trace.zip entpacken, JSON-Signale extrahieren, getrimmtes HAR redigieren, OpenClaw pr_min_repro_summary.md aus Template — optional PR-Kommentar oder Webhook. Mehr: E2E-Log-Triage, Playwright Auto-Fix, Docker-Playwright, Source-Map-PR-Summary, WebKit-Smoke. Ohne Konto: kaufen.html, Preise.
00 Drei typische Bremsklötze ohne standardisierte Trace-HAR-Pipeline
- Inkonsistente Aufzeichnung: Ein Runner nutzt
trace: on, ein anderer gar nichts — Vergleichbarkeit zwischen Laptop und CI bricht zusammen. - Viewer-Zwang: Teams öffnen nur den GUI-Trace-Viewer und vergessen strukturierte Daten; Headless-Macs und Agenten können so nicht skalieren.
- Datenschutz: Rohe HAR-Dateien landen in PRs oder Chat und enthalten Cookies, Tokens und Pfade aus dem Heimverzeichnis.
01 Trace-Export-Parameter: CI und Remote Mac auf eine Linie bringen
In playwright.config use.trace dokumentieren: on für kurze Repros; retain-on-failure oder on-first-retry begrenzen Artefakte. screenshot/video an Trace-Politik angleichen; run_meta.json mit Repo, SHA, Playwright-Version, Basis-URL, Auth-Modus ohne Secrets.
Ausgabe nach .openclaw/reports/<git-sha>/traces/ auf dem Remote Mac. Einzeltests: CLI z. B. --trace on, fester Browser-Kanal.
| Modus | Einsatz | Artefaktgröße | Review-Tauglichkeit | Risiko |
|---|---|---|---|---|
on |
Kurze Repros, lokale Fehlersuche | Hoch | Maximale Detailtiefe | Speicher- und Uploadzeit in CI |
retain-on-failure |
Standard-CI bei stabilen Suites | Mittel | Nur bei Rot relevant | Kein Trace bei grünem Lauf |
on-first-retry |
Flaky-Suites mit Retry | Geringer Mittelwert | Fokus auf zweiten Versuch | Erster Fehlversuch ohne Trace |
02
trace.zip entpacken und Felder extrahieren, die Reviewer zuerst lesen
Nach unzip: Aktionen/Zeiten aus trace.trace, Netzwerk aus trace.network oder Events, Konsole/Fehler am fehlgeschlagenen Schrittindex. Extraktor → trace_signals.json: End-URL, Viewport, Navigationsfehler, Schritttitel, Assertion-Index, bis zwanzig Netzwerkzeilen (Methode, URL, Status, Timing).
URLs normalisieren: Session-IDs raus, Standardports, localhost → Dienstname; bei Tabs nur den fehlerhaften behalten.
Keine storageState-Inhalte, Cookies oder JWT-Fragmente in JSON, das OpenClaw rendert. Auth beschreiben („Testnutzer per CI-Secret“), Werte nicht einfügen.
03 HAR trimmen: kleinste Datei, die den Bug noch überführt
HAR liefert HTTP-Beweise parallel zum Trace. Roh-HAR ist laut und gefährlich. Wenden Sie eine deterministische Trimmpass an und speichern Sie repro.har.trimmed.json neben trace_signals.json:
| Regel | Begründung |
|---|---|
| Origin + Pfadpräfix des Features behalten | Redirects und API-Kette bleiben, Analytics-Domains fallen weg. |
Authorization, Cookie, firmenspezifische Header streichen |
Verhindert Credential-Leaks in PR und Chat. |
| Antwortkörper bei 200 kürzen oder weglassen | Größe sinkt; 4xx/5xx nur bei Zitat im Summary behalten. |
| Nach Startzeit sortieren, z. B. max. 80 Einträge | Markdown und Webhook bleiben auf dem Handy lesbar. |
Bei zwei HARs (Retry) das Exemplar wählen, dessen Zeitstempel mit dem fehlgeschlagenen Versuch im Trace übereinstimmt.
04
OpenClaw-Template: pr_min_repro_summary.md
OpenClaw soll Slots füllen, keine Essays improvisieren. Fünf Blöcke haben sich bewährt: Build (SHA, Playwright, Browser), Umgebung (Basis-URL, Feature-Flags), Repro-Schritte (nummeriert, aus Schritttiteln), Netzwerkbelege (drei bis sechs Zeilen: Methode, Pfad, Status), Artefakte (Pfade im sicheren Store — keine öffentlichen Lang-URLs ohne Signatur).
- Eingaben:
trace_signals.json,repro.har.trimmed.json,run_meta.json, optional Playwright-Stderr-Auszug. - Ausgaben:
pr_min_repro_summary.mdplusstatus.txtmit Werten wieready,incomplete_trace,har_redaction_failedfür nachgelagerte Gates. - Längenlimit: unter ca. vierhundert Wörtern halten, damit GitHub-Mobile und Slack-Unfurls lesbar bleiben.
05
Optional: PR-Kommentar, gh oder Webhook
Handoff wie bei anderen OpenClaw-Gates: Least Privilege, Idempotenz, keine Secrets im Body. Auf GitHub kann ein Self-Hosted-Runner auf dem Mac gh pr comment mit expliziten Workflow-Rechten nutzen oder ein fein abgestuftes PAT. Versteckter Marker <!-- openclaw-min-repro-sha:abc1234 --> erlaubt Updates statt Spam.
Für Chat-Systeme reicht ein typischer POST mit JSON-Body; Signatur und Idempotency-Key aus SHA plus Fingerabdruck der Signale. Bei 429 exponentielles Backoff; Fehler in status.txt protokollieren statt Endlosschleifen im Agenten.
06 FAQ & Fehleranalyse
Trace öffnet sich, Schritte wirken leer: Falscher Browser-Kontext oder abgebrochene Aufzeichnung durch Speicherlimit — Versionen zwischen Laptop und Mac-Worker angleichen und Modus wiederholen.
HAR nur mit CORS/opaque: Trace liefert oft Navigations- und Konsolensignale — vor dem Markdown mergen und page.request vs. Browser-fetch benennen.
Webhook 401: Secret rotieren, IP-Allowlists prüfen, JSON-Escaping des Markdown-Körpers validieren.
Doppelte PR-Kommentare: Bestehende Marker-Kommentare suchen oder Lockfile unter .openclaw/reports/<sha>/ setzen.
Compliance verbietet HTTP-Dumps: Nur Summary im PR; getrimmtes HAR im freigegebenen Bucket verlinken.
Trace-Modi und Ausgabeordner pro SHA pinnen, trace_signals.json extrahieren, redigiertes repro.har.trimmed.json beifügen, pr_min_repro_summary.md per OpenClaw-Template erzeugen und mit derselben Token- und Webhook-Disziplin wie bei anderen Gates ausliefern. Ein Remote Mac bietet stabile Pfade, Platz für große Traces und echte WebKit-Nähe — ideal neben der Pipeline aus Docker-Playwright.
OpenClaw-Pipelines mit echtem Safari-Umfeld betreiben
Mieten Sie einen Mac Mini M4 für Entpack-Jobs, HAR-Redaktion und PR-Summaries rund um die Uhr. Preise, Hilfe inkl. SSH/VNC und Kaufen sind ohne Anmeldung erreichbar — Region wählen und bestellen, wenn Ihr Team bereit ist.
Weitere Runbooks: Blog-Übersicht, Startseite.