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 and pull requests, can inspect a committed local branch range before submission, keeps one durable public comment per GitHub 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.

Three hosted operational lanes

Review, apply, and repair run as separate hosted lanes. Local branch review is a pre-submission tool, not a hosted workflow lane.

Targeted dispatch

Target repos forward repository_dispatch for low-latency single-item 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.

Three hosted lanes, plus local review

->

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.

->

Local Branch Review

Pre-PR review of a committed local branch range. GitHub context stays local while Codex connects to its configured model service.

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