ClawSweeper は何をしますか?
ClawSweeperは、OpenClawリポジトリ全体のIssueとプルリクエストをレビューします。 その公式ソースは openclaw/clawsweeper です。 実際のローカルチェックアウトを解決し、パスを推測しないでください。
開始
ClawSweeperチェックアウトで git status --short --branch を確認します。ステータスと
レポートリクエストは読み取り専用のままです。新鮮さが重要な場合は、現在のレポートとライブ読み取りAPIを使用し、
調査するためだけにプルやビルドを行わないでください。
認可された実装または実行の場合は、クリーンなタスク所有のチェックアウトを更新し、
選択したコマンドが必要な場合にのみビルドします。無関係な編集や
他のオペレーターのアクティブなワークフローは保持します。
実行前にそのチェックアウトの AGENTS.md を読んでください。
1つのボット、1つのアプリ
clawsweeper GitHubアプリと現在の CLAWSWEEPER_* 設定を使用します。
ソースリポジトリがアプリのセットアップと権限を所有します。ステータスリクエストのために
認証情報、権限、または実行ゲートを変更しないでください。
レビューワーは、シークレット/トークン環境を除去した状態で結果を提案します。 決定論的ワークフローがコメント、ラベル、およびガードされたクローズ提案を所有します。 レビュー結果は、別個の変更を認可しません。
ホストされたコミットレビュー
ホストされたコミットごとのレポートとコミットチェックランは廃止されました。
コミットされたブランチの保持されたオフラインレビューには、pnpm local-review -- --base main を使用します。
$autoreview --mode commit --commit <sha> は、別の汎用レビューパスとして残ります。
スイープレポート
公式のIssue/PRレポートキーは以下の通りです:
records/<repo-slug>/items/<number>.md
records/<repo-slug>/closed/<number>.md
Workerストアが現在のレコードを所有します。ローカルコピーに依存する前に、新鮮さを確認してください。 件数、具体的な調査結果、およびレポートリンクを先頭に表示します。 レポート読み取り作業から、要求されていないGitHubコメントを投稿しないでください。
PRレポートには、優先度、信頼度、リポジトリ相対ファイル、および行範囲を含む reviewFindings が含まれます。
公開コメントには、短い調査結果と折りたたまれたレビューの詳細が表示されます。
ラベルからカバレッジを推測するのではなく、永続的な結果を読んでください。
簡単なステータスリクエストの場合は、既存のレポートと制限されたライブワークフローの状態を読み取ります。
要求された完全な監査の場合にのみ pnpm run audit を使用します。
調整は別個の認可された変更です。ベアの pnpm run reconcile は
レポートと作業計画ファイルを移動/削除します。そのメンテナンスタスクが要求された場合にのみ、
ドライランを検査してください。同様に、apply-decisions は明示的に認可された
適用ワークフローに属し、ドライランから開始します。
メンテナーへのメンション
サポートされているメンションコマンドを優先してください:
@clawsweeper review
@clawsweeper re-review
@clawsweeper explain
@clawsweeper stop
@clawsweeper help
review と re-review は、新しい読み取り専用のIssue/PRレビューを要求します。
explain は現在のステータスを要約します。レビューコマンドには、読み取り専用の焦点コンテキストを含めることができます。
任意の自由形式の質問やアクションリクエストは、修復を開始しません。
アイテムの作成者は、自分自身のオープンアイテムに対して re-review または re-run を使用できます。
ルーターは、現在のコメントのIDとリポジトリの権限をチェックします。
リポジトリのメンバーシップだけでは、コマンド権限は確立されません。
stop は、古い修復ループラベルを削除する前に、人間によるレビューホールドを確立します。
そのサポートされたコマンドにトランジションを任せてください。それを再現するために、
保護ラベルを手動で削除しないでください。
認可されたコメントルーティングタスクをドライランで開始します:
pnpm run repair:comment-router -- --repo openclaw/openclaw --lookback-minutes 180
コマンドはデフォルトでドライランです。スケジュールされたルーティングは、
CLAWSWEEPER_COMMENT_ROUTER_EXECUTE=1 が設定されていない限り、ドライランのままです。
認可されたルーティングタスクの場合にのみ --execute を使用します。
汎用的なクリーンアップとしてゲートを切り替えたりリセットしたりしないでください。
廃止されたコマンドと保護された状態
修復、自動修正、自動マージ、Issue実装、fix-ci、address-review、リベース、
および承認コマンドは廃止されました。@clawsweeper status も廃止されました。
@clawsweeper explain を使用してください。削除された修復ジョブの作成、検証、ディスパッチ、
および実行エントリポイントは利用できません。
認可されたコード修復とランディングについては、 メンテナーワークフロー に従ってください。 廃止されたコマンドやラベルを実行権限やマージ権限として扱わないでください。
既存の clawsweeper:autofix および clawsweeper:automerge ラベルは、
アイテムを自動クローズから保護し続けます。これらのホールド、アクティブまたは未知の所有者、リース、ロック、
レシート、およびリカバリ証拠を保持してください。廃止だけでは、クリーンアップや
引き継ぎは認可されません。残りの repair: ツールは、レビュー、公開、およびメンテナンスをサポートします。
その名前は修復実行を復元しません。
セキュリティ境界
脆弱性レポートと機密情報の開示は、 OpenClaw セキュリティハンドリング を通じてルーティングしてください。 レビュー結果や廃止された修復ラベルは、セキュリティ承認、ソースの信頼、 必要なレビュー、またはネイティブなマージゲートを無効にしません。
監視
レビュー受付ガイダンス を使用して、 受付成功とアクティブなレビューを区別してください。
レシーバーワークフロー:
gh run list --repo openclaw/clawsweeper --workflow sweep.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
gh run list --repo openclaw/clawsweeper --workflow repair-comment-router.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
gh run list --repo openclaw/clawsweeper --workflow github-activity.yml \
--limit 12 --json databaseId,displayTitle,event,status,conclusion,createdAt,updatedAt,url
ターゲットディスパッチャー:
gh run list --repo openclaw/openclaw --workflow "ClawSweeper Dispatch" \
--limit 8 --json databaseId,displayTitle,event,status,conclusion,headSha,url
出力の読み取り
調査結果や失敗については、以下を要約してください:
- ターゲットリポジトリ、アイテム/PR、実行、レポートキー
- 結果、信頼度、重大度、正確なブロッカー
- 影響を受けるファイルと検証結果
- 実際の変更権限と次の決定論的アクション