[완벽 가이드] ClawSweeper: AI 기반 오픈소스 이슈 자동 관리 봇 완벽 가이드

오픈소스 프로젝트의 가장 큰 고통 중 하나는 방치된 이슈와 PR의 누적입니다. 인기 프로젝트일수록 이슈 수는 폭발적으로 증가하며, 유지보수자들은 유휴 이슈를 처리하느라 실제 개발보다 더 많은 시간을 소요하게 됩니다. 특히 9,000개 이상의 오픈 이슈를 보유한 대규모 프로젝트에서는 수동 검토가 사실상 불가능에 가깝습니다.

ClawSweeper는 이러한 문제를 근본적으로 해결하는 AI 기반 이슈 자동 관리 봇입니다. 50개의 병렬 Codex 에이전트를 활용하여 하루에 4,000개 이상의 이슈와 PR을 자동 검토하고, 명확한 근거가 있는 항목만 정리 제안합니다. 2026년 현재 가장 실용적인 오픈소스 유지보수 자동화 도구로 자리잡았습니다.

ClawSweeper — AI 기반 이슈 자동 관리

ClawSweeper란 무엇인가

ClawSweeper는 OpenClaw 프로젝트의 공식 유지보수 봇으로, GitHub 이슈와 PR을 AI가 자동으로 검토하여 정리 제안하는 도구입니다. Peter Steinberger(@steipete)가 개발했으며, 현재 openclaw/openclaw 저장소에서 813개의 스타와 1,409개의 커밋을 기록하고 있습니다.

핵심 철학은 "보수적(conservative)"입니다. ClawSweeper는 이슈를 함부로 닫지 않습니다. 명확한 증거가 있을 때만 종료 제안을 하며, 유지보수자가 작성한 이슈는 절대 자동으로 닫지 않습니다. 이로 인해 커뮤니티의 불신을 일으키는 위험을 최소화합니다.

주요 특징

특징	설명
병렬 처리	50개의 Codex 에이전트가 동시에 검토
주기적 실행	매 시간, 매일, 매주 자동 실행
안전장치	명확한 근거 없이는 이슈를 닫지 않음
투명성	모든 검토 결과를 대시보드에 공개
제안 전용	Review Lane에서는 종료 제안만, Apply Lane에서만 실제 종료

아키텍처와 동작 원리

ClawSweeper는 두 개의 독립 레인으로 구성되어 있습니다.

Review Lane (검토 레인)

Review Lane은 제안 전용입니다. 실제 이슈를 닫지 않으며, 검토 결과를 코멘트로 남기고 종료 제안을 등록합니다.

동작 흐름:

1. Planner가 모든 오픈 이슈와 PR을 스캔
2. Shard가 각 이슈/PR을 50개의 병렬 Codex 에이전트에 할당
3. 각 에이전트는 개별 이슈를 깊이 검토하여 마크다운 보고서 작성
4. 최종적으로 Codex automated review 코멘트를 이슈에 게시

검토 기준은 매우 엄격합니다. 다음 중 하나에 해당해야만 종료 제안을 합니다:

• implemented on current main — 이미 메인 브랜치에 구현됨
• not reproducible on current main — 현재 버전에서 재현 불가
• belongs on ClawHub as a skill/plugin — 코어而非 클라우드 hub이 적합
• duplicate or superseded — 중복 또는 상위 이슈로 대체됨
• not actionable — 해당 저장소에서 조치 불가
• stale > 60 days with too little data — 60일 이상 방치되고 데이터 부족

Apply Lane (적용 레인)

Apply Lane은 실제 종료 동작을 수행합니다. Review Lane의 제안을 검토하고, 충분한 근거가 있을 때만 해당 이슈를 실제로 닫습니다.

성능과 규모

ClawSweeper의 처리 능력는 놀라움입니다.

최신 대시보드 수치 (2026-04-26 기준)

지표	수치
현재 오픈 이슈	3,785개
현재 오픈 PR	3,534개
총 오픈 항목	7,319개
검토 완료 항목	7,244개
미검토 항목	75개 (99% 이상 검토율)

