Blog

ClawSweeper: Comment le bot Codex d'OpenClaw trie 7000 problèmes GitHub sans erreurs

Ashley Innocent

Ashley Innocent

28 April 2026

ClawSweeper: Comment le bot Codex d'OpenClaw trie 7000 problèmes GitHub sans erreurs

OpenClaw, le projet d'assistant IA open source, avait accumulé plus de 7 000 problèmes ouverts et demandes de tirage (pull requests) en avril 2026. La plupart des mainteneurs dans cette situation déclareraient soit une faillite de leur suivi de bogues, soit engageraient une équipe de tri. Les mainteneurs d'OpenClaw ont plutôt construit un bot. ClawSweeper examine désormais chaque problème ouvert et PR selon un calendrier roulant, rédige une proposition de clôture rédigée par Codex lorsque les preuves sont solides, et applique ces clôtures via une voie d'exécution séparée qui ne s'exécute que lorsque la proposition est toujours valide.

C'est aussi une étude de cas en matière de retenue. ClawSweeper ne se ferme pas automatiquement sur une intuition, ne touche jamais aux éléments créés par les mainteneurs et refuse d'appliquer tout changement si l'examen sous-jacent a laissé des éléments indésirables dans l'arborescence de travail.

💡
Pour les équipes API gérant des SDK open source en parallèle de leurs produits commerciaux, la conception est une référence utile même si vous n'adoptez jamais le bot lui-même. Si vous maintenez une documentation API publique dans Apidog et que vous reproduisez la même spécification OpenAPI dans un dépôt GitHub pour les contributions de la communauté, vous avez probablement vu les problèmes obsolètes s'accumuler de la même manière.

button

Ce guide explique ce que fait ClawSweeper, comment les trois voies fonctionnent ensemble, les règles de sécurité qui l'empêchent de fermer des choses qu'il ne devrait pas, et la configuration Codex qui alimente chaque examen. Pour des informations sur le modèle qui effectue le gros du travail, consultez qu'est-ce que GPT-5.5.

TL;DR

Le problème de maintenance que ClawSweeper résout

OpenClaw se présente comme "votre propre assistant IA personnel. N'importe quel OS. N'importe quelle plateforme. À la manière du homard." Ce positionnement a rapidement attiré une large communauté : 3 546 problèmes ouverts et 3 457 demandes de tirage ouvertes au dernier instantané du tableau de bord le 27 avril 2026. Beaucoup de ces éléments font référence à un comportement corrigé il y a trois versions, dupliquent des discussions plus anciennes ou décrivent des fonctionnalités désormais mieux adaptées à l'écosystème de plugins et de compétences d'OpenClaw qu'au dépôt principal.

Le tri manuel à ce volume n'est pas réaliste. Fermer le mauvais élément est également coûteux, car les contributeurs qui se sentent ignorés cessent de contribuer. ClawSweeper résout ce dilemme en séparant l'étape de décision de ce qu'il faut fermer de l'étape d'exécution de la fermeture, et en consacrant la majeure partie de son énergie aux éléments dont la réponse est clairement un duplicata ou est incohérente.

Les trois voies

ClawSweeper se divise en trois processus indépendants. Chacun se connecte à son propre répertoire de rapports et peut être mis en pause sans affecter les autres.

Ordonnanceur

L'ordonnanceur décide quels problèmes et PR sont examinés et à quelle fréquence. Extrait du README : "Les éléments nouveaux et actifs reçoivent plus d'attention ; les éléments plus anciens et silencieux reviennent à une cadence plus lente." En pratique, cela signifie des éléments "chauds" toutes les heures, des éléments de moins de 30 jours quotidiennement, et des problèmes plus anciens hebdomadairement. La cadence est intentionnelle. Vous voulez revoir fréquemment un nouveau rapport de bogue, au cas où de nouvelles preuves arriveraient, et rarement un ancien, car la réponse est peu susceptible de changer.

Voie d'examen

La voie d'examen est l'endroit où Codex gagne sa vie. ClawSweeper sélectionne un élément, construit un fragment de contexte avec le titre, le corps, les commentaires et un instantané de l'état du dépôt sur main, puis transmet le fragment à Codex. Codex renvoie un rapport structuré en markdown avec l'un des trois verdicts : garder ouvert, fermer parce que X, ou preuves insuffisantes. Le README est direct quant à la portée : "L'examen est uniquement une proposition. Il ne ferme jamais d'éléments."

