ClawSweeper：OpenClawのCodex Botが7000件のGitHub Issueを誤って閉じずにトリアージする方法

オープンソースのAIアシスタントプロジェクトであるOpenClawは、2026年4月までに7,000件以上の未解決の問題とプルリクエストを蓄積しました。その立場にあるほとんどのメンテナーは、バグトラッカーの破綻を宣言するか、トリアージチームを雇うでしょう。OpenClawのメンテナーは、代わりにボットを構築しました。ClawSweeperは現在、すべての未解決のイシューとPRをローリングスケジュールでレビューし、証拠が確実な場合はCodexが作成したクローズ提案を起草し、その提案がまだ有効な場合にのみ実行される個別の実行レーンを通じてそれらのクローズを適用します。

それはまた、自制のケーススタディでもあります。ClawSweeperは勘で自動クローズすることはなく、メンテナーが作成した項目に触れることも決してありません。また、基礎となるレビューがワーキングツリーに不要なものを残した場合、変更を適用することを拒否します。

💡

商用製品と並行してオープンソースSDKを運用しているAPIチームにとって、このボット自体を採用しないとしても、この設計は有用な参考になります。Apidogで公開APIドキュメントを管理し、同じOpenAPI仕様をコミュニティへの貢献のためにGitHubリポジトリにミラーしている場合、同様に陳腐化したイシューが山積しているのを目の当たりにしたことでしょう。

ボタン

このガイドでは、ClawSweeperが何を行うのか、3つのレーンがどのように連携するのか、閉じるべきではないものを閉じないための安全ルール、そして各レビューを動かすCodexの設定について説明します。重い作業を担っているモデルの背景については、GPT-5.5とは何かをご覧ください。

TL;DR

ClawSweeperはopenclaw/openclawのOpenClawのメンテナンスボットで、約7,000件の未解決項目をローリングスケジュールでスキャンします。
3つのレーン：スケジューラはレビューするものを選択し、レビューレーンはクローズ提案を起草し、適用レーンは15分ごとにそれらを実行します。
`gpt-5.5`、高推論、高速サービスティア、1項目あたり10分のタイムアウトを設定したCodexがレビューを作成します。
クローズは以下の6つの限定的なケースでのみ行われます：実装済み、再現不可、重複、対象外、支離滅裂、または60日以上経過した陳腐化したもの。
メンテナーが作成した項目、参照PRが未解決の項目、保護されたラベルは決して自動クローズされません。
このボットは全体で自動的に10,217件の項目をクローズしましたが、直近の1週間ではレビューパスあたりのクローズ率は0.1%でした。これは、項目を未解決のままにしておく傾向が非常に強いことを示しています。
ライセンスはMIT、スタックはNode 24上のTypeScriptとpnpmで、操作はGitHub Appを通じて実行されます。

ClawSweeperが解決するメンテナンスの問題

OpenClawは「あなた自身のパーソナルAIアシスタント。あらゆるOS。あらゆるプラットフォーム。ロブスター流。」と自称しています。このポジショニングは急速に幅広いコミュニティを惹きつけました。2026年4月27日時点の最新のダッシュボードスナップショットでは、3,546件の未解決イシューと3,457件の未解決プルリクエストがあります。これらの項目の多くは、3リリース前に修正された挙動を参照していたり、古いスレッドと重複していたり、あるいは現在ではOpenClawのプラグインおよびスキルエコシステムにより適しており、コアリポジトリには不向きな機能を説明しています。

これだけの量を手動でトリアージするのは現実的ではありません。間違ったものをクローズすることもコストがかかります。なぜなら、無視されたと感じた貢献者は貢献を停止するからです。ClawSweeperは、*何をクローズするかを決定する*ステップと、*クローズを実行する*ステップを分離し、回答が明らかに重複しているか、支離滅裂な項目にほとんどの労力を費やすことで、この困難を乗り越えています。

3つのレーン

ClawSweeperは3つの独立したプロセスに分割されます。それぞれが独自のレポートディレクトリにログを記録し、他のプロセスに影響を与えることなく一時停止できます。

スケジューラ

スケジューラは、どのイシューとPRがレビューされるか、そしてどの頻度でレビューされるかを決定します。READMEには「新規および活発な項目はより多くの注目を集め、古い静かな項目はより遅い頻度に戻る」とあります。実際には、これはホットな項目は毎時間、30日未満の項目は毎日、古いイシューは毎週処理されることを意味します。この頻度は意図的なものです。新しいバグ報告は、さらなる証拠が届く場合に備えて頻繁に再確認したいものであり、古いものは回答が変わる可能性が低いため、めったに再確認しないものです。

レビューレーン

レビューレーンはCodexがその価値を発揮する場所です。ClawSweeperは項目を選択し、タイトル、本文、コメント、およびmain上のリポジトリ状態のスナップショットを含むコンテキストシャードを構築し、そのシャードをCodexに渡します。Codexは、未解決のままにする、Xのためにクローズする、証拠不十分のいずれかの3つの判決を含む構造化されたMarkdownレポートを返します。READMEではその範囲について明確に述べています。「レビューは提案のみです。項目をクローズすることはありません。」

