كيف تصلح بوت OpenClaw المتوقف عن العمل في BotChat

إذا كانت أي من هذه النقاط مفقودة، فأنت تعرف أين بدأت المشكلة.

📱 تشخيص مشاكل تيليجرام تحديدًا

إذا كنت تستخدم بوت تيليجرام، فهذه أكثر المشاكل شيوعًا وحلولها المباشرة:

🟢 البوت يظهر "متصل" لكنه لا يرد في المجموعات

هذه مشكلة كلاسيكية سببها إعدادات الخصوصية. وثق OpenClaw أنه يجب عليك فعل الآتي:

1. تحقق من خيار requireMention: قد يكون البوت مُعدًا للرد فقط عندما يُشار إليه بـ (@).
2. قم بتعطيل وضع الخصوصية (Privacy Mode): اذهب إلى بوتك في محادثة BotFather على تيليجرام واستخدم الأمر /setprivacy لتعطيله. هذا يسمح للبوت برؤية كل الرسائل في المجموعة.
3. اجعل البوت مشرفًا (Admin): كحل بديل أو إضافي، امنح البوت صلاحيات المشرف في المجموعة.
4. أعد إضافة البوت: بعد تغيير الإعدادات، قد تحتاج إلى إزالة البوت من المجموعة وإضافته مرة أخرى لكي تُطبق تيليجرام التغييرات الجديدة.

🟡 خطأ "getMe returned 401" عند بدء التشغيل

هذا يعني أن رمز البوت (Token) الذي حصلت عليه من BotFather غير صحيح أو منتهي الصلاحية.

• الحل: يجب عليك تحديث الرمز في ملف الإعدادات (botToken أو tokenFile) أو في متغير البيئة (TELEGRAM_BOT_TOKEN) للحساب الافتراضي.

🔴 خطأ "getUpdates 409 conflict"

هذا الخطأ خطير ويعني أن هناك عملية أخرى تستخدم نفس رمز البوت في نفس الوقت. وثائق OpenClaw لتليجرام واضحة جدًا هنا: "الاستطلاع الطويل (Long polling) مُصمم ليكون هناك مستطلع واحد فقط نشط لكل رمز بوت".

• السبب المحتمل: بوابة OpenClaw أخرى، أو سكريبت خارجي، أو أداة استطلاع أخرى تستخدم نفس الرمز.
• الحل: تأكد من إيقاف أي بوابات أو نصوص برمجية أخرى قد تكون متصلة بنفس البوت.

⚪️ مشاكل الشبكة والتوقف المفاجئ

إذا لاحظت أخطاء في الشبكة، أو توقف الاستطلاع، أو بطء في إعادة الاتصال، فالسبب على الأغلب تقني بحت.

• ماذا تفعل؟ راقب السجلات باستمرار عبر

  openclaw logs --follow

  .
• أين تبحث؟ ركز على سجلات واجهة برمجة تطبيقات تيليجرام (Telegram API). المشكلة غالبًا في إعدادات DNS، أو IPv6، أو توجيه البروكسي إلى api.telegram.org.

🔄 ماذا تفعل إذا تعطل البوت بعد تحديث النظام؟

أحيانًا، تحدث المشكلة بعد ترقية OpenClaw. بدلًا من التخمين، اتبع هذا المسار المضمون من التوثيق الرسمي:

1. شغّل

   openclaw status --all

   لترى الصورة الكاملة.
2. شغّل أداة الإصلاح التلقائي

   openclaw doctor --fix

   لتنظيف أي ملفات مؤقتة أو تالفة.
3. أعد تشغيل البوابة

   openclaw gateway restart

   .
4. أعد الفحص مرة أخيرة بـ

   openclaw status --all

   للتأكد من أن كل شيء عاد إلى طبيعته.

خطأ شائع بعد التحديث: "plugin load failed: dependency tree corrupted"

إذا ظهر لك هذا الخطأ، فهذا يعني أن القناة مُعرفة في الإعدادات، لكن تحميل الملحق الإضافي (Plugin) فشل بسبب شجرة ارتباط تالفة. الأمر

openclaw doctor --fix

ملاحظة مهمة عن إعداد تيليجرام: لا يستخدم OpenClaw أمر

openclaw channels login telegram

كما قد تتوقع. بدلًا من ذلك، يتم تفعيل القناة بوضع الرمز في الإعدادات، ثم ضبط

channels.telegram.enabled: true

، ثم تشغيل البوابة. بعدها، للمحادثات الخاصة، يجب الموافقة على الاقتران (Pairing) عبر أمر

openclaw pairing list telegram

.

💎 الخلاصة

• لا يمكننا الجزم بسبب العطل الآن من الأدلة المتاحة وحدها.
• لإصلاح أي مشكلة بدقة، التزم بخطوات التشخيص: شغّل الأوامر الخمسة أعلاه أولاً، وحلل مخرجاتها.
• إذا كانت مشكلتك مع تيليجرام، فتش في هذه الأماكن الأربعة أولاً:
  1. إعدادات الخصوصية والإشارة (@mention).
  2. خطأ الرمز 401 (Token).
  3. مشاكل الشبكة (DNS/IPv6/Proxy).
  4. تعارض الاستطلاع (409 Conflict).

ابدأ بهذه الفحوصات وستجد طريقك للحل بإذن الله.