Les rapports résident dans items/ jusqu'à ce que la voie d'application les consomme, et c'est ce qui confère au système sa propriété de sécurité. Un humain peut lire chaque fermeture proposée dans le dépôt avant qu'elle ne soit appliquée.

Voie d'application

L'application s'exécute toutes les 15 minutes. Elle parcourt items/, récupère le rapport le plus récent pour chaque problème ou PR ouvert, et re-valide la proposition : le rapport est-il toujours cohérent avec l'état en direct du problème (pas de nouveaux commentaires, pas d'étiquette de mainteneur, pas de PR de référence ouverte dans la dernière heure), et est-il suffisamment récent pour agir ? Si oui, la voie d'application ferme l'élément, publie l'explication rédigée par Codex en tant que commentaire, et déplace le rapport vers closed/. Si quelque chose a changé, le rapport est rejeté et l'ordonnanceur reconsidère l'élément lors du passage suivant.

Cette division est le choix de conception le plus important du projet. Codex ne touche jamais directement GitHub, et la voie d'application ne raisonne jamais sur la pertinence de la fermeture ; elle applique la proposition dans de nouvelles conditions.

Les règles de clôture

ClawSweeper ne propose des clôtures que pour les éléments qui entrent dans l'une des six catégories étroites, tirées directement du README :

Toutes les autres situations, y compris les bogues reproductibles, les demandes de fonctionnalités valides, les reproductions partielles et les travaux réels mais non prioritaires, maintiennent l'élément ouvert. Le taux de clôture de 0,1 % lors de la passe d'examen la plus récente (4 clôtures proposées sur 3 478 problèmes examinés) indique à quel point l'invite évite agressivement les faux positifs.

Quelques protections se superposent aux règles de clôture :

Configuration de Codex

La configuration de Codex est la partie la plus intéressante à emprunter pour toute équipe construisant sa propre automatisation :

gpt-5.5

Quelques détails importent ici. Le mode de raisonnement élevé détecte les doublons qui semblent évidents pour un humain après vingt secondes mais nécessitent de suivre cinq fils liés pour vérifier. Le niveau de service rapide maintient le coût prévisible sur un arriéré de 7 000 éléments. Le délai d'attente de 10 minutes est un arrêt brutal, pas un avertissement ; un élément qui prend plus de temps est abandonné pour le passage suivant plutôt que de bloquer la file d'attente.

L'environnement Codex s'exécute également sans jetons d'écriture GitHub. Le README l'indique clairement : "Les revues échouent si Codex laisse des modifications suivies ou non suivies." Cela force l'examinateur à se comporter comme un analyste en lecture seule ; tout effet secondaire est un bogue, pas une fonctionnalité.

Si vous souhaitez utiliser le même modèle de manière interactive avant de le connecter à un bot, l'interface de ligne de commande Codex est le moyen gratuit le plus simple d'accéder à GPT-5.5. Pour un modèle de coût sur l'accès programmatique à l'API, consultez la répartition des prix de GPT-5.5 et le guide d'utilisation de l'API GPT-5.5.

Configuration locale

Cloner ClawSweeper et l'exécuter localement est simple. Le dépôt s'attend à Node 24 et pnpm via corepack :

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

Quelques secrets doivent être présents avant que les voies ne démarrent :

Vous pouvez exécuter la voie d'examen sur n'importe quel dépôt dont vous êtes propriétaire. La voie d'application se limite intentionnellement aux opérations d'écriture de openclaw/openclaw à moins que vous ne reconfiguriez les permissions de l'application GitHub.

Pour les équipes qui préfèrent une clé API payante mais qui souhaitent le même comportement Codex, les voies gratuites de GPT-5.5 décrivent des alternatives qui passent par des crédits d'essai ou des passerelles d'agrégation.

Instantané du tableau de bord

Le README fournit un tableau de bord public qui se met à jour à chaque passage d'application. Au dernier instantané :

