2026 OpenClaw Frontend in der Praxis:
Remote Mac: axe-core-A11y-JSON parsen → PR-lesbare Zusammenfassung (HowTo)

axe-core ist eine Engine, kein einzelnes CLI. Das tragfähige Muster 2026: Sie führen sie dort aus, wo Ihre Oberfläche ohnehin startet — Playwright- oder Cypress-Schritte mit injectAxe() und checkA11y(), oder ein Headless-Skript mit @axe-core/cli, das jede Preview-URL lädt und Ergebnisse schreibt. Auf einem geteilten Remote Mac pinnen Sie Chromium- oder WebKit-Versionen gemeinsam mit Node, damit der Lauf von gestern zum heutigen CI-Container passt.

Persistieren Sie immer maschinenlesbares JSON, keine Screenshots aus den DevTools. Der Runner soll entweder das Standard-axe-Ergebnis-Objekt oder ein zusammengeführtes Array pro URL ausgeben. Speichern Sie unter einem deterministischen Pfad wie .openclaw/reports/$GIT_SHA/a11y/ mit Dateien raw_home.json, raw_checkout.json plus kleinem manifest.json (Basis-URL, Commit, Browser-Build-String, axe-core-Version). Optional gzip für große Rohdaten; die unkomprimierte Normalisierung liegt daneben für Agenten.

Die CI behandelt Barrierefreiheit wie jedes andere Gate: Exit ungleich null, wenn die Policy verletzt ist — dennoch Artefakte hochladen, damit OpenClaw für Menschen zusammenfasst. Läuft axe erst nach Deploy, triggern Sie denselben Job aus einem Preview-Schritt, sodass das JSON immer eine stabile HTTPS-Origin referenziert.

Binden Sie den Schritt in dieselbe Matrix wie Lint und Unit-Tests ein: bei parallelen Jobs pro Branch schreibt jeder Lauf unter eindeutigem $GIT_SHA, damit PR-Kommentare und Artefakt-Archive nicht vermischt werden. Auf dem Remote Mac profitieren Sie von WebKit-näherer Ausführung; die autoritative Merge-Entscheidung sollte dieselbe Normalisierungs- und Schwellenlogik wie auf Linux-Runnern nutzen, sonst entstehen Schein-Regressionen durch unterschiedliche Rendering-Pfade.

OpenClaw soll nie das HTML Ihres Git-Hosts scrapen. Geben Sie Lesezugriff auf Repo und Report-Verzeichnis, dann beschreiben Sie eine starre Vorlage in Klartext: „Lies a11y_normalized.json; schreibe pr_a11y_summary.md mit den folgenden Abschnitten.“ Trennen Sie aus dem JSON kopierte Fakten (Regel-IDs, Zähler, Selektoren) von Fix-Vorschlägen, die Sie als Hypothesen kennzeichnen.

Praktische Reihenfolge: Executive counts (serious, moderate, minor), Top-Regeln nach impact und Häufigkeit, repräsentative Knoten (höchstens drei Beispiele pro Regel, HTML gekürzt), WCAG-Mapping falls in der Nutzlast, Retest-Befehle (exakt das npm-Skript oder Playwright-Tag), Waivers (leer, außer Ihre Policy verlangt Ticket-IDs). Versionieren Sie die Vorlage im Repo wie anderen OpenClaw-Task-Code.

Für Konsistenz zu Performance- oder Bundle-Gates spiegeln Sie die gleiche Schwellen-Sprache. Das Playbook Bundle-Analyzer-Schwellen und PR-Summary zeigt, wie Sie numerische Policy neben den Markdown-Generator legen, damit Teams nicht in Kommentar-Threads über Zahlen streiten.

Beschreiben Sie die Übergabe für Security- und Plattform-Reviews als REST-APIs plus repo-scoped Credentials, nicht als „öffnen Sie diesen Browser-Tab“. GitHub: Fine-grained Personal Access Token oder GitHub-App-Installationstoken, auf ein Repository und pull requests: write begrenzt. GitLab: Projekt-Access-Token mit api nur für dieses Projekt. Ablauf in der Dokumentation: Authentifizierung mit Authorization: Bearer bzw. PRIVATE-TOKEN; Merge-Request- oder Pull-Request-ID aus CI-Umgebungsvariablen; einen Kommentar mit dem OpenClaw-Markdown erstellen oder aktualisieren.

Vermeiden Sie eingebettete Links, die eine interaktive Sitzung voraussetzen. Für Doku nur stabile öffentliche helpUrl-Werte von axe oder WCAG-Quick-Reference. Keine Links zu internen Analytics- oder Review-UIs mit SSO-Umleitung. Verbietet die Policy direkten API-Zugriff vom Mac-Worker, POSTen Sie dasselbe Markdown an einen internen Automatisierungs-Webhook, der bereits Credentials hält — nur dieser Dienst spricht mit Git.

Idempotenz: Präfix im Kommentar-Body, z. B. <!-- openclaw-a11y:$SHA -->. Bei erneuten Läufen vorhandene PR-Kommentare nach diesem Marker durchsuchen und in-place aktualisieren. Retries: Exponentielles Backoff mit Jitter bei HTTP 429, 500 und 502, höchstens fünf Versuche; in Logs nur Token-Fingerprints, keine Secrets.

Leere Violations, die Seite wirkt kaputt. axe sieht nur das DOM, das Ihr Test lädt. Prüfen Sie, ob Sie ein Skeleton vor dem Daten-Fetch scannen oder ob Shadow-Roots geschlossen sind. Wartezeiten erhöhen oder Netzwerk-Idle vor dem Scan erzwingen.

Flaky Zähler zwischen Läufen. Werbung, Consent-Banner und Session-Timer ändern das DOM. Uhr und Locale in Playwright einfrieren, Drittanbieter-Hosts blockieren (wo erlaubt) oder Cookies setzen, die Banner schließen, bevor axe läuft.

OpenClaw erfindet Selektoren. Vorlage verschärfen: „Selektoren wörtlich aus targetSelectors kopieren; keine neuen Pfade erfinden.“ JSON-Schema fürs Normalisat validieren, bevor der Agent startet.

403 oder 401 von der Git-API. Falsche Token-Scopes oder Bot sieht Fork-Workflow nicht. Bei GitHub Actions aus Forks pull_request_target nur mit Vorsicht — oder Summary von einem vertrauten internen Dienst posten lassen.

Kommentar zu lang. Beispiele pro Regel kürzen, Pfad zum archivierten JSON-Artefakt in der CI nennen, PR-Text unter das Provider-Limit bringen, indem nur Top-Regeln ausführlich sind.