Skip to main content
Diese Seite erläutert den Review-Ablauf, nachdem Sie einen OpenClaw-Pull-Request geöffnet oder aktualisiert haben: was Barnacle und ClawSweeper tun, wie Sie den PR anhand ihres Feedbacks verbessern und was Sie prüfen sollten, wenn die Automatisierung keine Rückmeldung gibt. Barnacle und ClawSweeper helfen den Maintainern, die Review-Warteschlange nutzbar zu halten. Sie ersetzen nicht das Urteil der Maintainer.

Barnacle

Barnacle führt deterministisches GitHub-Triage durch. Es sucht nach bekannten Fällen der Warteschlangenverwaltung und reagiert mit Labels, Kommentaren oder Schließungen. Barnacle kann aktiv werden, wenn:
  • ein PR-Text größtenteils leer ist oder der Problemkontext fehlt;
  • ein PR keine brauchbaren Nachweise enthält;
  • bei einer reinen Dokumentations-, Test-, Refactoring-, CI- oder Infrastrukturänderung ein verknüpfter Maintainer-Kontext fehlt;
  • eine Änderung so aussieht, als gehöre sie statt in den Core zu ClawHub oder einem Plugin;
  • ein Branch nicht zugehörige Arbeiten enthält;
  • ein Autor mehr als 20 offene PRs hat.
Barnacle wird mit vertrauenswürdigem Workflow-Code des Repositorys ausgeführt. Es checkt Beitragenden-Code weder aus noch führt es ihn aus. Die meisten Routing-Labels sind Signale für Maintainer oder die Automatisierung, daher müssen Beitragende selbst keine Labels hinzufügen.

ClawSweeper

ClawSweeper ist der KI-gestützte Review- und Wartungs-Bot für OpenClaw- Repositorys. Er kann PRs prüfen, Nachweise bewerten, dauerhafte Review-Kommentare hinterlassen und Maintainer bei abgesicherten Reparatur- oder Automerge-Abläufen unterstützen. Ein positives ClawSweeper-Ergebnis ist ein unterstützender Nachweis, keine Genehmigung durch Maintainer. Die Maintainer entscheiden weiterhin, ob und wann ein PR zum Mergen bereit ist. ClawSweeper arbeitet warteschlangenbasiert. Erwarten Sie keine sofortige Antwort, nachdem Sie einen PR geöffnet, einen Commit gepusht oder eine Review-Anfrage hinzugefügt haben. Auch Label-Aktualisierungen nach einem ClawSweeper-Durchlauf können einige Zeit dauern. Neue PRs gelangen in die ClawSweeper-Review-Warteschlange. Maintainer können außerdem Review-, Reparatur- oder Automerge-Abläufe mit Labels oder Befehlen in die Warteschlange einreihen. Fordern Sie bei gewöhnlichen Aktualisierungen durch Beitragende erst dann ein weiteres Review von ClawSweeper an, nachdem Sie den Branch, die PR-Beschreibung, die Nachweise oder den Code aktualisiert haben. Fordern Sie anschließend mit einem neuen PR-Kommentar ein frisches Review an:
PR-Autoren können auch @clawsweeper re-run verwenden; Benutzer mit Schreibzugriff auf das Repository können für jedes offene Element beide Befehle verwenden. Der einfache Befehl @clawsweeper review ist ausschließlich Maintainern vorbehalten. Haben Sie Geduld: Eine erneute Anfrage, bevor die angeforderten Änderungen vorliegen, erzeugt lediglich zusätzliche Störungen in der Warteschlange. Wenn ClawSweeper Review-Konversationen hinterlässt, behandeln Sie diese wie normales Review- Feedback und verwenden Sie die nachfolgende Checkliste. Wenn ein menschlicher Beitragender oder Maintainer den PR übernommen hat und aktiv daran arbeitet, rufen Sie nicht gleichzeitig ClawSweeper auf und arbeiten Sie auch nicht anderweitig am PR. Lassen Sie das menschliche Review oder die Reparatur zuerst abschließen. Wenn die Aktivität endet, prüfen Sie, ob der Autor aufgefordert wurde, Nachweise bereitzustellen oder andere Aktualisierungen vorzunehmen.

Einen PR während des Reviews verbessern

Sobald Barnacle, ClawSweeper oder ein Maintainer antwortet, verwenden Sie dieses Feedback als Checkliste für die nächsten Schritte des PRs.
  1. Lesen Sie ClawSweepers Rank-up moves: und Proof guidance: als Maßnahmenliste für diesen PR. Bewertungen und Labels sind Review-Signale, keine festen Merge-Ziele.
  2. Pushen Sie die angeforderte Code- oder Dokumentationsänderung und aktualisieren Sie die PR-Beschreibung, wenn sich das Problem, die Lösung, die Auswirkungen auf Benutzer oder die Nachweise geändert haben.
  3. Fügen Sie den angeforderten Nachweis hinzu und verwenden Sie dafür Nachweise, die zur Änderung passen.
  4. Lösen Sie bearbeitete Review-Konversationen selbst auf. Antworten Sie und lassen Sie eine Konversation nur dann offen, wenn Sie eine Entscheidung durch Maintainer oder Reviewer benötigen.
  5. Fordern Sie erst dann ein erneutes Review an, wenn der Branch, die PR-Beschreibung, die Nachweise und die relevanten CI-Ergebnisse aktuell sind. Mehrere Aktualisierungs- und Review-Zyklen zwischen Autor, Maintainer und ClawSweeper sind normal.
  6. Führen Sie die Diskussion nach Möglichkeit im PR. Wechseln Sie nur dann zu #clawtributors auf Discord, wenn der PR eine Koordination mit Maintainern erfordert, die Automatisierung blockiert zu sein scheint oder sich die nächste Entscheidung nur schwer in GitHub-Kommentaren klären lässt. Geben Sie den PR- Link, den aktuellen Status und die konkrete Frage oder den noch fehlenden Nachweis an.
