오픈소스 AI 비서 프로젝트인 OpenClaw는 2026년 4월까지 7,000개 이상의 미해결 문제(issue)와 풀 리퀘스트(pull request)를 누적했습니다. 이 위치에 있는 대부분의 관리자들은 버그 추적기 파산을 선언하거나 분류 팀을 고용했을 것입니다. 하지만 OpenClaw 관리자들은 대신 봇을 만들었습니다. ClawSweeper는 이제 모든 미해결 문제와 PR을 순차적으로 검토하고, 증거가 확실할 때 Codex가 작성한 종결 제안을 초안하며, 이 제안이 여전히 유효할 때만 실행되는 별도의 실행 경로를 통해 해당 종결을 적용합니다.
이는 또한 절제의 사례 연구이기도 합니다. ClawSweeper는 섣부른 판단으로 자동 종료하지 않으며, 관리자가 작성한 항목은 절대 건드리지 않고, 기본 검토가 작업 트리에 불필요한 것을 남겼을 경우 어떠한 변경 사항도 적용하기를 거부합니다.
이 가이드는 ClawSweeper가 무엇을 하는지, 세 가지 경로가 어떻게 함께 작동하는지, 잘못된 것을 닫는 것을 방지하는 안전 규칙, 그리고 각 검토를 구동하는 Codex 구성에 대해 설명합니다. 무거운 작업을 수행하는 모델에 대한 배경 지식은 GPT-5.5란 무엇인가를 참조하십시오.
요약
- ClawSweeper는 OpenClaw의
openclaw/openclaw를 위한 유지보수 봇으로, 약 7,000개의 미해결 항목을 순차적으로 스캔합니다. - 세 가지 경로: 스케줄러는 검토할 항목을 선택하고, 검토 경로는 종결 제안을 초안하며, 적용 경로는 15분마다 이를 실행합니다.
gpt-5.5를 사용하는 Codex, 높은 추론 능력, 빠른 서비스 계층, 항목당 10분 타임아웃으로 검토를 작성합니다.- 종결은 구현됨, 재현 불가, 중복, 범위 외, 모호함, 또는 60일 이상된 오래된 항목의 여섯 가지 좁은 경우에만 발생합니다.
- 관리자가 작성한 항목, 참조하는 PR이 열려있는 항목, 보호된 레이블이 있는 항목은 절대 자동 종료되지 않습니다.
- 봇은 자동화를 통해 총 10,217개의 항목을 종료했지만, 가장 최근 주에는 검토 통과당 0.1%의 종료율을 보였습니다. 즉, 항목을 열어두는 경향이 매우 강합니다.
- 라이선스는 MIT이며, 스택은 Node 24에서 pnpm을 사용하는 TypeScript이고, 작업은 GitHub 앱을 통해 실행됩니다.
ClawSweeper가 해결하는 유지보수 문제
OpenClaw는 "당신만의 개인 AI 비서. 어떤 OS든. 어떤 플랫폼이든. 바닷가재 방식."이라고 자신을 소개합니다. 이러한 포지셔닝은 빠르게 광범위한 커뮤니티를 끌어모았습니다: 2026년 4월 27일 최신 대시보드 스냅샷 기준으로 3,546개의 미해결 문제와 3,457개의 미해결 풀 리퀘스트. 이 항목들 중 상당수는 세 릴리스 전에 수정된 동작을 참조하거나, 오래된 스레드를 중복하거나, 이제 코어 리포지토리보다는 OpenClaw의 플러그인 및 스킬 생태계에 더 적합한 기능을 설명합니다.
이러한 양에서 수동 분류는 비현실적입니다. 잘못된 것을 닫는 것 또한 비용이 많이 드는데, 기여자들은 무시당한다고 느끼면 기여를 멈추기 때문입니다. ClawSweeper는 *무엇을 닫을지 결정하는* 단계를 *종결을 실행하는* 단계와 분리하고, 명백히 중복되거나 모호한 항목에 대부분의 에너지를 사용하여 이 난관을 해결합니다.
세 가지 경로
ClawSweeper는 세 가지 독립적인 프로세스로 나뉩니다. 각 프로세스는 자체 보고서 디렉토리에 로그를 기록하며, 다른 프로세스에 영향을 주지 않고 일시 중지할 수 있습니다.
스케줄러
스케줄러는 어떤 문제와 PR을 어떤 주기로 검토할지 결정합니다. README에 따르면: "새롭고 활발한 항목은 더 많은 관심을 받으며, 오래되고 조용한 항목은 더 느린 주기로 돌아갑니다." 실제로 이는 뜨거운 항목은 매시간, 30일 미만 항목은 매일, 오래된 문제는 매주 검토됨을 의미합니다. 주기는 의도적입니다. 추가 증거가 도착할 경우 신선한 버그 보고서는 자주 재검토하고, 오래된 보고서는 답변이 바뀔 가능성이 낮으므로 드물게 재검토해야 합니다.
검토 경로
검토 경로는 Codex가 제 역할을 하는 곳입니다. ClawSweeper는 항목을 선택하고, 제목, 본문, 댓글, 그리고 main의 리포지토리 상태 스냅샷을 포함하는 컨텍스트 샤드를 구축한 다음, 이 샤드를 Codex에 넘깁니다. Codex는 세 가지 판결 중 하나(유지, X 때문에 종료, 증거 불충분)를 담은 구조화된 마크다운 보고서를 반환합니다. README는 범위에 대해 명확히 밝힙니다: "검토는 제안 전용입니다. 항목을 절대 종료하지 않습니다."
보고서는 적용 경로가 소비할 때까지 items/에 남아 있으며, 이는 시스템에 안전 속성을 부여합니다. 사람이 리포지토리에 제출되기 전에 제안된 모든 종료를 읽을 수 있습니다.
적용 경로
적용은 15분마다 실행됩니다. items/를 순회하며, 각 미해결 문제 또는 PR에 대한 가장 최근 보고서를 가져와 제안을 재검증합니다. 즉, 보고서가 문제의 현재 상태와 여전히 일치하는지(새로운 댓글 없음, 관리자 레이블 없음, 지난 한 시간 이내에 열린 참조 PR 없음), 그리고 조치하기에 충분히 신선한지 확인합니다. 그렇다면 적용 경로는 항목을 종료하고, Codex가 작성한 설명을 댓글로 게시한 다음, 보고서를 closed/로 이동합니다. 뭔가 변경되었다면, 보고서는 폐기되고 스케줄러는 다음 통과에서 항목을 재고합니다.
이러한 분리는 프로젝트에서 가장 중요한 단일 설계 선택입니다. Codex는 GitHub에 직접 접근하지 않으며, 적용 경로는 종료 가치에 대해 추론하지 않습니다. 대신 새로운 조건 하에서 제안을 강제합니다.
종결 규칙
ClawSweeper는 README에서 직접 가져온 여섯 가지 좁은 범주 중 하나에 해당하는 항목에 대해서만 종결을 제안합니다.
- “현재
main에 구현됨” - “현재
main에서 재현 불가” - “표준 문제/PR과 중복되거나 대체됨”
- “구체적이지만 이 소스 리포지토리에서 조치 불가능함” (ClawHub 스킬 또는 플러그인 작업에 더 적합함)
- “조치를 취할 수 없을 정도로 모호함”
- “60일 이상된 오래된 문제로, 검증할 데이터가 너무 적음”
재현 가능한 버그, 유효한 기능 요청, 부분 재현, 실제이지만 우선순위가 낮은 작업을 포함한 다른 모든 상황은 항목을 열어둡니다. 가장 최근 검토 통과에서 0.1%의 종료율(검토된 3,478개 문제 중 4개 제안된 종료)은 프롬프트가 오탐지를 얼마나 적극적으로 회피하는지 보여줍니다.
종결 규칙 위에 몇 가지 보호 계층이 있습니다.
- 관리자가 작성한 항목은 절대 종료되지 않습니다. 관리자가 문제를 제기하면, 봇은 오래되었는지 여부와 상관없이 그대로 둡니다.
- 참조하는 PR이 열려 있으면 종결을 차단합니다. 문제 #4321에 본문에
Closes #4321이 포함된 열린 PR이 있으면 ClawSweeper는 기다립니다. - 보호된 레이블은 봇을 완전히 건너뜁니다. 문제에
keep-open(또는 관리자가 구성한 레이블 목록)을 태그하면 스케줄러가 이를 건너뜁니다.
Codex 구성
Codex 설정은 자체 자동화를 구축하는 모든 팀이 가장 참고할 가치가 있는 부분입니다.
gpt-5.5여기서 몇 가지 세부 사항이 중요합니다. 높은 추론 모드는 사람이 20초 만에 명확하다고 생각하지만 다섯 개의 연결된 스레드를 추적해야 확인할 수 있는 중복 항목을 잡아냅니다. 빠른 서비스 계층은 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 앱 ID (프로덕션 설치의 경우 3306130).CLAWSWEEPER_APP_PRIVATE_KEY: 단기 설치 토큰을 발행하는 데 사용되는 개인 키.OPENCLAW_GH_TOKEN: 선택 사항이며, 앱 경로가 실패할 경우 개인 액세스 토큰으로 폴백됩니다.
소유한 모든 리포지토리에 대해 검토 경로를 실행할 수 있습니다. 적용 경로는 GitHub 앱 권한을 재구성하지 않는 한 openclaw/openclaw 쓰기 작업으로 의도적으로 제한됩니다.
유료 API 키를 선호하지만 동일한 Codex 동작을 원하는 팀을 위해 무료 GPT-5.5 경로는 시험판 크레딧 또는 애그리게이터 게이트웨이를 통한 대안을 설명합니다.
대시보드 스냅샷
README는 적용 통과마다 업데이트되는 공개 대시보드를 제공합니다. 가장 최근 스냅샷 기준:
- 총 7,003개의 미해결 항목 (3,546개의 문제 + 3,457개의 PR)
- 지난 7일 동안 검토된 3,478개의 문제
- 4개의 제안된 문제 종결 (검토된 항목의 0.1%)
- 출시 이후 자동화로 총 10,217개의 항목 종료
0.1%라는 숫자가 중요합니다. ClawSweeper는 문제 받은 편지함 제로를 최적화하는 것이 아니라, "기여자가 요청하면 방어할 만한 것을 절대 닫지 않는" 것을 최적화합니다. 10,000개 이상의 종결 중에서 이러한 보수적인 자세가 프로젝트가 기여자들이 계속 새로운 문제를 제기할 만큼 충분히 신뢰할 수 있도록 유지했습니다.
API 팀에 이것이 중요한 이유
대부분의 GitHub API 제품은 OpenClaw와 동일한 흐름을 따릅니다. SDK 또는 사양은 공개 리포지토리에 있고, 문제 추적기는 혼합된 버그 보고서와 기능 요청으로 가득 차며, 분류가 늦어집니다. Apidog에서 OpenAPI 사양을 게시하고 GitHub에서 커뮤니티 기여를 받는 경우, ClawSweeper 아키텍처는 이식 가능합니다. 가치 있는 부분은 프롬프트가 아닙니다. 왜냐하면 프롬프트는 OpenClaw의 도메인에 묶여 있기 때문입니다. 가치 있는 부분은 경로 분리, 엄격한 종결 규칙, 그리고 쓰기 접근 권한 없이 Codex를 실행하는 정책입니다.
세 단계로 동일한 접근 방식을 구성할 수 있습니다.
- 추적기의 샘플에 대해 Codex 기반 검토 작업을 실행합니다. 아무것도 커밋하지 않고 마크다운 보고서를 생성하게 합니다.
- 안전 규칙을 추가합니다: 관리자 항목은 절대 닫지 않고, 보호된 레이블을 존중하며, 열린 PR에 따릅니다.
- 수동으로 읽었을 때 검토 보고서가 올바르게 보일 때만 적용 경로를 추가합니다. 신뢰가 구축될 때까지 하루에 소수만 종료하도록 연결합니다.
이러한 문제가 설명하는 API 표면을 검증하는 경우, Apidog가 계약 측면을 처리합니다. 동일한 OpenAPI 문서는 목 서버, 자동화된 테스트, 그리고 기여자들이 버그를 제출하기 전에 읽는 문서를 구동합니다. 분류 봇과 엄격하게 버전 관리된 사양을 결합하면 봇이 실행되기도 전에 중복 문제율을 절반으로 줄일 수 있습니다. 사양 규율부터 시작하고 싶다면 Apidog를 다운로드하십시오.
한계 및 설계 절충
ClawSweeper가 의도적으로 하지 않는 몇 가지 사항:
- 코드를 작성하지 않습니다. PR, 패치, 수정 제안 검토 댓글이 없습니다. 이 작업은 다른 OpenClaw 봇의 소관입니다.
- 우선순위에 대해 추론하지 않습니다. 종료는 이진적입니다. 봇에 의해 "우선순위가 낮아지거나" 라벨이 지정되는 것은 없습니다.
- 과거 종료로부터 학습하지 않습니다. 각 검토는
main에 대해 새로 시작됩니다. 이전 결정은closed/아래의 기록 보고서로만 나타나며, 미세 조정 데이터로는 사용되지 않습니다.
이러한 절충은 봇이 예측 가능하게 유지되는 이유입니다. 또한 라벨러 봇, 오래된 PR 알리미, 또는 릴리스 노트 초안 작성기와 같은 인접 자동화를 위한 여지를 남기면서 ClawSweeper의 좁은 업무 범위를 침범하지 않습니다.
자주 묻는 질문
ClawSweeper는 얼마나 자주 문제를 자동으로 종료합니까?적용 경로는 15분마다 실행되지만, 대부분의 주기에서는 종료가 발생하지 않습니다. 2026년 4월 27일 기준 검토당 0.1%의 종료율은 일주일 동안 검토된 3,478개의 문제 중 약 4개의 종료를 의미합니다. 검토 배후 모델에 대한 배경 지식은 GPT-5.5란 무엇인가를 참조하십시오.
내 리포지토리에서 ClawSweeper를 실행할 수 있습니까?예. 리포지토리를 복제하고, 대상에 대한 읽기/쓰기 권한으로 자체 GitHub 앱을 구성한 다음, CLAWSWEEPER_APP_ID와 CLAWSWEEPER_APP_PRIVATE_KEY를 해당 앱에 연결하십시오. 다른 사람의 리포지토리 검토는 기본적으로 읽기 전용입니다.
ClawSweeper는 유료 OpenAI 플랜이 필요합니까?검토 경로는 유료 API 자격 증명인 OPENAI_API_KEY를 통해 인증합니다. 대규모가 아닌 대화식으로만 검토를 실행하려면 무료 ChatGPT 플랜의 Codex CLI가 작동합니다.
무엇이 Codex가 실제 버그를 종료하는 것을 막습니까?세 가지가 있습니다. 좁은 종료 규칙 목록, 관리자 및 보호된 레이블 제외, 그리고 기본 문제가 검토 이후 변경된 경우 모든 제안을 폐기하는 적용 경로의 재검증 단계입니다.
ClawSweeper는 오픈소스입니까?예, MIT 라이선스를 따르며, GitHub의 openclaw/clawsweeper에서 소스를 확인할 수 있습니다. 상위 프로젝트인 OpenClaw는 자체 기여 가이드를 가진 별도의 리포지토리입니다.