2026 OpenClaw Frontend-Praxis:
Auf dem Remote Mac knip-JSON zu einer lesbaren PR-Cleanup-Summary falten und zurückspielen
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. |
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"
}
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
- knip mit festem
--configausführen und denselben Befehl im Remote-Runbook dokumentieren. - Stdout unterdrücken, stattdessen nur nach
artifacts/knip/unused.jsonschreiben. - jq- oder Node-Transform erzeugt drei Spalten: Datei, Symbol, knip-Code — ohne Shell-Metazeichen im PR-Text.
- Vorlagenfelder aus dem nächsten Abschnitt mit Zahlen füllen und
risk_labelsetzen. - HMAC-POST an das OpenClaw-Gateway oder
gh pr commentmit 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.shist versioniert und ausführbar. - Node-Minor auf Remote Mac und CI identisch (z. B. via
.node-version). - Idempotency-Key aus
prNumber:gitShain 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.
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.