OpenClaw لا يستجيب

وكيل OpenClaw الذي يبقى ساكنًا دون رد هو أكثر الشكاوى شيوعًا بعد التكلفة، والتشخيص يكاد يكون دائمًا واحدًا من ثمانية أشياء. يوفّر المشروع الأصلي الآن مسار فرز يوصلك إلى التشخيص في نحو دقيقتين. إليك هذا المسار بلغة واضحة، تليه الأسباب التي تملأ المنتديات، وما الذي يتغير عندما يشغّل شخص آخر Gateway نيابةً عنك.

الثواني الستون الأولى

نفّذ السلّم بالترتيب: triage، ثم status، ثم gateway probe، ثم gateway status، ثم doctor، ثم channels probe، ثم تابع السجلات. وتُقرأ السلامة على النحو التالي: قابل للوصول (reachable)، ومحرك التشغيل في حالة running، وفحص الاتصال بنتيجة ok، ولا أخطاء معيقة من doctor، وكل قناة تبلغ عن نقل حي. ويكتب أمر triage تشخيصًا منقّحًا من البيانات الحساسة يمكنك تسليمه إلى وكيل أو منتدى أو فريق الدعم.

المشتبه بهم المعتادون

• إقران معلّق: راسله مرسل غير معروف ولم يوافق أحد على الطلب، لذا يتجاهله بحكم التصميم. والنسخة الإنتاجية من هذه المشكلة هي Gateway عالق في حلقة إعادة اتصال بسبب pairing-required.
• اشتراط الإشارة في مجموعة: يتجاهل رسائل المجموعة إلى أن تتم الإشارة إليه، ويذكر ذلك في السجلات.
• عدم تطابق قائمة السماح: المرسل أو القناة أو النموذج تحجبه السياسة. والنموذج غير المدرج في قائمة السماح يجعل مهام cron والوكلاء الفرعيين تفشل بصمت.
• ملف تعريف الأدوات: ملف التعريف minimal لا يسمح بشيء تقريبًا، لذا يجيب المساعد لكنه لا يستطيع التصرف.
• المزوّد: حد للمعدل، أو بيانات اعتماد منتهية الصلاحية مثل رمز اختبار Google OAuth، أو رفض، ويظهر ذلك في السجلات على هيئة 429 أو 403.
• فشل في التسليم يبدو كأنه فشل في المهمة: مهمة cron موسومة بـ failed مع خطأ 401 من جهة Telegram أو gateway، بينما نجح العمل نفسه.
• مكوّن إضافي أو قناة عُطّلا بعد ترقية، فيكون المساعد قيد التشغيل بينما الباب الذي كان يجيب منه مغلق.
• خدمة Gateway نفسها: متوقفة، أو قيد إعادة التشغيل، أو أُنهيت بسبب نفاد الذاكرة على مضيف صغير.

ظل ساكنًا هناك لمدة ساعتين دون أن يفعل شيئًا.

البطء ليس كالتعطل

الرد الذي يصل متأخرًا بدقائق يعني عادةً نموذجًا مشغولًا، أو سياقًا طويلًا تُعاد قراءته، أو دورة نبض قلب (heartbeat) تشغل الجلسة. تشرح صفحة نبض القلب في OpenClaw هذا الأخير، ولماذا هو أيضًا سبب ألا يكون الوكيل الخامل خاملًا تمامًا أبدًا.

ما الذي يتغير على مضيف مدار

يفترض السلّم أعلاه أن لديك وصول shell إلى الخادم. أما على Diali فلا يوجد خادم: يعرض موجز النشاط عمليات التجهيز والتحديثات وأحداث القنوات، وتوفر لوحة التحكم الإيقاف المؤقت وإعادة التشغيل وإعادة التثبيت، ويخضع Gateway للمراقبة نيابةً عنك. أما الإقران وقوائم السماح وملف تعريف الأدوات فيبقى ضبطها بيدك، لأنها مسألة سياسة لا مسألة تمديدات. وتصف صفحة OpenClaw المستضاف على Diali الباقي.

قبل أن تنشر في منتدى

• شغّل triage وأرفق مخرجاته؛ فهي أول ما سيطلبه كل من يساعدك.
• تحقق من الإقران واشتراط الإشارة قبل أن تعيد ربط أي شيء.
• ابحث في السجلات عن البصمات الثلاث: mention required، وpairing request، وblocked.
• إذا كان بطيئًا لا صامتًا، فانظر أولًا إلى المزوّد ونبض القلب.

وإذا كانت كلمة Gateway في كل هذا هي الجزء الذي لم تفهمه قط، فإليك شرح Gateway في OpenClaw.