Açık kaynaklı yapay zeka asistanı projesi OpenClaw, Nisan 2026'ya kadar 7.000'den fazla açık sorun ve çekme isteği biriktirdi. Bu durumdaki çoğu sürdürücü ya hata takip sistemi iflasını ilan eder ya da bir önceliklendirme ekibi kiralardı. OpenClaw sürdürücüleri bunun yerine bir bot geliştirdi. ClawSweeper artık her açık sorunu ve çekme isteğini sürekli bir program dahilinde inceliyor, kanıtlar güçlüyse Codex tarafından hazırlanmış bir kapatma teklifi taslağı oluşturuyor ve bu kapatmaları, teklif hala geçerliyken çalışan ayrı bir yürütme yoluyla uyguluyor.
Aynı zamanda itidal konusunda bir vaka çalışmasıdır. ClawSweeper bir tahmine dayanarak otomatik kapatma yapmaz, sürdürücü tarafından oluşturulan öğelere asla dokunmaz ve temel inceleme çalışma ağacında çöp bıraktıysa herhangi bir değişikliği uygulamayı reddeder.
Bu kılavuz, ClawSweeper'ın ne yaptığını, üç yolun nasıl birlikte çalıştığını, kapatmaması gereken şeyleri kapatmasını engelleyen güvenlik kurallarını ve her incelemeyi destekleyen Codex yapılandırmasını anlatıyor. Ağır işi yapan model hakkında arka plan bilgisi için, GPT-5.5 nedir bölümüne bakın.
TL;DR
- ClawSweeper, `openclaw/openclaw` için OpenClaw'ın bakım botudur ve sürekli bir program dahilinde yaklaşık 7.000 açık öğeyi tarar.
- Üç yol: bir zamanlayıcı neyin inceleneceğini seçer, inceleme yolu kapatma tekliflerini taslak haline getirir, uygulama yolu bunları her 15 dakikada bir yürütür.
- `gpt-5.5` ile Codex, yüksek muhakeme yeteneği, hızlı hizmet katmanı ve öğe başına 10 dakikalık bir zaman aşımı ile incelemeleri yazar.
- Kapatmalar yalnızca altı dar durum için gerçekleşir: uygulandı, çoğaltılamıyor, yinelenen, kapsam dışı, tutarsız veya 60 günden eski bayatlamış.
- Sürdürücü tarafından oluşturulan öğeler, açık referans veren PR'lere sahip öğeler ve korumalı etiketler asla otomatik olarak kapatılmaz.
- Bot genel olarak otomasyon yoluyla 10.217 öğeyi kapatmıştır, ancak en son hafta inceleme başına %0,1'lik bir kapatma oranı göstermektedir; öğeleri açık bırakmaya büyük ölçüde eğilimlidir.
- Lisans MIT'dir, yığın pnpm ile Node 24 üzerinde TypeScript'tir ve işlemler bir GitHub Uygulaması aracılığıyla yürütülür.
ClawSweeper'ın çözdüğü bakım sorunu
OpenClaw kendini “kendi kişisel yapay zeka asistanınız. Herhangi bir işletim sistemi. Herhangi bir platform. Istakoz yolu.” olarak tanıtıyor. Bu konumlandırma hızla geniş bir topluluk çekti: 27 Nisan 2026'daki en son gösterge tablosu anlık görüntüsüne göre 3.546 açık sorun ve 3.457 açık çekme isteği. Bu öğelerin birçoğu, üç sürüm önce düzeltilmiş davranışlara atıfta bulunuyor, eski konuları kopyalıyor veya artık OpenClaw'ın eklenti ve yetenek ekosistemine temel depodan daha uygun olan özellikleri açıklıyor.
Bu hacimde manuel önceliklendirme gerçekçi değildir. Yanlış şeyi kapatmak da maliyetlidir, çünkü göz ardı edildiğini hisseden katkıda bulunanlar katkıda bulunmayı bırakır. ClawSweeper, neyin kapatılacağına karar verme adımını kapatma adımını yürütme adımından ayırarak ve enerjisinin çoğunu cevabın açıkça yinelenen veya tutarsız olduğu öğelere harcayarak bu zorluğun üstesinden gelir.
Üç yol
ClawSweeper üç bağımsız sürece ayrılır. Her biri kendi rapor dizinine günlük kaydı tutar ve diğerlerini etkilemeden duraklatılabilir.
Zamanlayıcı
Zamanlayıcı, hangi sorunların ve çekme isteklerinin inceleneceğine ve hangi sıklıkta olacağına karar verir. README'den: “Yeni ve aktif öğeler daha fazla ilgi görür; eski, sessiz öğeler daha yavaş bir tempoya düşer.” Uygulamada bu, her saat başı sıcak öğeler, 30 günden eski öğeler günlük ve daha eski sorunlar haftalık anlamına gelir. Sıklık kasıtlıdır. Daha fazla kanıt gelmesi durumunda taze bir hata raporunu sık sık yeniden ziyaret etmek istersiniz ve çok eski bir raporu nadiren ziyaret edersiniz, çünkü cevabın değişmesi pek olası değildir.
İnceleme yolu
İnceleme yolu, Codex'in kendini kanıtladığı yerdir. ClawSweeper bir öğe seçer, başlığı, gövdesi, yorumları ve `main` üzerindeki depo durumunun bir anlık görüntüsü ile bir bağlam parçası oluşturur, ardından bu parçayı Codex'e verir. Codex, üç karardan birini içeren yapılandırılmış bir markdown raporu döndürür: açık bırak, X nedeniyle kapat veya yetersiz kanıt. README kapsam hakkında net konuşur: “İnceleme yalnızca teklif amaçlıdır. Öğeleri asla kapatmaz.”
Raporlar, uygulama yolu onları tüketene kadar `items/` dizininde bulunur ve bu, sisteme güvenlik özelliğini kazandırır. Bir insan, depodaki her önerilen kapatmayı onaylanmadan önce okuyabilir.
Uygulama yolu
Uygulama her 15 dakikada bir çalışır. `items/` dizinini tarar, her açık sorun veya PR için en son raporu çeker ve teklifi yeniden doğrular: rapor hala sorunun mevcut durumuyla (yeni yorum yok, sürdürücü etiketi yok, son bir saat içinde açılan referans veren PR yok) tutarlı mı ve üzerinde işlem yapmak için yeterince taze mi? Evet ise, uygulama yolu öğeyi kapatır, Codex tarafından yazılan açıklamayı yorum olarak gönderir ve raporu `closed/` dizinine taşır. Herhangi bir şey değiştiyse, rapor atılır ve zamanlayıcı bir sonraki geçişte öğeyi yeniden değerlendirir.
Bu ayrım, projedeki en önemli tasarım seçimidir. Codex GitHub'a asla doğrudan dokunmaz ve uygulama yolu kapatma uygunluğunu asla değerlendirmez; teklifi yeni koşullar altında uygular.
Kapatma kuralları
ClawSweeper, kapatmaları yalnızca README'den alınan altı dar kategoriye giren öğeler için önerir:
- “mevcut `main` üzerinde uygulandı”
- “mevcut `main` üzerinde çoğaltılamıyor”
- “yinelenen veya standart bir sorun/PR tarafından geçersiz kılınan”
- “somut ancak bu kaynak deposunda uygulanabilir değil” (ClawHub yeteneği veya eklenti çalışması için daha uygun)
- “hiçbir işlem yapılamayacak kadar tutarsız”
- “doğrulamak için çok az veriye sahip 60 günden eski bayatlamış sorun”
Çoğaltılabilir hatalar, geçerli özellik istekleri, kısmi çoğaltmalar ve gerçek ancak önceliklendirilmemiş işler dahil olmak üzere diğer her durum öğeyi açık tutar. En son inceleme geçişindeki %0,1'lik kapatma oranı (incelenen 3.478 sorun arasında önerilen 4 kapatma), istemin yanlış pozitiflerden ne kadar agresif bir şekilde kaçındığını gösterir.
Kapatma kurallarının üzerine birkaç koruma katmanı eklenir:
- Sürdürücü tarafından oluşturulan öğeler asla kapatılmaz. Bir sürdürücü bir sorun açarsa, bot onu bayatlamış olsa bile yalnız bırakır.
- Açık referans veren PR'ler kapatmayı engeller. Eğer #4321 numaralı sorun, gövdesinde `Closes #4321` içeren açık bir PR'ye sahipse, ClawSweeper bekler.
- Korumalı etiketler botu tamamen atlar. Bir sorunu `keep-open` (veya sürdürücülerin yapılandırdığı etiket listesi) ile etiketleyin ve zamanlayıcı onu atlar.
Codex yapılandırması
Codex kurulumu, kendi otomasyonunu oluşturan herhangi bir ekip için en çok ödünç alınmaya değer kısımdır:
`gpt-5.5` ile Codex, yüksek muhakeme yeteneği, hızlı hizmet katmanı ve öğe başına 10 dakikalık bir zaman aşımı ile inceler.
Burada birkaç detay önemlidir. Yüksek muhakeme modu, bir insan için yirmi saniye sonra bariz görünen ancak doğrulamak için beş bağlantılı konuyu takip etmeyi gerektiren yinelenenleri yakalar. Hızlı hizmet katmanı, 7.000 öğelik bir birikmiş işte maliyeti öngörülebilir tutar. 10 dakikalık zaman aşımı bir uyarı değil, katı bir sonlandırmadır; daha uzun süren bir öğe, kuyruğu engellemek yerine bir sonraki geçiş için atılır.
Codex ortamı ayrıca GitHub yazma belirteçleri olmadan çalışır. README bunu açıkça belirtir: “Codex izlenen veya izlenmeyen değişiklikleri geride bırakırsa incelemeler başarısız olur.” Bu, inceleyicinin salt okunur bir analist gibi davranmasını zorlar; herhangi bir yan etki bir hata olarak kabul edilir, bir özellik değil.
Aynı modeli bir bota bağlamadan önce etkileşimli olarak kullanmak isterseniz, Codex CLI, GPT-5.5'e giden en kolay ücretsiz yoldur. Programatik API erişimi için bir maliyet modeli için GPT-5.5 fiyatlandırma dökümüne ve GPT-5.5 API kullanım kılavuzuna bakın.
Yerel kurulum
ClawSweeper'ı klonlamak ve yerel olarak çalıştırmak basittir. Depo, corepack aracılığıyla Node 24 ve pnpm bekler:
git clone https://github.com/openclaw/clawsweeper.git
cd clawsweeper
source ~/.profile
corepack enable
pnpm install
pnpm run build
Yollar başlamadan önce birkaç sırrın mevcut olması gerekir:
OPENAI_API_KEY: inceleme yolu için Codex'i doğrular.CLAWSWEEPER_APP_ID: GitHub Uygulama Kimliği (üretim kurulumu için 3306130).CLAWSWEEPER_APP_PRIVATE_KEY: kısa ömürlü kurulum belirteçleri oluşturmak için kullanılan özel anahtar.OPENCLAW_GH_TOKEN: isteğe bağlıdır, Uygulama yolu başarısız olduğunda kişisel erişim belirtecine geri döner.
İnceleme yolunu sahip olduğunuz herhangi bir depoya karşı çalıştırabilirsiniz. Uygulama yolu, GitHub Uygulama izinlerini yeniden yapılandırmadığınız sürece kasıtlı olarak kendini `openclaw/openclaw` yazma işlemlerine sınırlar.
Ücretli bir API anahtarını tercih eden ancak aynı Codex davranışını isteyen ekipler için, ücretsiz GPT-5.5 yolları, deneme kredileri veya toplayıcı ağ geçitleri aracılığıyla yönlendirilen alternatifleri özetlemektedir.
Gösterge tablosu anlık görüntüsü
README, her uygulama geçişinde güncellenen genel bir gösterge tablosu sunar. En son anlık görüntüye göre:
- Toplam 7.003 açık öğe (3.546 sorun + 3.457 PR)
- Son 7 günde incelenen 3.478 sorun
- Önerilen 4 sorun kapatma (incelenenlerin %0,1'i)
- Lansmandan bu yana otomasyon yoluyla kapatılan toplam 10.217 öğe
%0,1'lik sayı belirleyici. ClawSweeper sorun gelen kutusunu sıfırlamak için optimize etmiyor; “bir katkıda bulunanın sorulsa savunacağı bir şeyi asla kapatmamak” için optimize ediyor. 10.000'den fazla kapatma genelinde, bu muhafazakar duruş, projenin katkıda bulunanların yeni sorunlar açmaya devam etmesi için yeterince güvenilir kalmasını sağladı.
Bu neden API ekipleri için önemli?
GitHub'daki çoğu API ürünü OpenClaw ile aynı yolu izler. SDK veya spesifikasyon herkese açık bir depoda yer alır, sorun takip sistemi karışık hata raporları ve özellik istekleriyle dolar ve önceliklendirme geride kalır. Eğer Apidog'dan bir OpenAPI spesifikasyonu yayınlıyor ve GitHub'da topluluk katkılarını kabul ediyorsanız, ClawSweeper mimarisi taşınabilirdir. Değerli kısımlar istemler değildir, çünkü bunlar OpenClaw'ın alanına bağlıdır. Değerli kısımlar, yol ayrımı, katı kapatma kuralları ve Codex'i yazma erişimi olmadan çalıştırma politikasıdır.
Aynı yaklaşımı üç adımda uygulayabilirsiniz:
- Takipçinizin bir örneği üzerinde Codex destekli bir inceleme işi çalıştırın. Hiçbir şey taahhüt etmeden markdown raporları üretmesini sağlayın.
- Güvenlik kurallarını katmanlayın: sürdürücü öğelerini asla kapatmayın, korumalı etiketlere saygı gösterin, açık PR'lere erteleyin.
- Bir uygulama yolunu yalnızca inceleme raporları elle okunduğunda doğru göründüğünde ekleyin. Güven oluşana kadar günde en fazla birkaç tane kapatacak şekilde bağlayın.
Bu sorunların tanımladığı API yüzeyini doğrulamak isterseniz, Apidog sözleşme tarafını halleder. Aynı OpenAPI belgesi, sahte sunucuları, otomatik testleri ve katkıda bulunanlarınızın bir hata bildirmeden önce okuduğu belgeleri yönlendirir. Bir önceliklendirme botunu sıkı sürüm kontrollü bir spesifikasyonla eşleştirmek, bot çalışmaya başlamadan önce genellikle yinelenen sorun oranını yarı yarıya düşürür. Spesifikasyon disipliniyle başlamak isterseniz Apidog'u indirin.
Sınırlamalar ve tasarım tavizleri
ClawSweeper'ın bilerek yapmadığı birkaç şey:
- Kod yazmaz. PR yok, yama yok, düzeltmeler öneren inceleme yorumları yok. Bu iş diğer OpenClaw botlarına aittir.
- Öncelik hakkında akıl yürütmez. Kapatma ikilidir; hiçbir şey "öncelik düşürülmez" veya bot tarafından etiketlenmez.
- Geçmiş kapatmalardan öğrenmez. Her inceleme `main`'e karşı yeni başlar. Önceki kararlar, ince ayar verileri olarak değil, yalnızca `closed/` altındaki geçmiş raporlar olarak görünür.
Bu tavizler, botun öngörülebilir kalmasının nedenidir. Ayrıca, ClawSweeper'ın dar yetki alanına girmeden, etiketleyici bir bot, bayat PR denetleyicisi veya sürüm notu taslağı hazırlayıcısı gibi bitişik otomasyonlar için de yer bırakırlar.
SSS
ClawSweeper sorunları otomatik olarak ne sıklıkta kapatır? Uygulama yolu her 15 dakikada bir çalışır, ancak çoğu döngü sıfır kapatma üretir. 27 Nisan 2026'daki inceleme başına %0,1'lik kapatma oranı, bir hafta boyunca incelenen 3.478 soruna karşılık kabaca 4 kapatma anlamına gelir. İncelemelerin arkasındaki model hakkında arka plan bilgisi için, GPT-5.5 nedir bölümüne bakın.
ClawSweeper'ı kendi depomda çalıştırabilir miyim? Evet. Depoyu klonlayın, hedef üzerinde okuma/yazma erişimi olan kendi GitHub Uygulamanızı yapılandırın ve `CLAWSWEEPER_APP_ID` ile `CLAWSWEEPER_APP_PRIVATE_KEY`'i ona yönlendirin. Başkalarının depolarını incelemek varsayılan olarak salt okunurdur.
ClawSweeper ücretli bir OpenAI planı gerektiriyor mu? İnceleme yolu, ücretli bir API kimlik bilgisi olan `OPENAI_API_KEY` aracılığıyla kimlik doğrulaması yapar. Yalnızca etkileşimli olarak, büyük ölçekli değil, incelemeler yapmak isterseniz, ücretsiz bir ChatGPT planındaki Codex CLI işe yarar.
Codex'in gerçek hataları kapatmasını ne engeller? Üç şey. Dar kapatma kural listesi, sürdürücü ve korumalı etiket istisnaları ve temel sorunun incelemeden bu yana değiştiği herhangi bir teklifi reddeden uygulama yolunun yeniden doğrulama adımı.
ClawSweeper açık kaynaklı mı? Evet, MIT lisanslıdır ve kaynak kodu GitHub'da openclaw/clawsweeper adresindedir. Ana proje OpenClaw, kendi katkıda bulunma rehberi olan ayrı bir depodur.