Halten Sie den PR-Text aktuell. Kommentare helfen bei der Diskussion, aber die PR- Beschreibung ist die dauerhafte Zusammenfassung, auf die Maintainer und Automatisierung erneut zurückgreifen. status: ⏳ waiting on author bedeutet, dass die nächste Aktion beim PR-Autor liegt: Aktualisieren Sie den Branch, die PR-Beschreibung oder die Nachweise beziehungsweise antworten Sie mit dem fehlenden Kontext, bevor Sie ein weiteres Review anfordern. Nützliche Nachweise umfassen die Ausgabe fokussierter Tests, CI-Ergebnisse, Screenshots, Aufzeichnungen, Terminalausgaben, Live-Beobachtungen, bereinigte Protokolle oder Links zu Artefakten. Fügen Sie bei visuellen Änderungen nach Möglichkeit Vorher- und Nachher-Screenshots hinzu. Verlinken Sie für Nachweisdateien vorzugsweise CI-Artefakte, auf GitHub hochgeladene Screenshots oder Aufzeichnungen oder einen kurzen bereinigten Protokollauszug. Committen Sie keine generierten Nachweisdateien, sofern diese nicht Teil der eigentlichen Dokumentations-, Test- oder Produktänderung sind. Die Bereinigung sensibler Daten liegt in der Verantwortung des Beitragenden. Entfernen Sie Secrets, Tokens, private URLs, Benutzerdaten und nicht zugehörige Protokolle, bevor Sie Nachweise veröffentlichen. OpenClaw verwendet außerdem eine separate Automatisierung für inaktive Elemente. Nicht zugewiesene Issues und PRs können nach 14 Tagen ohne Aktivität als inaktiv markiert und nach weiteren 7 inaktiven Tagen geschlossen werden. Zugewiesene PRs werden 27 Tage nach dem Öffnen als inaktiv markiert, unabhängig von späteren Aktualisierungen, und anschließend nach 7 inaktiven Tagen ohne Aktivität geschlossen. Wenn ein zugewiesener PR noch aktiv ist, stimmen Sie sich mit dem daran arbeitenden Maintainer ab.

Wenn die Automatisierung keine Rückmeldung gibt

Die Automatisierung kann ohne Rückmeldung bleiben, wenn ein Maintainer das Element bereits bearbeitet, eine Review- oder Reparaturanfrage noch in der Warteschlange steht, das Ereignis routinemäßig ist oder die ClawSweeper-Ausführungsspur nicht für die angeforderte Aktion konfiguriert ist. Sie kann auch auf eine Aktion verzichten, wenn ein vertrauenswürdiger Workflow nicht vertrauenswürdigen Beitragenden-Code ausführen müsste. In diesem Fall verwenden Maintainer stattdessen ein normales Review oder einen sichereren Workflow.

Fehlerbehebung

Wenn ClawSweeper nicht sofort antwortet, warten Sie, bevor Sie es erneut versuchen. Der Dienst arbeitet warteschlangenbasiert, und wiederholte Kommentare oder Label-Änderungen können die Prüfung des Threads erschweren, ohne die Warteschlange zu beschleunigen. Prüfen Sie Folgendes, bevor Sie um Hilfe bitten:
  • Die PR-Beschreibung ist aktuell;
  • der neueste Commit enthält die angeforderte Änderung;
  • die CI ist abgeschlossen oder der PR-Text erläutert, warum ein verbleibender Fehler nicht mit dem PR zusammenhängt;
  • die neueste Review-Anfrage wurde als PR-Kommentar gestellt: @clawsweeper re-review;
  • kein Maintainer oder Beitragender arbeitet bereits aktiv am PR;
  • die neueste Anfrage liegt nicht noch innerhalb der normalen Wartezeit der ClawSweeper-Warteschlange.
Wenn mehrere Stunden, nachdem der PR auf dem aktuellen Stand ist, weiterhin keine ClawSweeper-Antwort vorliegt oder der PR durch die Automatisierung blockiert zu sein scheint, fragen Sie in #clawtributors auf Discord nach. Geben Sie den PR-Link an, was Sie erwartet haben, wann Sie die Anfrage gestellt haben und was sich seit dem letzten Bot-Kommentar geändert hat.

Die Automatisierung forken

Projekte, die eine ähnliche Review-Automatisierung wünschen, können ClawSweeper untersuchen oder forken:

Verwandte Themen