خط الأساس للنظام السليم يجب أن يظهر هذه الإشارات بوضوح في مخرجات الأوامر: السطر الذي يقول Runtime: running، سطر Connectivity probe: ok، وسطر Capability: ... الذي يحدد قدرات القناة (للقراءة فقط، للكتابة، أو صلاحيات مدير). أما فحص القناة فيجب أن يظهر أن النقل متصل، وفي الأنظمة التي تدعم ذلك، يجب رؤية works أو audit ok .

إن لم تظهر هذه المؤشرات، فالمشكلة أعمق من مجرد "البوت لا يستجيب". قد يكون الخلل في شجرة الاعتماديات (dependency tree) التالفة، وهذا يظهر برسالة مثل plugin load failed: dependency tree corrupted. في هذه الحالة، الأمر openclaw doctor --fix هو الحل المباشر لأنه يزيل الملفات المؤقتة التالفة ويعيد بناء المسار .

ماذا تفعل تحديداً مع بوت تيليجرام؟

توثيق OpenClaw لقناة تيليجرام يوضح أنماط فشل محددة لها أسباب وحلول مباشرة. لا يجب التعامل معها كصندوق أسود :

• البوت يظهر "متصل" لكنه صامت في المجموعات: لا تتجه فوراً لإعدادات الشبكة. المشكلة غالباً في إعدادات الخصوصية للبوت نفسه. تأكد من إعداد mention requirement و privacy mode في إعدادات بوتك لدى BotFather. إذا كان البوت لا يقرأ كل الرسائل، فلن يستجيب إلا للمنشن .
• فشل في الإرسال مع أخطاء شبكة: هنا نبدأ بالنظر في سجلات API الخاصة بتيليجرام. مسار التحقيق الرئيسي هو DNS، أو مشاكل IPv6، أو توجيه البروكسي إلى api.telegram.org. لا تفترض أن الإنترنت يعمل، بل تأكد من أن الاتصال بهذا العنوان تحديداً مستقر .
• ظهور الخطأ getMe returned 401 عند بدء التشغيل: هذا خطأ واضح جداً ويعني أن رمز المصادقة (token) الذي حصلت عليه من BotFather غير صحيح أو انتهت صلاحيته. الحل الوحيد هو تحديث قيمة botToken، أو التأكد من مسار tokenFile، أو تحديث متغير البيئة TELEGRAM_BOT_TOKEN .
• توقف الاستطلاع (polling stall) أو بطء إعادة الاتصال: الحل الوحيد هنا هو مراقبة السجلات الحية بشكل مستمر عبر openclaw logs --follow. إذا استمرت المشكلة لفترة طويلة، نعود فوراً لمسار التحقيق الأساسي: DNS، إعدادات IPv6، أو البروكسي .

الخلاصة

كان الخطأ الأكبر هو الاستمرار في التحليل والاستنتاج بدون وجود مخرجات حقيقية من الأوامر التشخيصية الخمسة. هذه الأوامر ليست اختيارية، بل هي البوصلة الوحيدة الموثوقة .

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

خط الأساس للنظام السليم يجب أن يظهر هذه الإشارات بوضوح في مخرجات الأوامر: السطر الذي يقول Runtime: running، سطر Connectivity probe: ok، وسطر Capability: ... الذي يحدد قدرات القناة (للقراءة فقط، للكتابة، أو صلاحيات مدير). أما فحص القناة فيجب أن يظهر أن النقل متصل، وفي الأنظمة التي تدعم ذلك، يجب رؤية works أو audit ok .

إن لم تظهر هذه المؤشرات، فالمشكلة أعمق من مجرد "البوت لا يستجيب". قد يكون الخلل في شجرة الاعتماديات (dependency tree) التالفة، وهذا يظهر برسالة مثل plugin load failed: dependency tree corrupted. في هذه الحالة، الأمر openclaw doctor --fix هو الحل المباشر لأنه يزيل الملفات المؤقتة التالفة ويعيد بناء المسار .

ماذا تفعل تحديداً مع بوت تيليجرام؟

توثيق OpenClaw لقناة تيليجرام يوضح أنماط فشل محددة لها أسباب وحلول مباشرة. لا يجب التعامل معها كصندوق أسود :

• البوت يظهر "متصل" لكنه صامت في المجموعات: لا تتجه فوراً لإعدادات الشبكة. المشكلة غالباً في إعدادات الخصوصية للبوت نفسه. تأكد من إعداد mention requirement و privacy mode في إعدادات بوتك لدى BotFather. إذا كان البوت لا يقرأ كل الرسائل، فلن يستجيب إلا للمنشن .
• فشل في الإرسال مع أخطاء شبكة: هنا نبدأ بالنظر في سجلات API الخاصة بتيليجرام. مسار التحقيق الرئيسي هو DNS، أو مشاكل IPv6، أو توجيه البروكسي إلى api.telegram.org. لا تفترض أن الإنترنت يعمل، بل تأكد من أن الاتصال بهذا العنوان تحديداً مستقر .
• ظهور الخطأ getMe returned 401 عند بدء التشغيل: هذا خطأ واضح جداً ويعني أن رمز المصادقة (token) الذي حصلت عليه من BotFather غير صحيح أو انتهت صلاحيته. الحل الوحيد هو تحديث قيمة botToken، أو التأكد من مسار tokenFile، أو تحديث متغير البيئة TELEGRAM_BOT_TOKEN .
• توقف الاستطلاع (polling stall) أو بطء إعادة الاتصال: الحل الوحيد هنا هو مراقبة السجلات الحية بشكل مستمر عبر openclaw logs --follow. إذا استمرت المشكلة لفترة طويلة، نعود فوراً لمسار التحقيق الأساسي: DNS، إعدادات IPv6، أو البروكسي .

الخلاصة

كان الخطأ الأكبر هو الاستمرار في التحليل والاستنتاج بدون وجود مخرجات حقيقية من الأوامر التشخيصية الخمسة. هذه الأوامر ليست اختيارية، بل هي البوصلة الوحيدة الموثوقة .

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