ClawSweeper is an automated maintenance bot designed to streamline the management of GitHub issues and pull requests, and to provide automated code commit reviews for OpenClaw repositories. It aims to reduce the manual overhead for maintainers by intelligently identifying issues and PRs that can be closed, and by offering preliminary feedback on code commits. The system is built for maintainers seeking to improve repository hygiene and efficiency.

How It Works

ClawSweeper operates through two primary lanes: an issue/PR sweeper and a commit sweeper. The issue/PR lane uses a scheduler to periodically scan open items, generating detailed markdown reports and durable review comments via an LLM (Codex, specifically GPT-5.5). It employs a "guarded apply" mechanism, re-validating live GitHub state against stored review decisions before automatically closing items based on predefined criteria. The commit sweeper analyzes code commits pushed to the main branch, classifying them, running Codex reviews on code-bearing commits, and generating reports, with optional GitHub Check Run integration. Repository-specific rules are managed via profiles.

Quick Start & Requirements

Local execution requires Node.js (version 24 recommended), corepack, and pnpm. Installation involves pnpm install and pnpm run build. Running the core functionalities involves commands like pnpm run plan, pnpm run review, and pnpm run apply-artifacts. Essential prerequisites include an OpenAI API key (OPENAI_API_KEY) for Codex access and GitHub App credentials (CLAWSWEEPER_APP_CLIENT_ID, CLAWSWEEPER_APP_PRIVATE_KEY) for interacting with GitHub.

Highlighted Details

• Repository Profiles: Customizable rules per repository located in src/repository-profiles.ts.
• Codex Reviews: Leverages GPT-5.5 with high reasoning effort and fast service tier, generating detailed markdown reports (records/<repo-slug>/items/<number>.md).
• Durable Comments: Edits a single marker-backed review comment in place, avoiding redundant comments.
• Guarded Apply: Ensures actions are taken only after re-verifying live GitHub state, labels, authorship, and item status.
• Commit Review: Classifies commits, runs Codex on code changes, and generates reports (records/<repo-slug>/commits/<sha>.md). Optional GitHub Checks can be enabled.
• Fleet Dashboard: The README includes a dashboard summarizing the operational status across configured repositories.
• Audit & Reconcile: Tools (pnpm run audit, pnpm run reconcile) to verify data integrity between GitHub and stored records.

Maintenance & Community

The project is associated with OpenClaw repositories (openclaw/openclaw, openclaw/clawhub). Specific details on core contributors, sponsorships, or community channels (like Discord/Slack) are not provided in the README.

Licensing & Compatibility

License information is not explicitly stated in the provided README content. Compatibility is designed for GitHub repositories, with specific setup instructions for target repositories to integrate dispatch workflows.

Limitations & Caveats

Automated closing is conservative: maintainer-authored items, items with protected labels, open PRs with closing syntax, and same-author issue/PR pairs are excluded from auto-closure. Codex requires an OpenAI API key, and GitHub operations necessitate specific GitHub App credentials and permissions. Commit Check Runs are opt-in and disabled by default. The audit health for openclaw/openclaw indicates "Action needed," suggesting potential discrepancies between GitHub state and stored records.