جمّعت OpenClaw، مشروع مساعد الذكاء الاصطناعي مفتوح المصدر، أكثر من 7,000 مشكلة مفتوحة وطلب سحب بحلول أبريل 2026. معظم المشرفين في هذا الموقف إما سيعلنون إفلاس متتبع الأخطاء أو سيوظفون فريق فرز. بدلاً من ذلك، قام مشرفو OpenClaw ببناء روبوت. يقوم ClawSweeper الآن بمراجعة كل مشكلة وطلب سحب مفتوحين وفق جدول زمني متجدد، ويصيغ اقتراح إغلاق من تأليف Codex عندما تكون الأدلة قوية، ويطبق هذه الإغلاقات عبر مسار تنفيذ منفصل يعمل فقط عندما يكون الاقتراح لا يزال ساريًا.
وهو أيضًا دراسة حالة في ضبط النفس. لا يقوم ClawSweeper بالإغلاق التلقائي بناءً على حدس، ولا يلمس أبدًا العناصر التي كتبها المشرفون، ويرفض تطبيق أي تغيير إذا تركت المراجعة الأساسية مخلفات في شجرة العمل.
يستعرض هذا الدليل ما يفعله ClawSweeper، وكيف تعمل المسارات الثلاثة معًا، وقواعد الأمان التي تمنعه من إغلاق أشياء لا ينبغي إغلاقها، وتكوين Codex الذي يدعم كل مراجعة. للحصول على معلومات أساسية حول النموذج الذي يقوم بالعمل الشاق، راجع ما هو GPT-5.5.
ملخص سريع
- ClawSweeper هو روبوت الصيانة الخاص بـ OpenClaw لمشروع
openclaw/openclaw، يقوم بمسح حوالي 7,000 عنصر مفتوح وفق جدول متجدد. - ثلاثة مسارات: يختار المجدول ما يجب مراجعته، ويقوم مسار المراجعة بصياغة مقترحات الإغلاق، وينفذ مسار التطبيق هذه المقترحات كل 15 دقيقة.
- يكتب Codex مع
gpt-5.5، بقدرة استدلال عالية، ومستوى خدمة سريع، ومهلة 10 دقائق لكل عنصر، المراجعات. - تتم عمليات الإغلاق فقط لست حالات محددة: تم التنفيذ، غير قابلة للتكرار، مكررة، خارج النطاق، غير مترابطة، أو قديمة لأكثر من 60 يومًا.
- العناصر التي كتبها المشرفون، والعناصر التي تحتوي على طلبات سحب مفتوحة مرجعية، والتسميات المحمية لا يتم إغلاقها تلقائيًا أبدًا.
- أغلق الروبوت 10,217 عنصرًا عبر الأتمتة بشكل عام، لكن الأسبوع الأخير يظهر معدل إغلاق بنسبة 0.1% لكل مرور مراجعة؛ إنه يميل بشدة إلى ترك الأمور مفتوحة.
- الترخيص هو MIT، والمكدس هو TypeScript على Node 24 مع pnpm، وتتم العمليات عبر تطبيق GitHub.
مشكلة الصيانة التي يحلها ClawSweeper
تُعرّف OpenClaw نفسها بأنها "مساعدك الشخصي للذكاء الاصطناعي. أي نظام تشغيل. أي منصة. بطريقة سرطان البحر." وقد اجتذب هذا الموقف مجتمعًا واسعًا بسرعة: 3,546 مشكلة مفتوحة و 3,457 طلب سحب مفتوح اعتبارًا من أحدث لقطة لوحة معلومات في 27 أبريل 2026. يشير الكثير من هذه العناصر إلى سلوك تم إصلاحه قبل ثلاثة إصدارات، أو يكرر سلاسل محادثات أقدم، أو يصف ميزات أصبحت الآن أكثر ملاءمة لنظام OpenClaw للمكونات الإضافية والمهارات بدلاً من المستودع الأساسي.
الفرز اليدوي بهذا الحجم ليس واقعيًا. إغلاق الشيء الخطأ مكلف أيضًا، لأن المساهمين الذين يشعرون بالتجاهل يتوقفون عن المساهمة. يحل ClawSweeper هذه المعضلة من خلال فصل خطوة تحديد ما يجب إغلاقه عن خطوة تنفيذ الإغلاق، ومن خلال قضاء معظم طاقته على العناصر التي يكون فيها الجواب بوضوح مكررًا أو غير مترابط.
المسارات الثلاثة
ينقسم ClawSweeper إلى ثلاث عمليات مستقلة. تسجل كل عملية في دليل التقارير الخاص بها ويمكن إيقافها مؤقتًا دون التأثير على الآخرين.
المجدول
يقرر المجدول أي المشكلات وطلبات السحب يتم مراجعتها وبأي وتيرة. من ملف README: "تحظى العناصر الجديدة والنشطة باهتمام أكبر؛ وتتراجع العناصر القديمة الهادئة إلى وتيرة أبطأ." في الممارسة العملية، هذا يعني العناصر الساخنة كل ساعة، والعناصر التي يقل عمرها عن 30 يومًا يوميًا، والمشكلات الأقدم أسبوعيًا. الوتيرة متعمدة. ترغب في إعادة زيارة تقرير خطأ جديد بشكل متكرر، في حال وصول المزيد من الأدلة، ونادرًا ما تزور تقريرًا قديمًا جدًا، لأن الإجابة من غير المرجح أن تتغير.
مسار المراجعة
مسار المراجعة هو حيث يكسب Codex عيشه. يختار ClawSweeper عنصرًا، وينشئ جزء سياق يحتوي على العنوان، والنص، والتعليقات، ولقطة لحالة المستودع على main، ثم يسلم الجزء إلى Codex. يعيد Codex تقرير markdown منظمًا بثلاثة أحكام: إبقاء مفتوحًا، إغلاق بسبب X، أو أدلة غير كافية. يوضح ملف README بصراحة النطاق: "المراجعة هي مقترحات فقط. ولا تغلق العناصر أبدًا."
تظل التقارير في items/ حتى يستهلكها مسار التطبيق، وهذا يمنح النظام خاصية الأمان الخاصة به. يمكن للإنسان قراءة كل إغلاق مقترح في المستودع قبل أن يتم تنفيذه.
مسار التطبيق
يعمل مسار التطبيق كل 15 دقيقة. يتصفح items/، ويسحب أحدث تقرير لكل مشكلة أو طلب سحب مفتوح، ويعيد التحقق من صحة الاقتراح: هل التقرير لا يزال متسقًا مع الحالة الحية للمشكلة (لا تعليقات جديدة، لا تسمية مشرف، لا طلب سحب مرجعي مفتوح في الساعة الأخيرة)، وهل هو حديث بما يكفي لاتخاذ إجراء؟ إذا كانت الإجابة نعم، يقوم مسار التطبيق بإغلاق العنصر، وينشر الشرح الذي ألفه Codex كتعليق، وينقل التقرير إلى closed/. إذا تغير أي شيء، يتم تجاهل التقرير ويعيد المجدول النظر في العنصر في المرور التالي.
يعد هذا التقسيم أهم خيار تصميم في المشروع. لا يلمس Codex GitHub مباشرة أبدًا، ولا يفكر مسار التطبيق أبدًا في مدى جدارة الإغلاق؛ بل يفرض الاقتراح بموجب شروط جديدة.
قواعد الإغلاق
يقترح ClawSweeper الإغلاقات فقط للعناصر التي تقع ضمن إحدى المجموعات الست الضيقة، المأخوذة مباشرة من ملف README:
- "تم التنفيذ على
mainالحالي" - "غير قابلة للتكرار على
mainالحالي" - "مكررة أو تم تجاوزها بواسطة مشكلة/طلب سحب أساسي"
- "محددة ولكن غير قابلة للتنفيذ في مستودع المصدر هذا" (مناسبة بشكل أفضل لعمل مهارات أو مكونات ClawHub الإضافية)
- "غير مترابطة بما يكفي لعدم إمكانية اتخاذ أي إجراء"
- "مشكلة قديمة لأكثر من 60 يومًا مع بيانات قليلة جدًا للتحقق"
كل حالة أخرى، بما في ذلك الأخطاء القابلة للتكرار، وطلبات الميزات الصالحة، وحالات التكرار الجزئي، والعمل الحقيقي ولكن غير ذي الأولوية، تبقي العنصر مفتوحًا. يخبرك معدل الإغلاق البالغ 0.1% في آخر مرور للمراجعة (4 إغلاقات مقترحة عبر 3,478 مشكلة تمت مراجعتها) بمدى عدوانية الموجه في تجنب الإيجابيات الخاطئة.
تتراكب بعض الحمايات فوق قواعد الإغلاق:
- العناصر التي كتبها المشرفون لا تُغلق أبدًا. إذا قام مشرف بفتح مشكلة، يتركها الروبوت وشأنها بغض النظر عن قدمها.
- طلبات السحب المرجعية المفتوحة تمنع الإغلاق. إذا كانت المشكلة #4321 تحتوي على طلب سحب مفتوح مع
Closes #4321في النص، ينتظر ClawSweeper. - التسميات المحمية تتجاوز الروبوت تمامًا. ضع علامة على مشكلة
keep-open(أو أي قائمة تسميات يحددها المشرفون) ويتجاهلها المجدول.
إعدادات كوديكس
إعداد Codex هو الجزء الأكثر أهمية للاستعارة لأي فريق يقوم ببناء أتمتة خاصة به:
gpt-5.5تتضمن بعض التفاصيل الهامة هنا. يلتقط وضع الاستدلال العالي التكرارات التي تبدو واضحة للإنسان بعد عشرين ثانية ولكنها تتطلب مطاردة خمس سلاسل محادثات مرتبطة للتحقق منها. يحافظ مستوى الخدمة السريع على تكلفة يمكن التنبؤ بها على قائمة مهام مؤلفة من 7,000 عنصر. مهلة الـ 10 دقائق هي إيقاف قاسٍ، وليست تحذيرًا؛ يتم إسقاط العنصر الذي يستغرق وقتًا أطول للمرور التالي بدلاً من حظر قائمة الانتظار.
يعمل بيئة Codex أيضًا بدون رموز كتابة GitHub. يوضح ملف README ذلك بوضوح: "تفشل المراجعات إذا ترك Codex تغييرات متعقبة أو غير متعقبة." وهذا يجبر المراجع على التصرف كمحلل للقراءة فقط؛ أي تأثير جانبي هو خطأ، وليس ميزة.
إذا كنت ترغب في استخدام نفس النموذج بشكل تفاعلي قبل ربطه بروبوت، فإن واجهة سطر الأوامر الخاصة بـ Codex هي أسهل طريقة مجانية للوصول إلى GPT-5.5. للحصول على نموذج تكلفة للوصول البرمجي إلى واجهة برمجة التطبيقات، راجع تفاصيل تسعير GPT-5.5 و دليل استخدام واجهة برمجة تطبيقات GPT-5.5.
الإعداد المحلي
استنساخ ClawSweeper وتشغيله محليًا أمر مباشر. يتوقع المستودع Node 24 و pnpm عبر corepack:
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 (3306130 للتثبيت الإنتاجي).CLAWSWEEPER_APP_PRIVATE_KEY: المفتاح الخاص المستخدم لإنشاء رموز تثبيت قصيرة الأجل.OPENCLAW_GH_TOKEN: اختياري، يعود إلى رمز وصول شخصي عندما يفشل مسار التطبيق.
يمكنك تشغيل مسار المراجعة على أي مستودع تملكه. يحد مسار التطبيق نفسه عمدًا من عمليات الكتابة في openclaw/openclaw ما لم تقم بإعادة تكوين أذونات تطبيق GitHub.
للفرق التي تفضل مفتاح API مدفوع ولكنها تريد نفس سلوك Codex، فإن المسارات المجانية لـ GPT-5.5 توضح بدائل تمر عبر أرصدة تجريبية أو بوابات مجمعة.
لقطة لوحة القيادة
يأتي ملف README مع لوحة معلومات عامة يتم تحديثها مع كل تمريرة تطبيق. اعتبارًا من أحدث لقطة:
- إجمالي 7,003 عناصر مفتوحة (3,546 مشكلة + 3,457 طلب سحب)
- 3,478 مشكلة تمت مراجعتها في الأيام السبعة الماضية
- 4 إغلاقات مقترحة للمشكلات (0.1% من المراجعات)
- إجمالي 10,217 عنصرًا تم إغلاقها تلقائيًا منذ الإطلاق
الرقم 0.1% هو الدليل. لا يعمل ClawSweeper على تحسين صندوق وارد المشاكل ليصبح صفرًا؛ بل يعمل على تحسين "عدم إغلاق شيء قد يدافع عنه المساهم إذا طُلب منه ذلك." عبر أكثر من 10,000 إغلاق، هذا الموقف المحافظ هو ما حافظ على مصداقية المشروع بما يكفي لكي يستمر المساهمون في فتح مشاكل جديدة.
لماذا هذا مهم لفرق واجهة برمجة التطبيقات
تتبع معظم منتجات API على GitHub نفس مسار OpenClaw. تعيش SDK أو المواصفات في مستودع عام، ويمتلئ متتبع المشكلات بتقارير الأخطاء المختلطة وطلبات الميزات، ويتأخر الفرز. إذا قمت بنشر مواصفات OpenAPI من Apidog وقبلت مساهمات المجتمع في GitHub، فإن بنية ClawSweeper قابلة للنقل. الأجزاء القيمة ليست المطالبات، لأنها مرتبطة بمجال OpenClaw. الأجزاء القيمة هي فصل المسارات، وقواعد الإغلاق الصارمة، وسياسة تشغيل Codex بدون وصول للكتابة.
يمكنك تطبيق نفس النهج في ثلاث خطوات:
- شغل وظيفة مراجعة مدفوعة بـ Codex على عينة من متتبعك. اطلب منها إنتاج تقارير markdown دون الالتزام بأي شيء.
- أضف قواعد الأمان: لا تغلق أبدًا عناصر المشرفين، احترم التسميات المحمية، وتأجيل طلبات السحب المفتوحة.
- أضف مسار تطبيق فقط عندما تبدو تقارير المراجعة صحيحة عند قراءتها يدويًا. اربطها لإغلاق عدد قليل جدًا يوميًا حتى تتراكم الثقة.
إذا كنت تقوم بالتحقق من سطح واجهة برمجة التطبيقات الذي تصفه هذه المشكلات، فإن Apidog يتعامل مع جانب العقد. يقوم نفس مستند OpenAPI بتشغيل خوادم وهمية، واختبارات آلية، والوثائق التي يقرأها مساهموك قبل تقديم خطأ. عادةً ما يقلل إقران روبوت فرز بمواصفات ذات إصدارات دقيقة من معدل المشكلات المكررة إلى النصف قبل أن يعمل الروبوت على الإطلاق. قم بتنزيل Apidog إذا كنت ترغب في البدء بانضباط المواصفات.
الحدود والمقايضات التصميمية
بعض الأمور التي لا يفعلها ClawSweeper عن قصد:
- لا يكتب رمزًا برمجيًا. لا توجد طلبات سحب، ولا تصحيحات، ولا تعليقات مراجعة تقترح إصلاحات. هذا العمل ينتمي إلى روبوتات OpenClaw الأخرى.
- لا يفكر في الأولوية. الإغلاق ثنائي؛ لا يتم "خفض الأولوية" أو تصنيف أي شيء بواسطة الروبوت.
- لا يتعلم من الإغلاقات السابقة. تبدأ كل مراجعة من جديد مقابل
main. تظهر القرارات السابقة فقط كتقارير تاريخية تحتclosed/، وليس كبيانات ضبط دقيق.
هذه المقايضات هي السبب في أن الروبوت يبقى قابلاً للتنبؤ. كما أنها تترك مجالًا للأتمتة المجاورة، مثل روبوت التسمية، أو مكتشف طلبات السحب القديمة، أو صياغة ملاحظات الإصدار، دون تجاوز نطاق ClawSweeper الضيق.
الأسئلة الشائعة
كم مرة يغلق ClawSweeper المشكلات تلقائيًا؟يعمل مسار التطبيق كل 15 دقيقة، لكن معظم الدورات لا تنتج أي إغلاقات. يعني معدل الإغلاق بنسبة 0.1% لكل مراجعة في 27 أبريل 2026 حوالي 4 إغلاقات مقابل 3,478 مشكلة تمت مراجعتها خلال أسبوع. للحصول على معلومات أساسية حول النموذج الذي يقف وراء المراجعات، راجع ما هو GPT-5.5.
هل يمكنني تشغيل ClawSweeper على المستودع الخاص بي؟نعم. استنسخ المستودع، وقم بتكوين تطبيق GitHub الخاص بك مع أذونات القراءة/الكتابة على الهدف، ووجه CLAWSWEEPER_APP_ID و CLAWSWEEPER_APP_PRIVATE_KEY إليه. مراجعة مستودعات الآخرين تكون للقراءة فقط افتراضيًا.
هل يتطلب ClawSweeper خطة OpenAI مدفوعة؟ يوثق مسار المراجعة عبر OPENAI_API_KEY، وهو بيانات اعتماد API مدفوعة. إذا كنت ترغب فقط في إجراء مراجعات تفاعلية بدلاً من نطاق واسع، فإن واجهة سطر الأوامر الخاصة بـ Codex على خطة ChatGPT المجانية تعمل.
ما الذي يمنع Codex من إغلاق الأخطاء الحقيقية؟ثلاثة أشياء. قائمة قواعد الإغلاق الضيقة، واستثناءات المشرفين والتسميات المحمية، وخطوة إعادة التحقق في مسار التطبيق التي تتجاهل أي اقتراح تغيرت فيه المشكلة الأساسية منذ المراجعة.
هل ClawSweeper مفتوح المصدر؟نعم، بترخيص MIT، مع الكود المصدري على GitHub في openclaw/clawsweeper. المشروع الأم OpenClaw هو مستودع منفصل مع دليل المساهمة الخاص به.