レポートは、適用レーンが消費するまでitems/に保存され、それによってシステムに安全性が確保されます。人間は、提案されたすべてのクローズが実際に適用される前に、リポジトリでそれらを読むことができます。

適用レーン

適用レーンは15分ごとに実行されます。items/を巡回し、未解決の各イシューまたはPRの最新レポートを取得し、提案を再検証します。レポートはイシューの現在の状態（新しいコメントがないか、メンテナーラベルがないか、過去1時間以内に参照PRがオープンされていないか）とまだ一貫しているか、そして行動するのに十分なほど新しいか、をチェックします。もしそうであれば、適用レーンはその項目をクローズし、Codexが作成した説明をコメントとして投稿し、レポートをclosed/に移動します。もし何らかの変更があった場合、レポートは破棄され、スケジューラは次のパスでその項目を再検討します。

この分割は、プロジェクトにおける最も重要な設計上の決定です。CodexはGitHubに直接触れることはなく、適用レーンはクローズの妥当性について推論することはありません。それは新しい条件の下で提案を実行するだけです。

クローズルール

ClawSweeperは、READMEから直接引用した以下の6つの限定的なカテゴリに分類される項目のみ、クローズを提案します。

「現在のmainで実装済み」
「現在のmainでは再現不可」
「規範となるイシュー/PRと重複している、またはそれに取って代わられた」
「具体的だが、このソースリポジトリでは対処できない」（ClawHubのスキルやプラグイン作業により適している）
「意味不明で対処できない」
「検証するためのデータが少なすぎる60日以上前の陳腐化したイシュー」

再現可能なバグ、有効な機能リクエスト、部分的な再現、そして現実的だが優先順位の低い作業を含む、その他のあらゆる状況では、項目は開いたままになります。直近のレビューパスでのクローズ率0.1%（3,478件のレビュー済みイシューに対して4件のクローズ提案）は、プロンプトがいかに積極的に誤検出を回避しているかを示しています。

クローズルールの上に、いくつかの保護層があります。

メンテナーが作成した項目は決してクローズされません。 メンテナーがイシューを提出した場合、ボットは陳腐化しているかどうかに関わらず、それをそのままにします。
未解決の参照PRはクローズをブロックします。 もしイシュー #4321に本文にCloses #4321を含む未解決のPRがある場合、ClawSweeperは待ちます。
保護されたラベルはボットを完全にスキップします。 イシューにkeep-open（またはメンテナーが設定する任意のラベルリスト）のタグを付けると、スケジューラはそれをスキップします。

Codexの設定

Codexの設定は、独自の自動化を構築するどのチームにとっても最も参考になる部分です。

gpt-5.5

ここではいくつかの詳細が重要です。高推論モードは、人間には20秒で明らかに見えるが、検証のために5つのリンクされたスレッドを追う必要がある重複項目を捕捉します。高速サービスティアは、7,000項目のバックログに対してコストを予測可能に保ちます。10分間のタイムアウトは警告ではなく強制終了であり、それ以上時間がかかる項目はキューをブロックするのではなく、次のパスのために破棄されます。

Codex環境はGitHubの書き込みトークンなしでも動作します。READMEには明確に述べられています。「Codexが追跡済みまたは未追跡の変更を残した場合、レビューは失敗します。」これは、レビュー担当者に読み取り専用のアナリストのように振る舞うことを強制します。いかなる副作用もバグであり、機能ではありません。

このモデルをボットに組み込む前にインタラクティブに使用したい場合は、Codex CLIがGPT-5.5への最も簡単な無料パスです。プログラムによるAPIアクセスに関するコストモデルについては、GPT-5.5の料金内訳とGPT-5.5 API利用ガイドをご覧ください。

ローカルセットアップ

ClawSweeperをクローンしてローカルで実行するのは簡単です。リポジトリはcorepack経由でNode 24とpnpmを想定しています。

git clone https://github.com/openclaw/clawsweeper.git
cd clawsweeper
source ~/.profile
corepack enable
pnpm install
pnpm run build

レーンを開始する前に、いくつかのシークレット（秘密情報）が存在する必要があります。

OPENAI_API_KEY：レビューレーン用のCodexを認証します。
CLAWSWEEPER_APP_ID：GitHub App ID（本番環境インストール用は3306130）。
CLAWSWEEPER_APP_PRIVATE_KEY：短期間有効なインストールトークンを発行するために使用される秘密鍵。
OPENCLAW_GH_TOKEN：オプション。Appルートが失敗した場合、パーソナルアクセストークンにフォールバックします。

レビューレーンは、あなたが所有する任意のリポジトリに対して実行できます。適用レーンは、GitHub Appの権限を再設定しない限り、意図的にopenclaw/openclawへの書き込み操作に制限されています。

