openclaw/clawsweeper：README に基づく導入ガイド

openclaw/clawsweeper の README はプロジェクトを「ClawSweeper scans all issues and PRs and suggest what we can close, and why. It runs every PR / Issue once a week.」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「🦞🧹 ClawSweeper」には次の説明があります。ClawSweeper is the conservative maintenance bot for OpenClaw repositories. It keeps the backlog reviewed, keeps maintainer-visible GitHub comments tidy, and turns narrow trusted findings into guarded repair or automerge work.。これは範囲の説明であり、本番検証の結果ではありません。

README の「Guardrails」にある内容から、用途が合うかを先に判断できます。duplicate or superseded by a canonical issue/PR。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。better suited for ClawHub skill/plugin work than core。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「Issue and PR Reviews」など複数の箇所に分かれています。確認できる情報は次の通りです。Scheduled runs scan open issues and pull requests, while target repositories can forward exact issue/PR events with repositorydispatch for low-latency one-item reviews.。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 source ~/.profile corepack enable pnpm install pnpm run build pnpm run plan -- --target-repo openclaw/openclaw --batch-size 5 --shard-count 89 --max-pages 250 --codex-model internal --codex-reasoning-effort high pnpm run review -- --target-repo openclaw/openclaw --target-dir ../openclaw --batch-size 5 --max-pages 250 --artifact-dir artifacts/reviews --codex-model internal --codex-reasoning-effort high --codex-timeout-ms 600000 pnpm run apply-artifacts -- --target-repo openclaw/openclaw --artifac 実行可能なコマンドがない場合は手順を作らず、「Capabilities」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「Issue and PR Reviews」にはClawSweeper syncs one marker-backed public review comment per item and edits it in place instead of posting repeated comments. If a review starts before a completed comment exists, it first posts a short status placeholder, then replacesとあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはlow-signal pull request whose branch is mostly unrelated or unmergeable churnともあります。