Was macht ClawSweeper?
ClawSweeper überprüft Issues und Pull Requests in OpenClaw-Repositories. Die kanonische Quelle ist openclaw/clawsweeper. Löse den tatsächlichen lokalen Checkout auf, anstatt seinen Pfad anzunehmen.
Start
Überprüfe git status --short --branch im ClawSweeper-Checkout. Status- und
Berichtsanfragen bleiben schreibgeschützt: Verwende aktuelle Berichte und Live-Read-APIs,
wenn Aktualität wichtig ist, ohne sie nur zur Überprüfung zu pullen oder zu bauen.
Für autorisierte Implementierung oder Ausführung aktualisiere einen sauberen, task-eigenen Checkout
und baue nur, wenn der ausgewählte Befehl es benötigt. Erhalte nicht zusammenhängende Änderungen
und aktive Workflows anderer Operatoren.
Lies AGENTS.md dieses Checkouts vor der Ausführung.
Ein Bot, Eine App
Verwende die clawsweeper GitHub-App und die aktuelle CLAWSWEEPER_*-Konfiguration.
Das Quell-Repository besitzt die App-Einrichtung und -Berechtigungen. Ändere keine Anmeldedaten,
Berechtigungen oder Ausführungsgates für eine Statusanfrage.
Review-Mitarbeiter schlagen Ergebnisse mit entfernten Secret-/Token-Umgebungen vor. Deterministische Workflows besitzen Kommentare, Labels und geschützte Schließungsvorschläge. Ein Überprüfungsergebnis autorisiert keine separate Mutation.
Gehostete Commit-Reviews
Gehostete Pro-Commit-Berichte und Commit Check Runs sind eingestellt. Für die beibehaltene
Offline-Überprüfung eines committeten Branches verwende pnpm local-review -- --base main.
$autoreview --mode commit --commit <sha> bleibt ein separater Allzweck-Review-Pfad.
Sweep-Berichte
Kanonische Issue/PR-Berichtsschlüssel sind:
records/<repo-slug>/items/<number>.md
records/<repo-slug>/closed/<number>.md
Der Worker-Store besitzt aktuelle Aufzeichnungen. Überprüfe die Aktualität, bevor du dich auf eine lokale Kopie verlässt. Beginne mit Zählungen, konkreten Ergebnissen und Berichtslinks. Poste keine unaufgeforderten GitHub-Kommentare aus Berichtslese-Arbeiten.
PR-Berichte enthalten reviewFindings mit Priorität, Konfidenz, repository-relativem
Dateipfad und Zeilenbereich. Öffentliche Kommentare zeigen kurze Ergebnisse und
zusammengeklappte Review-Details. Lies das dauerhafte Ergebnis, anstatt den Umfang aus
Labels abzuleiten.
Für eine einfache Statusabfrage lies vorhandene Berichte und begrenzte Live-Workflow-Zustände.
Verwende pnpm run audit nur für eine angeforderte vollständige Überprüfung.
Abgleich ist eine separate autorisierte Mutation: Bloßes pnpm run reconcile
verschiebt/löscht Berichts- und Arbeitsplan-Dateien. Überprüfe seinen Trockenlauf nur, wenn
diese Wartungsaufgabe angefordert wird. Ebenso gehört apply-decisions zu einem
explizit autorisierten Apply-Workflow, beginnend mit dessen Trockenlauf.
Maintainer-Erwähnungen
Bevorzuge die unterstützten Erwähnungsbefehle:
@clawsweeper review
@clawsweeper re-review
@clawsweeper explain
@clawsweeper stop
@clawsweeper help
review und re-review fordern eine neue schreibgeschützte Issue/PR-Überprüfung an.
explain fasst den aktuellen Status zusammen. Review-Befehle können schreibgeschützten
Fokus-Kontext enthalten. Frei formulierte Fragen und Aktionsanfragen starten keine Reparatur.
Item-Autoren können re-review oder re-run auf ihren eigenen offenen Items verwenden.
Der Router überprüft die aktuelle Kommentaridentität und Repository-Berechtigungen.
Die Repository-Mitgliedschaft allein begründet keine Befehlsautorität.
stop errichtet den menschlichen Review-Halt, bevor alte Reparatur-Loop-Labels entfernt werden.
Lass diesen unterstützten Befehl den Übergang durchführen. Entferne keine Schutzlabels
manuell, um ihn zu reproduzieren.
Starte eine autorisierte Kommentar-Routing-Aufgabe mit ihrem Trockenlauf:
pnpm run repair:comment-router -- --repo openclaw/openclaw --lookback-minutes 180
Der Befehl verwendet standardmäßig den Trockenlauf. Geplantes Routing bleibt trocken, es sei denn,
CLAWSWEEPER_COMMENT_ROUTER_EXECUTE=1 gesetzt ist. Verwende --execute nur für eine
autorisierte Routing-Aufgabe. Schalte oder setze Gates nicht als generische Bereinigung zurück.
Eingestellte Befehle und geschützter Zustand
Reparatur-, Autofix-, Automerge-, Issue-Implementierungs-, Fix-CI-, Address-Review-, Rebase-
und Approve-Befehle sind eingestellt. @clawsweeper status ist ebenfalls eingestellt.
Verwende @clawsweeper explain. Die entfernten Einstiegspunkte zur Reparatur-Job-Erstellung,
-Validierung, -Dispatch und -Ausführung sind nicht verfügbar.
Für autorisierte Code-Reparaturen und Merges folge dem Maintainer-Workflow. Behandle einen eingestellten Befehl oder ein Label nicht als Ausführungs- oder Merge-Autorität.
Vorhandene clawsweeper:autofix- und clawsweeper:automerge-Labels schützen weiterhin Items
vor automatischem Schließen. Erhalte diese Halte, aktive oder unbekannte Besitzer,
Leases, Sperren, Quittungen und Wiederherstellungsnachweise. Die Einstellung allein autorisiert
keine Bereinigung oder Übernahme. Verbleibende repair:-Werkzeuge unterstützen Reviews,
Veröffentlichung und Wartung. Ihr Name stellt keine Reparaturausführung wieder her.
Sicherheitsgrenze
Leite Schwachstellenmeldungen und sensible Offenlegungen über das OpenClaw Security Handling. Ein Überprüfungsergebnis oder eingestelltes Reparaturlabel hebt die Sicherheitsfreigabe, die Quellvertrauenswürdigkeit, die erforderliche Überprüfung oder native Merge-Gates nicht auf.
Überwachung
Unterscheide den erfolgreichen Eingang von einer aktiven Überprüfung mithilfe der Review-Admission Guidance.
Empfänger-Workflows:
gh run list --repo openclaw/clawsweeper --workflow sweep.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
gh run list --repo openclaw/clawsweeper --workflow repair-comment-router.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
gh run list --repo openclaw/clawsweeper --workflow github-activity.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
Ziel-Dispatcher:
gh run list --repo openclaw/openclaw --workflow "ClawSweeper Dispatch" \
--limit 8 --json databaseId,displayTitle,event,status,conclusion,headSha,url
Ausgabe lesen
Für Ergebnisse oder Fehler fasse zusammen:
- Ziel-Repo, Item/PR, Run, Berichtsschlüssel
- Ergebnis, Konfidenz, Schweregrad und exakter Blocker
- betroffene Dateien und Validierungsergebnisse
- tatsächliche Mutationsautorität und nächste deterministische Aktion.