2026 OpenClaw Frontend-Praxis auf Remote Mac:
Unlighthouse-JSON parsen, Totlink-Schwellen, Lighthouse-Regressionszusammenfassung an PR — reproduzierbare Schritte
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
- Node 24 LTS pinnen — gleiche Major in CI-Metadaten;
corepackfür pnpm aktivieren. - OpenClaw CLI global oder als devDependency;
OPENCLAW_GATEWAY_TOKENim macOS-Schlüsselbund, nicht im Repo. - HTTPS-Ingress auf dem gemieteten Host; HMAC für Deploy-Webhooks laut Preview-Webhook-Anleitung.
- Jobs lokal queuen unter
.openclaw/queue/, damit SSH-Unterbrechungen Crawls nicht mittendrin abbrechen. - 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 |
04 Totlinks, 4xx-Quote und Merge-Blockregeln
| Signal | Budget | Exit-Code |
|---|---|---|
| Gebrochene interne Links | 0 auf Release-Zweigen; <= 2 auf Docs-Zweigen mit Ticket-ID im PR-Text |
2 Regression |
| 4xx-Rate intern | <= 0,5 % der internen Hrefs (Stichprobe min. 200 Links) |
2 bei Überschreitung |
| 5xx oder Timeout | Jede Allowlist-Route >= 500 blockiert Merge |
3 nach einem Retry (Infra) |
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
link_gate.jsonundlhr.jsonzugate_digest.jsonmergen.pr_unlighthouse_lighthouse.mdaus Template rendern; unter 4 KB für mobile Reviewer halten.- PR-Kommentar: Bot-Kommentar mit Marker
<!-- openclaw-unlh-lh -->patchen — analog Playwright-JUnit-PR-Zusammenfassung. - Webhook: Digest an OpenClaw
/v1/runs/{id}/eventsfür Slack oder Deployment-Zeilen. - 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
Unlighthouse-Routen auf Preview-Hosts auf 150 begrenzen — Laufzeit unter 12 Minuten auf M-Klasse.
Mindestens 200 interne Hrefs, bevor 0,5 % Vier-xx-Quote gilt.
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.
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.