ClawSweeper: bot open source de gerenciamento automático de issues com IA

O repositório openclaw/openclaw acumula mais de 13.000 itens pendentes, somando issues abertas e PRs. O ClawSweeper é um bot que usa IA para revisar automaticamente esses itens e classificar quais podem ser fechados e quais devem permanecer abertos, tendo sido projetado sobre o princípio conservador de que, “se não tiver certeza, não feche”.

Principais formas de operação

• Opera com um pipeline de 3 etapas. Na etapa de planejamento (Plan), define prioridades; na etapa de revisão (Review), o OpenAI Codex (gpt-5.4) analisa em modo somente leitura o código, o histórico de commits e os comentários das issues; e na etapa de aplicação (Apply), realiza o fechamento real por meio de um gatilho manual.
• As condições para sugerir fechamento se limitam a 5 casos. Itens já implementados, itens impossíveis de reproduzir, itens que devem ser movidos para um plugin separado, itens com conteúdo pouco claro e itens abandonados por mais de 60 dias com informações insuficientes. Fora isso, tudo permanece aberto.
• Processa em massa com 40 shards paralelos. Há um timeout de 10 minutos por item, e os resultados da revisão são salvos em arquivos Markdown, com os motivos da decisão e as evidências (caminhos de arquivos, commit SHA etc.) registrados em conjunto.

Mecanismos de segurança

• Itens criados por maintainers são excluídos do fechamento automático. O bot não toca em issues e PRs de pessoas com os papéis OWNER, MEMBER ou COLLABORATOR.
• Verifica alterações por meio de hash de snapshot. Se uma issue tiver sido atualizada entre o momento da sugestão e o da aplicação, ela é ignorada automaticamente, evitando que uma decisão desatualizada seja aplicada sem revisão.
• Sugestão e aplicação são separadas, garantindo espaço para intervenção humana.

Resultados reais (em abril de 2025)

• Em 7 dias, foram concluídas revisões de 8.419 issues e 5.026 PRs. Desses, cerca de 33,7% das issues e 11,4% dos PRs foram classificados como candidatos a fechamento, e 3.907 itens foram efetivamente organizados.
• Houve 17 casos de falha e erro, menos de 0,1% do total.
• A cobertura da cadência diária chega a 98,2%, o que significa que quase todos os itens estão sendo incluídos diariamente na revisão.

Características da stack técnica

• Toda a lógica é composta por cerca de 2.500 linhas em um único arquivo TypeScript, o que reduz dependências externas e mantém a estrutura simples. Como compilador, usa o tsgo baseado em Go, e adotou o oxlint e o oxfmt, baseados em Rust, como linter e formatter para acelerar a velocidade de build.
• É executado por um cron horário do GitHub Actions e inclui lógica de throttling que aguarda automaticamente para se adequar aos limites de taxa da API.

A filosofia de design de usar a IA como assistente, mas deixar a decisão final para humanos

O que o ClawSweeper mostra não é um cenário em que a IA substitui maintainers. Entre 13.000 itens, ele seleciona apenas aqueles com base clara, devolvendo os demais julgamentos às pessoas. O fato de a taxa de sugestão de fechamento ficar em cerca de um quarto do total também é um indício de que o bot não está fazendo uma limpeza excessiva. Este projeto mostra bem que, para ferramentas de IA terem um papel realmente útil na manutenção de open source, mais importante do que a sofisticação técnica é definir claramente “até onde automatizar e onde parar”.