ClawSweeper is a maintenance bot designed specifically for OpenClaw repositories that automates the review and management of issues and pull requests. Written in TypeScript, it scans open issues and PRs on a scheduled basis and through exact GitHub events to propose which items can be safely closed and why. The bot runs reviews on every PR and issue once a week, maintaining a conservative approach to automation by keeping proposals separate from enforcement and requiring explicit maintainer approval before taking action.
The bot's primary targets are openclaw/openclaw, openclaw/clawhub, and its own repository for self-review. ClawSweeper is not positioned as a public review service and does not provide free reviews for third-party repositories. Users who want to use ClawSweeper for their own projects must fork the repository, deploy it within their own organization, and configure it for their specific repositories.
At its core, ClawSweeper performs several interconnected functions. It reviews open issues and pull requests on a schedule and in response to exact GitHub events, writing one durable markdown report per item in generated state. The bot syncs one marker-backed public review comment per issue or PR, editing it in place rather than posting repeated comments. It closes only unchanged, high-confidence, policy-allowed proposals and routes maintainer commands such as @clawsweeper review, @clawsweeper fix, @clawsweeper autofix, and @clawsweeper automerge. The bot can repair opted-in PRs through a bounded Codex review and fix loop before merge, automatically open guarded implementation PRs for viable reviewed issues in eligible public repositories, and manually review selected code-bearing commits on target main branches.
The review process is deliberately conservative. Maintainer-authored items stay open unless ClawSweeper can verify the request is already implemented on current main. Issues with open PRs that reference them using GitHub closing syntax remain open until that PR merges, is closed, or ClawSweeper closes that PR candidate.
Repository-specific rules live in src/repository-profiles.ts, allowing OpenClaw, ClawHub, and ClawSweeper to share the same engine while maintaining different apply limits for each project. Generated state is published to openclaw/clawsweeper-state on the state branch, containing durable records, jobs, results, audit output, workflow status, repair ledgers, and the rendered dashboard.
