OpenClaw - maintenance bot

Sideways through the backlog.
Sweep what's safe.
Leave the rest.

ClawSweeper is the conservative maintenance bot for OpenClaw. It reviews issues, pull requests, and code-bearing commits; keeps one durable public comment per item; and turns narrow trusted findings into guarded repair or automerge work.

Read the docs View on GitHub

No closes without evidence. No autocomments without a marker. No mutations without an audit.

One report per item

Every reviewed issue and PR becomes records/<repo>/items/<n>.md: decision, evidence, proposed comment, runtime metadata, and snapshot hash.

Durable review comments

ClawSweeper edits a single marker-backed comment per item instead of stacking new ones. Maintainers get one source of truth, not noise.

Conservative apply

A close is only proposed when the item is implemented, unreproducible, duplicate, incoherent, or obviously stale. Maintainer-authored stays open.

Four operational lanes

Review, apply, repair, and commit review run as separate lanes. Each lane has its own state, gates, and GitHub Actions path.

Targeted dispatch

Target repos forward repository_dispatch for low-latency single-item review or commit-range review without polling.

Repair, gated

Opted-in PRs can run through review, fix, re-review, and merge. Strict reproducible bug issues can open one guarded generated PR.

A sweep, in motion

Read, write, propose. Never the other way round.

ClawSweeper does not act on raw model output. Every decision lands in the report repo first; every comment is gated by a marker; every mutation is replayed against live GitHub state before the API call.

  • Read - GitHub snapshot, prior report, repository profile, paired issue/PR state.
  • Write - one markdown report per item or commit, with a hashed snapshot.
  • Act - one durable comment, guarded apply, and repair only through explicit trusted gates.

Four lanes, one engine

->

Review Lane

Scheduled and event-driven issue/PR reviews. Planner paths: exact event, hot intake, normal backfill.

->

Apply Lane

Guarded comment and close mutations. Re-fetches live GitHub state before every write.

->

Repair Lane

Bounded "review, fix, re-review, merge" loop for opted-in PRs and strict generated bug PRs.

->

Commit Review Lane

Reviews code-bearing commits on main. Skips non-code commits cheaply. Optional Check Runs.

Guardrails

A close is allowed only when the item is clearly one of these. Maintainer-authored items are never auto-closed.

  • Implemented on current main
  • Not reproducible on current main
  • Better suited for ClawHub skill / plugin work
  • Duplicate or superseded by a canonical item
  • Concrete but not actionable in this source repo
  • Incoherent enough that no action can be taken
  • Stale issue older than 60 days with too little data to verify