OpenClaw · knip · JSON · Remote Mac · CI · 2026

2026 OpenClaw Frontend-Praxis:
Auf dem Remote Mac knip-JSON zu einer lesbaren PR-Cleanup-Summary falten und zurückspielen

23. April 2026 Frontend-Qualität & Monorepo ca. 10 Min.

Zielgruppe: Teams, die ungenutzte Exporte im TypeScript-Monorepo abbauen wollen, ohne PRs mit Roh-JSON zu fluten. Dieser Text liefert eine fest verdrahtete knip-Konfiguration, einen CI-Artefakt-Pfad, eine Markdown-Vorlage mit Pflichtfeldern sowie ein FAQ zu Fehlalarmen. Kontext aus dem gleichen OpenClaw-Ökosystem: Bundle-Graph und Tree-Shaking-Summary, Build-Metriken im PR und Biome plus inkrementeller Typecheck. Preise, Hilfe und Kaufen bleiben auf macwww.com ohne Login-Zwang erreichbar.

01 Knip-Konfiguration

Pull-Request-Reviews brauchen stabile Subjekte: welche Datei, welches Symbol, welcher knip-Grundcode. Roh-JSON aus der Pipeline ist zwar maschinenlesbar, verschwendet aber Zeichenbudget und riskiert, dass Umgebungsvariablen oder Pfade aus dem Runner in Screenshots rutschen. Die folgende Matrix begründet, warum Sie verdichten, bevor OpenClaw antwortet.

Kriterium Roh-JSON im Kommentar Verdichtete OpenClaw-Summary Sicherheit Review-Tempo
Lesbarkeit Schlecht: tiefe Struktur, viele Keys. Gut: drei Spalten plus Kopfzeilen. Mittel: manuelles Copy-Paste-Risiko. Niedrig bis mittel.
Geheimnisse Riskant: Pfade können Home-Verzeichnisse zeigen. Nur relative Repo-Pfade und Symbolnamen. Hoch: stdout bleibt leer von Tokens. Hoch.
Reproduzierbarkeit Abhängig vom Runner-Image. Gleiche jq- oder Node-Transform auf Remote Mac und in CI. Hoch bei fixiertem Node-Minor. Hoch.
Idempotenz Neue Kommentar-Ketten pro Push. HTML-Kommentar-Marker oder fester Idempotency-Key aktualisiert einen Block. Hoch. Mittel.
Querverweise Schwer mit Build- oder Bundle-Themen zu korrelieren. Gleiche Überschriften wie Build-Summaries erleichtern Suche. Neutral. Hoch.
Zitierfähige Kennzahl

Pro PR höchstens 25 Tabellenzeilen plus eine Zeile Restmenge — alles darüber bleibt im Artefakt.

Versionieren Sie eine knip-Konfiguration pro Review-Oberfläche. Der json-Reporter liefert eine Liste von Issues; filtern Sie auf unused exports, wenn Ihr Team zuerst öffentliche API-Oberflächen entschlacken will. entry muss alle realen Einstiegspunkte enthalten, sonst fehlen Kanten im Graph und knip übertreibt.

Typische Engpässe vor dem ersten grünen Lauf: erstens fehlende Storybook- oder Playwright-Ordner in project, zweitens dynamische Routen, drittens generierte Dateien, die noch nicht in ignore liegen. Halten Sie Ignores kurz und reviewbar — längere Listen deuten auf falsche Entry-Zerschneidung hin.

{
  "entry": ["apps/web/src/main.tsx", "packages/ui/src/index.ts"],
  "project": ["apps/web/src/**/*.tsx", "packages/ui/src/**/*.ts"],
  "ignore": ["**/*.stories.tsx", "**/generated/**"],
  "ignoreDependencies": ["@playwright/test"],
  "reporter": "json"
}
Zitierfähige Kennzahl

Ignores unter zehn konsolidierte Muster halten; darüber hinaus lieber Workspace splitten.

02 CI-Artefakt-Pfade

Schreiben Sie die knip-Ausgabe immer unter demselben relativen Pfad ins Workspace-Root, damit nachgelagerte Schritte keine if-else-Ketten über Runner-Labels brauchen. Ein bewährtes Muster ist artifacts/knip/unused.json direkt unter dem Repository, plus ein kleines sha.txt daneben.