Le nombre de 0,1 % est révélateur. ClawSweeper n'optimise pas pour une boîte de réception de problèmes à zéro ; il optimise pour "ne jamais fermer quelque chose qu'un contributeur défendrait si on le lui demandait". Sur plus de 10 000 fermetures, cette posture conservatrice est ce qui a maintenu le projet suffisamment crédible pour que les contributeurs continuent d'ouvrir de nouveaux problèmes.

Pourquoi cela est important pour les équipes API

La plupart des produits API sur GitHub suivent le même parcours qu'OpenClaw. Le SDK ou la spécification réside dans un dépôt public, le suivi des problèmes se remplit de rapports de bogues et de demandes de fonctionnalités variés, et le tri prend du retard. Si vous publiez une spécification OpenAPI depuis Apidog et que vous acceptez les contributions de la communauté sur GitHub, l'architecture de ClawSweeper est portable. Les parties précieuses ne sont pas les invites, car elles sont liées au domaine d'OpenClaw. Les parties précieuses sont la séparation des voies, les règles de fermeture strictes et la politique d'exécution de Codex sans accès en écriture.

Vous pouvez mettre en œuvre la même approche en trois étapes :

  1. Exécutez un travail d'examen piloté par Codex sur un échantillon de votre suivi. Faites-le produire des rapports en markdown sans rien valider.
  2. Mettez en place les règles de sécurité : ne jamais fermer les éléments du mainteneur, respecter les étiquettes protégées, différer aux PR ouvertes.
  3. Ajoutez une voie d'application seulement lorsque les rapports d'examen semblent corrects à la lecture manuelle. Connectez-le pour fermer au maximum une poignée par jour jusqu'à ce que la confiance s'établisse.

Si vous validez la surface API que ces problèmes décrivent, Apidog gère le côté contrat. Le même document OpenAPI pilote des serveurs maquettes, des tests automatisés et la documentation que vos contributeurs lisent avant de déposer un bogue. L'association d'un bot de tri avec une spécification étroitement versionnée réduit généralement de moitié le taux de problèmes en double avant même que le bot ne s'exécute. Téléchargez Apidog si vous voulez commencer par la discipline de la spécification.

Limites et compromis de conception

Voici quelques éléments que ClawSweeper ne fait délibérément pas :

Ces compromis expliquent pourquoi le bot reste prévisible. Ils laissent également de la place pour une automatisation adjacente, comme un bot d'étiquetage, un pinger de PR obsolètes ou un rédacteur de notes de version, sans empiéter sur le mandat étroit de ClawSweeper.

FAQ

À quelle fréquence ClawSweeper ferme-t-il automatiquement les problèmes ?La voie d'application s'exécute toutes les 15 minutes, mais la plupart des cycles ne produisent aucune fermeture. Le taux de clôture de 0,1 % par examen le 27 avril 2026 signifie environ 4 fermetures sur 3 478 problèmes examinés sur une semaine. Pour plus d'informations sur le modèle derrière les examens, consultez qu'est-ce que GPT-5.5.

Puis-je exécuter ClawSweeper sur mon propre dépôt ?Oui. Clonez le dépôt, configurez votre propre application GitHub avec un accès en lecture/écriture sur la cible, et pointez CLAWSWEEPER_APP_ID et CLAWSWEEPER_APP_PRIVATE_KEY vers celle-ci. L'examen des dépôts d'autres personnes est en lecture seule par défaut.

ClawSweeper nécessite-t-il un plan OpenAI payant ?La voie d'examen s'authentifie via OPENAI_API_KEY, qui est une clé API payante. Si vous ne voulez exécuter les examens que de manière interactive plutôt qu'à grande échelle, l'interface de ligne de commande Codex sur un plan ChatGPT gratuit fonctionne.

Qu'est-ce qui empêche Codex de fermer de vrais bogues ?Trois choses. La liste restreinte des règles de clôture, les exclusions des mainteneurs et des étiquettes protégées, et l'étape de re-validation de la voie d'application qui rejette toute proposition si le problème sous-jacent a changé depuis l'examen.

ClawSweeper est-il open source ?Oui, sous licence MIT, avec le code source sur GitHub à openclaw/clawsweeper. Le projet parent OpenClaw est un dépôt séparé avec son propre guide de contribution.

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API

S'inscrire gratuitementTélécharger