O que clawsweeper faz?
ClawSweeper revisa issues e pull requests nos repositórios OpenClaw. Sua fonte canônica é openclaw/clawsweeper. Resolva o checkout local real em vez de assumir seu caminho.
Início
Inspecione git status --short --branch no checkout do ClawSweeper. Status e
solicitações de relatório permanecem somente leitura: use relatórios atuais e APIs de leitura ao vivo
quando a atualização for importante, sem fazer pull ou build apenas para inspecionar.
Para implementação ou execução autorizada, atualize um checkout limpo de propriedade da tarefa
e faça build apenas quando o comando selecionado precisar. Preserve edições não relacionadas
e fluxos de trabalho ativos de outros operadores.
Leia o AGENTS.md desse checkout antes da execução.
Um Bot, Um App
Use o GitHub App clawsweeper e a configuração atual CLAWSWEEPER_*.
O repositório de origem é dono da configuração e permissões do App. Não altere credenciais,
permissões ou portões de execução para uma solicitação de status.
Revisores propõem descobertas com ambientes de secrets/tokens removidos. Fluxos de trabalho determinísticos são donos de comentários, labels e propostas de fechamento protegidas. Um resultado de revisão não autoriza uma mutação separada.
Revisões de Commits Hospedadas
Relatórios hospedados por commit e Check Runs de commit estão aposentados. Para a revisão offline
retida de um branch commitado, use pnpm local-review -- --base main.
$autoreview --mode commit --commit <sha> permanece um caminho de revisão de propósito geral separado.
Relatórios de Sweep
As chaves canônicas de relatórios de issues/PR são:
records/<repo-slug>/items/<number>.md
records/<repo-slug>/closed/<number>.md
O Worker store é dono dos registros atuais. Verifique a atualização antes de confiar em uma cópia local. Liderar com contagens, descobertas concretas e links de relatórios. Não poste comentários não solicitados no GitHub a partir de trabalho de leitura de relatórios.
Relatórios de PR incluem reviewFindings com prioridade, confiança, arquivo relativo ao repositório
e intervalo de linhas. Comentários públicos mostram descobertas curtas e detalhes de revisão recolhidos.
Leia o resultado durável em vez de inferir cobertura a partir de labels.
Para uma solicitação de status simples, leia relatórios existentes e estado limitado do fluxo de trabalho
ao vivo. Use pnpm run audit apenas para uma auditoria completa solicitada.
Reconciliação é uma mutação autorizada separada: pnpm run reconcile puro
move/exclui relatórios e arquivos de plano de trabalho. Inspecione seu dry-run apenas quando essa
tarefa de manutenção for solicitada. Da mesma forma, apply-decisions pertence a um
fluxo de trabalho de apply explicitamente autorizado, começando com seu dry-run.
Menções de Mantenedores
Prefira os comandos de menção suportados:
@clawsweeper review
@clawsweeper re-review
@clawsweeper explain
@clawsweeper stop
@clawsweeper help
review e re-review solicitam uma revisão fresh somente leitura de issue/PR.
explain resume o status atual. Comandos de revisão podem incluir contexto de foco
somente leitura. Perguntas livres arbitrárias e solicitações de ação não iniciam reparo.
Autores de itens podem usar re-review ou re-run em seus próprios itens abertos.
O roteador verifica a identidade do comentário atual e as permissões do repositório.
Apenas ser membro do repositório não estabelece autoridade de comando.
stop estabelece a espera de revisão humana antes de remover labels antigas de loop de reparo.
Deixe esse comando suportado ser dono da transição. Não remova labels de proteção
manualmente para reproduzi-lo.
Inicie uma tarefa autorizada de roteamento de comentários com seu dry-run:
pnpm run repair:comment-router -- --repo openclaw/openclaw --lookback-minutes 180
O comando padrão é dry-run. O roteamento agendado permanece dry a menos que
CLAWSWEEPER_COMMENT_ROUTER_EXECUTE=1. Use --execute apenas para uma tarefa de roteamento
autorizada. Não alterne ou redefina portões como limpeza genérica.
Comandos Aposentados e Estado Protegido
Reparo, autofix, automerge, implementação de issue, fix-ci, address-review, rebase
e comandos approve estão aposentados. @clawsweeper status também está aposentado.
Use @clawsweeper explain. Os pontos de entrada removidos de criação, validação, despacho
e execução de jobs de reparo estão indisponíveis.
Para reparos e landing de código autorizados, siga o fluxo de trabalho de mantenedor. Não trate um comando ou label aposentado como autoridade de execução ou merge.
Labels existentes clawsweeper:autofix e clawsweeper:automerge ainda protegem
itens de fechamento automático. Preserve essas esperas, proprietários ativos ou desconhecidos,
leases, locks, receipts e evidências de recuperação. A aposentadoria por si só não autoriza
limpeza ou adoção. As ferramentas repair: restantes suportam revisões, publicação
e manutenção. Seu nome não restaura execução de reparo.
Limite de Segurança
Roteie relatórios de vulnerabilidade e divulgações sensíveis através do manuseio de segurança do OpenClaw. Um resultado de revisão ou label de reparo aposentado não dispensa aprovação de segurança, confiança na fonte, revisão necessária ou portões nativos de merge.
Monitoramento
Distinga sucesso de intake de uma revisão ativa usando o guia de admissão de revisão.
Fluxos de trabalho do Receiver:
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
Dispatcher de destino:
gh run list --repo openclaw/openclaw --workflow "ClawSweeper Dispatch" \
--limit 8 --json databaseId,displayTitle,event,status,conclusion,headSha,url
Leitura de Saída
Para descobertas ou falhas, resuma:
- repositório alvo, item/PR, execução, chave de relatório
- resultado, confiança, severidade e bloqueador exato
- arquivos afetados e resultados de validação
- autoridade real de mutação e próxima ação determinística.