최근 7일 성과

• 검토된 이슈: 3,769개
• 제안된 종료: 13개 (0.3%)
• 검토된 PR: 3,472개
• 제안된 종료: 9개 (0.3%)
• Codex 적용으로 종료: 9,744개

可以看到 ClawSweeper가 얼마나 보수적으로 동작하는지 알 수 있습니다. 7,000개 이상의 항목을 검토하면서도 실제 종료 제안은 단 22개에 불과합니다. 이는 무분별한 이슈 정리가 아닌, 명확한 근거가 있는 항목만 정리하려는 의도를 보여줍니다.

가동률

주기	가동률
시간당	99.2%
일당	98.5%
주당	100%

개발자가今すぐ 활용하는 방법

설치 및 설정

ClawSweeper는 현재 OpenClaw 프로젝트 전용으로 개발되었지만, 유사한 아키텍처를 자신의 프로젝트에 적용할 수 있습니다.

# 저장소 클론
git clone https://github.com/openclaw/clawsweeper.git
cd clawsweeper

# 의존성 설치
npm install

# 설정 파일 확인
cat schema/config.ts

수동 실행

특정 이슈나 PR만 검토하고 싶은 경우:

# 단일 이슈 검토
node src/cli.js review --item_number 72114

# 여러 이슈 동시 검토
node src/cli.js review --item_numbers 72114,72112,71589

자신의 프로젝트에 적용

ClawSweeper의 핵심 로직을 추출하여 재사용할 수 있습니다:

// 핵심 검토 로직 예시
async function reviewIssue(issueNumber: number, githubToken: string) {
  const issue = await github.getIssue(issueNumber);
  const relevantHistory = await github.getIssueHistory(issueNumber);
  
  // AI 검토 프롬프트 구성
  const prompt = buildReviewPrompt(issue, relevantHistory);
  
  // Codex API로 검토 요청
  const review = await codex.analyze(prompt);
  
  // 결과 게시
  await github.postComment(issueNumber, review);
  return review;
}

안전장치와 커뮤니티 신뢰

ClawSweeper의 가장 큰 강점은 안전장치입니다.

절대 자동 종료되지 않는 항목

1. 유지보수자 작성 이슈 — 메인테이너가 직접 작성한 이슈는 자동으로 닫히지 않음
2. 보호된 항목 — 중요한 이슈로 표시된 항목
3. 근거 불충분 — 앞서 언급한 6개 기준에 맞지 않는 항목

Audit 시스템

ClawSweeper는 매시간 자동 감사를 수행하여 다음을 확인합니다:

• 모든 오픈 항목이 검토되었는가
• 누락된 레코드가 있는가
• 종료된 항목이 다시 열렸는가
• 중복 레코드가 있는가

감사 결과는 공개 대시보드에서 확인할 수 있어 커뮤니티의 신뢰를 확보합니다.

향후 발전 방향

ClawSweeper는 지속적으로 진화하고 있습니다.

예상되는 발전 방향

1. 범용화 — OpenClaw以外の 프로젝트에도 적용 가능한 범용 버전 개발
2. LLM 다양화 — 현재 Codex외에도 다양한 LLM 지원
3. 자동 수정 — 단순 종료가 아닌 직접 수정 제안으로 확장
4. 커뮤니티 기여 — 외부 기여자를 통한 기능 확장

요약

ClawSweeper는:

• ✅ 9,000개+ 이슈를 하루 만에 검토하는 병렬 AI 에이전트
• ✅ 0.3% 종료 제안률로 보수적이고 신뢰할 수 있는 동작
• ✅ 99.2%+ 가동률로 안정적인 자동화
• ✅ 유지보수자 이슈 보호로 커뮤니티 신뢰 확보
• ✅ 오픈소스 공개로 투명성 확보

오픈소스 프로젝트의 이슈 관리가 부담이라면, ClawSweeper의 접근 방식을 참고하여 유사한 시스템을 구축하는 것이 좋습니다. 직접 도입이 어렵더라도, 이슈 정리 프로세스의 자동화 방향성을 정하는데 유용한 참고자료가 될 것입니다.