有料のAPIキーを希望しつつ、同じCodexの挙動を求めるチーム向けには、無料のGPT-5.5パスで、試用クレジットやアグリゲーターゲートウェイを経由する代替手段が概説されています。

ダッシュボードスナップショット

READMEには、適用パスごとに更新される公開ダッシュボードが付属しています。最新のスナップショットは次のとおりです。

合計7,003件の未解決項目（イシュー3,546件 + PR 3,457件）
過去7日間にレビューされたイシュー3,478件
提案されたイシューのクローズ4件（レビュー済みの0.1%）
リリース以来、自動化によってクローズされた項目総数10,217件

この0.1%という数字がすべてを物語っています。ClawSweeperはイシューの受信トレイゼロを目指しているのではなく、「貢献者がもし尋ねられたら擁護するであろうものを決してクローズしない」ことを最適化しています。10,000件以上のクローズを通して、その保守的な姿勢がプロジェクトの信頼性を保ち、貢献者が新しいイシューを開き続けることを可能にしました。

APIチームにとってこれが重要である理由

GitHub上のほとんどのAPI製品はOpenClawと同じ軌跡をたどります。SDKや仕様は公開リポジトリに置かれ、イシュートラッカーはバグ報告と機能リクエストが混在して埋まり、トリアージが滞ります。ApidogからOpenAPI仕様を公開し、GitHubでコミュニティからの貢献を受け入れている場合、ClawSweeperのアーキテクチャは移植可能です。価値のある部分はプロンプトではありません。それらはOpenClawのドメインに縛られているからです。価値のある部分は、レーンの分離、厳格なクローズルール、そしてCodexを書き込みアクセスなしで実行するというポリシーです。

同じアプローチを3つのステップで段階的に実行できます。

トラッカーのサンプルに対してCodex駆動のレビュージョブを実行します。何もコミットせずにMarkdownレポートを生成させます。
安全ルールを重ねます：メンテナーの項目は決してクローズせず、保護されたラベルを尊重し、未解決のPRを優先します。
レビューレポートが手作業で確認して正しく見える場合にのみ、適用レーンを追加します。信頼が築かれるまで、1日あたり最大数件をクローズするように設定します。

これらのイシューが記述するAPIサーフェスを検証している場合、Apidogが契約側面を処理します。同じOpenAPIドキュメントが、モックサーバー、自動テスト、および貢献者がバグを報告する前に読むドキュメントを駆動します。トリアージボットと厳密にバージョン管理された仕様を組み合わせることで、ボットが実行される前から重複イシューの発生率が通常半分になります。Apidogをダウンロードして、仕様の規律から始めたい場合はご利用ください。

制限と設計上のトレードオフ

ClawSweeperが意図的に行わないことがいくつかあります。

コードは書きません。 PRも、パッチも、修正を提案するレビューコメントもありません。その作業は他のOpenClawボットに属します。
優先順位について推論しません。 クローズはバイナリです。ボットによって「優先順位が下げられる」またはラベル付けされることはありません。
過去のクローズから学習しません。 各レビューはmainに対して新たに開始されます。以前の決定はclosed/の下の履歴レポートとしてのみ表示され、ファインチューニングデータとしては表示されません。

これらのトレードオフが、ボットの予測可能性を保つ理由です。また、ラベラーボット、陳腐化したPRへのピング、リリースノートドラフターなど、ClawSweeperの狭い任務範囲を侵害することなく、隣接する自動化の余地を残しています。

よくある質問

ClawSweeperはどのくらいの頻度でイシューを自動クローズしますか？適用レーンは15分ごとに実行されますが、ほとんどのサイクルではクローズは発生しません。2026年4月27日時点でのレビューごとのクローズ率は0.1%であり、これは1週間でレビューされた3,478件のイシューに対して約4件のクローズを意味します。レビューの背後にあるモデルの背景については、GPT-5.5とは何かをご覧ください。

自分のリポジトリでClawSweeperを実行できますか？はい。リポジトリをクローンし、対象となるリポジトリに読み書きアクセス権を持つ独自のGitHub Appを設定し、CLAWSWEEPER_APP_IDとCLAWSWEEPER_APP_PRIVATE_KEYをそれに向けます。他の人のリポジトリのレビューは、デフォルトで読み取り専用です。

ClawSweeperは有料のOpenAIプランを必要としますか？レビューレーンはOPENAI_API_KEYを介して認証されますが、これは有料のAPI資格情報です。大規模ではなくインタラクティブにレビューを実行したいだけであれば、無料のChatGPTプランでのCodex CLIで動作します。

Codexが実際のバグをクローズするのを防ぐものは何ですか？3つの要素があります。限定されたクローズルールリスト、メンテナーと保護されたラベルの除外、そしてレビュー以降に根本的なイシューが変更された場合に提案を破棄する適用レーンの再検証ステップです。

ClawSweeperはオープンソースですか？はい、MITライセンスで、ソースコードはGitHubのopenclaw/clawsweeperにあります。親プロジェクトのOpenClawは、独自の貢献ガイドを持つ別のリポジトリです。