OpenClaw · Unlighthouse · Frontend CI · 2026

2026 OpenClaw Frontend-Praxis auf Remote Mac:
Unlighthouse-JSON parsen, Totlink-Schwellen, Lighthouse-Regressionszusammenfassung an PR — reproduzierbare Schritte

20. Mai 2026 Frontend Release Engineering ca. 9 Min.

Zielgruppe: Teams mit Frontend CI auf einem Remote Mac, die Unlighthouse-Scan-JSON auswerten, 4xx-Budgets durchsetzen und Lighthouse-Digests in den PR bringen müssen. Sie erhalten Entscheidungsmatrix, JSON-Feldmap, Schwelltabellen und OpenClaw-Schritte — mit Verweisen auf Preview-Lighthouse-Webhook und Bugsnag-Lighthouse-PR-Zusammenfassung.

Einzel-URL-Lighthouse findet keine Sitemap-404 und keine Totanker in verschachtelten Docs. Ergebnis: Unlighthouse plus Lighthouse auf Apple Silicon, von OpenClaw zu einem PR-Kommentar unter vier Kilobyte zusammengeführt.

00 Drei Engpässe, die diese Pipeline löst

1) Lighthouse nur auf /, während Dokumentationsrouten 404 liefern.

2) Totlink-Fehler bleiben in Logs, nicht im PR-Kommentar, den Reviewer lesen.

3) Container-Chromium weicht vom Mac ab, der Safari-Smoke ausführt — Artefakte sind nicht vergleichbar.

01 Unlighthouse vs. einmaliges Lighthouse CLI: Gate-Auswahl

Beide Werkzeuge, aber getrennte Urteile. Unlighthouse beantwortet Crawl-Gesundheit; Lighthouse beantwortet Lab-Performance auf einer Kurz-Allowlist.

Werkzeug Einsatz Nicht nutzen wenn
Unlighthouse CI Interner Linkgraph, Status pro Route, Sitemap auf Preview-Hosts. Nur Single-Page-App ohne Marketing-Routen.
Lighthouse CLI LCP, CLS, TBT auf Checkout, Home, Pricing nach Warm-up. Beweis für Blog-Posts drei Ebenen tief nötig ist.
OpenClaw-Kombi-Gate Ein Markdown-Digest: Totlinks zuerst, schlechteste Metrik zweitens; Exit-Code = Merge-Policy. Chrome- und Node-Major nicht auf demselben Mac-Worker gepinnt.

02 Node 24+ und OpenClaw-Gateway auf dem Remote Mac installieren

  1. Node 24 LTS pinnen — gleiche Major in CI-Metadaten; corepack für pnpm aktivieren.
  2. OpenClaw CLI global oder als devDependency; OPENCLAW_GATEWAY_TOKEN im macOS-Schlüsselbund, nicht im Repo.
  3. HTTPS-Ingress auf dem gemieteten Host; HMAC für Deploy-Webhooks laut Preview-Webhook-Anleitung.
  4. Jobs lokal queuen unter .openclaw/queue/, damit SSH-Unterbrechungen Crawls nicht mittendrin abbrechen.
  5. Chromium pinnen — dieselbe Build-Version für Unlighthouse und Lighthouse; Pfad in .openclaw/toolchain.lock.json.
node -v   # erwartet v24.x
pnpm add -D @unlighthouse/cli lighthouse openclaw
openclaw gateway doctor --json > .openclaw/reports/doctor.json

03 Unlighthouse CI JSON: Pflichtfelder für den Parser

Mit --reporter json nach .openclaw/reports/unlighthouse.json schreiben. Stabile Schlüssel schlagen hübsches Format.

JSON-Pfad Semantik Parser-Aktion
site.url Kanonische Preview-Wurzel Mit PREVIEW_URL aus Hook vergleichen
routes[] path, score, optional reports.lighthouse Allowlist und Score-Minimum prüfen
reports.links Href-Status pro internem Link status >= 400 auf interne Hosts filtern
summary.brokenLinks Schnellfail-Zähler Exit 2 wenn über Budget
ci.buildId CI-Korrelation An OPENCLAW_RUN_ID hängen

05 Performance-Regression: LCP, CLS, TBT (Schwelltabelle)

Lighthouse auf drei Umsatz-URLs; perf/thresholds.json am gleichen SHA vergleichen.

Metrik Mobile-Budget Bei Fail
Performance-Score >= 0,85 Delta vs. Baseline-Artefakt im PR
LCP <= 2500 ms Schlechteste URL zuerst; Pfad zu lhr.json
CLS <= 0,08 Block bei Hero-Layout-Shift nach Font-Swap
TBT <= 200 ms Exit 2; schlechteste URL nennen

06 OpenClaw-Aggregat: PR-Kommentar und Webhook-Upsert

  1. link_gate.json und lhr.json zu gate_digest.json mergen.
  2. pr_unlighthouse_lighthouse.md aus Template rendern; unter 4 KB für mobile Reviewer halten.
  3. PR-Kommentar: Bot-Kommentar mit Marker <!-- openclaw-unlh-lh --> patchen — analog Playwright-JUnit-PR-Zusammenfassung.
  4. Webhook: Digest an OpenClaw /v1/runs/{id}/events für Slack oder Deployment-Zeilen.
  5. Artefakt-Pfad in PR verlinken; siehe auch GitHub Deployments + Lighthouse.

07 Safari/WebKit auf demselben Mac koordinieren

Chromium-Lab-Scores ersetzen kein WebKit. Nach dem Gate die Safari-Stable/STP-Playwright-Matrix mit --workers=1 starten. Merge nur blockieren, wenn webkitBlocksMerge: true in der Policy-JSON steht.

08 Häufige Fehler (FAQ)

Unlighthouse meldet null Routen

Protokoll in site.url, Sitemap-Discovery, Preview-Auth-Header bei SSO.

Totlink-Zahlen weichen zwischen CI und Mac ab

Gleiche Region und DNS; dieselbe Cookie-Datei wie OpenClaw für authentifizierte Previews.

Lighthouse grün, PR zeigt trotzdem Fail

Link-Gate kann zuerst mit Exit 2 enden. Digest: Totlinks vor Performance-Zeilen sortieren.

Zitierfähige Schwellen für Architektur-Reviews

Crawl-Umfang

Unlighthouse-Routen auf Preview-Hosts auf 150 begrenzen — Laufzeit unter 12 Minuten auf M-Klasse.

Link-Stichprobe

Mindestens 200 interne Hrefs, bevor 0,5 % Vier-xx-Quote gilt.

Digest-Größe

PR-Kommentar unter 4096 Bytes; Routenliste auf 10 Zeilen kürzen mit Artefakt-Link.

Mieten Sie einen Remote-Mac-Frontend-Build-Knoten, wenn Unlighthouse, Lighthouse und Safari-Spuren auf einem Apple-Silicon-Host laufen sollen. Knoten-Pakete, SSH/VNC-Zugang, öffentlicher Blog, Startseite.

Remote Mac · Frontend CI · ohne Login

Knoten für Unlighthouse- und Lighthouse-Spuren

Unlighthouse-Crawls und Lighthouse-Budgets neben Playwright Safari auf gemietetem Apple Silicon. Weiter mit Playwright-HTML-Report-PR-Zusammenfassung, dann Mac Mini M4 mieten.

Totlinks Lighthouse WebKit-Spur
Frontend-CI-Knoten mieten