Laden Sie das Artefakt in Ihre Plattform hoch, beschränken Sie aber den OpenClaw-Body auf Markdown plus einen Link. Auf einem Remote Mac wiederholen Sie exakt dieselbe jq-Pipeline wie in GitHub Actions oder GitLab CI, damit Zahlen nicht auseinanderlaufen — Apple Silicon liefert stabile Latenzen für wiederholte knip-Läufe in großen Workspaces.

HowTo: minimal reproduzierbare Schritte

  1. knip mit festem --config ausführen und denselben Befehl im Remote-Runbook dokumentieren.
  2. Stdout unterdrücken, stattdessen nur nach artifacts/knip/unused.json schreiben.
  3. jq- oder Node-Transform erzeugt drei Spalten: Datei, Symbol, knip-Code — ohne Shell-Metazeichen im PR-Text.
  4. Vorlagenfelder aus dem nächsten Abschnitt mit Zahlen füllen und risk_label setzen.
  5. HMAC-POST an das OpenClaw-Gateway oder gh pr comment mit HTML-Marker <!-- openclaw-knip:$SHA --> für Updates statt Spam.

Checkliste vor dem Merge

  • Artefakt-Pfad steht in der Team-README und im Runbook.
  • Skript scripts/knip/pr-summary.sh ist versioniert und ausführbar.
  • Node-Minor auf Remote Mac und CI identisch (z. B. via .node-version).
  • Idempotency-Key aus prNumber:gitSha in den Logs nachweisbar.
  • Bundle-Regression: nach Export-Cleanup Tree-Shaking-Summary ansehen.

03 Felder der Zusammenfassungsvorlage

Die OpenClaw-Vorlage soll keine Freitext-Flut erlauben. Nutzen Sie feste Überschriften, die auch in anderen Automatisierungen wieder auftauchen, etwa Knip unused exports neben Build performance aus der Build-Metrik-Summary.

Feldname Inhalt Pflicht Format
issue_count Anzahl ungenutzter Exporte nach Filter. Ja Integer als Text.
top_paths Bis zu drei Verzeichnisse mit den meisten Treffern. Ja Bullet-Liste.
table_md Markdown-Tabelle Datei, Symbol, knip-Code. Ja Maximal 25 Zeilen.
risk_label low, medium oder high je nach öffentlicher API. Ja Ein Wort.
next_action Ein Satz: merge blocken oder nur informieren. Ja Plaintext.
artifact_url Link zum vollständigen JSON. Empfohlen HTTPS-URL.

Gateway-Token bleiben außerhalb des Markdowns; der OpenClaw-Prozess liest Secrets nur aus der Prozessumgebung. So bleibt dasselbe Template kompatibel mit Slack, Teams oder GitHub ohne erneute Redaktion.

04 FAQ: Fehlalarme und Ausnahmen

Dynamische import()-Aufrufe erscheinen als unbenutzt

Prüfen Sie, ob der Aufrufpfad außerhalb des project-Glob liegt oder ob ein Barrel-File die Kante verschleiert. Ergänzen Sie gezielte ignoreBinaries- oder Workspace-Ausnahmen statt globalem Ausschalten des Regelsatzes.

Öffentliche UI-Bibliothek mischt sich mit internen CLI-Paketen

Legen Sie zwei knip-Dateien an und rufen Sie in der CI zwei Jobs mit unterschiedlichen --config-Pfaden auf. Nur der Produktions-Job speist die OpenClaw-Summary.

PR-Kommentar überschreitet Zeichenlimit

Kürzen Sie auf Top zwanzig plus Restzahl; verlinken Sie das Artefakt. Für interne Auditorien kann ein zweiter, längerer Kommentar mit Bot-Account folgen — getrennte Tokens verhindern Kostenfalle.

Ein gemieteter Apple-Silicon-Mac repliziert lange knip-Läufe ohne thermisches Drosseln des Laptops und hält jq plus Node über denselben Installer aligned mit der Linux-CI.
Remote Mac · knip · OpenClaw

Qualitäts-Gateway auf echter Apple-Silicon-Hardware betreiben

Mieten Sie einen Mac Mini M4 für wiederholbare knip-Läufe, JSON-Transformation und OpenClaw-Webhooks — parallel zu Safari- oder Playwright-Pipelines. Preise und Kaufen sind ohne Konto einsehbar; SSH- und VNC-Anleitungen in der Hilfe. Zur Übersicht aller Artikel: Technik-Einblicke.

Cleanup OpenClaw PR-Summary
Remote Mac für knip & OpenClaw