ClawSweeper: Bot tự động quản lý issue mã nguồn mở dựa trên AI

Kho lưu trữ openclaw/openclaw đang tồn đọng hơn 13.000 mục chưa được xử lý, tính cả issue đang mở và PR. ClawSweeper là một bot dùng AI để tự động rà soát các mục này, phân loại mục nào có thể đóng và mục nào cần giữ mở, được thiết kế dựa trên nguyên tắc bảo thủ: “nếu không chắc chắn thì không đóng”.

Cách vận hành cốt lõi

• Hệ thống vận hành theo pipeline 3 giai đoạn. Ở giai đoạn Plan, bot sắp xếp mức độ ưu tiên; ở giai đoạn Review, OpenAI Codex (gpt-5.4) phân tích mã nguồn, lịch sử commit và bình luận issue ở chế độ chỉ đọc; còn ở giai đoạn Apply, thao tác đóng thực tế được thực hiện thông qua kích hoạt thủ công.
• Điều kiện đề xuất đóng chỉ giới hạn trong 5 trường hợp. Bao gồm: đã được triển khai, không thể tái hiện, cần chuyển sang plugin riêng, nội dung không rõ ràng, hoặc bị bỏ mặc hơn 60 ngày mà vẫn thiếu thông tin. Ngoài các trường hợp này, tất cả đều được giữ mở.
• Xử lý khối lượng lớn bằng 40 shard song song. Mỗi mục có thời gian chờ tối đa 10 phút; kết quả rà soát được lưu thành tệp Markdown, kèm theo căn cứ quyết định và bằng chứng (đường dẫn tệp, commit SHA, v.v.).

Cơ chế an toàn

• Các mục do maintainer tạo sẽ bị loại khỏi diện tự động đóng. Bot không đụng tới issue·PR của những người có vai trò OWNER, MEMBER hoặc COLLABORATOR.
• Kiểm tra thay đổi bằng snapshot hash. Nếu issue đã được cập nhật trong khoảng giữa thời điểm đề xuất và thời điểm áp dụng, bot sẽ tự động bỏ qua để ngăn việc áp dụng nguyên trạng một nhận định đã cũ.
• Việc đề xuất và áp dụng được tách rời, bảo đảm luôn có cơ hội để con người can thiệp.

Kết quả thực tế (tính đến tháng 4/2025)

• Trong 7 ngày, số mục đã được rà soát là 8.419 issue và 5.026 PR. Trong đó, khoảng 33,7% issue và 11,4% PR được phân loại là ứng viên có thể đóng, và thực tế đã dọn được 3.907 mục.
• Số ca thất bại và lỗi là 17, chiếm dưới 0,1% tổng số.
• Độ bao phủ cadence hằng ngày đạt 98,2%, nghĩa là gần như mọi mục đều được đưa vào diện rà soát mỗi ngày.

Đặc điểm của stack công nghệ

• Toàn bộ logic được cấu thành từ một tệp TypeScript duy nhất dài khoảng 2.500 dòng, nên ít phụ thuộc bên ngoài và cấu trúc đơn giản. Trình biên dịch dùng tsgo dựa trên Go, còn linter và formatter dùng oxlint·oxfmt dựa trên Rust để tăng tốc độ build.
• Chạy bằng cron mỗi giờ của GitHub Actions, kèm logic throttling tự động chờ để phù hợp với giới hạn tốc độ API.

Triết lý thiết kế: dùng AI như trợ lý, nhưng giữ phán đoán cuối cùng cho con người

Điều ClawSweeper cho thấy không phải là viễn cảnh AI thay thế maintainer. Nó chỉ chọn ra những mục có căn cứ rõ ràng trong số 13.000 mục, còn các quyết định còn lại thì trả về cho con người. Việc tỷ lệ đề xuất đóng chỉ dừng ở khoảng 1/4 tổng số cũng là bằng chứng cho thấy bot không dọn dẹp quá tay. Dự án này cho thấy rất rõ rằng để công cụ AI thực sự phát huy hiệu quả trong việc duy trì mã nguồn mở, điều quan trọng hơn sự tinh vi về mặt kỹ thuật là việc xác định ranh giới: tự động hóa đến đâu và nên dừng lại ở đâu.