استكشاف أخطاء القنوات

دليل شامل لحل المشكلات الشائعة في جميع قنوات OpenClaw.

ابدأ بالفحص التلقائي

openclaw doctor
openclaw channels status --probe

الأمر channels status --probe يكتشف أخطاء التكوين الشائعة تلقائيًا ويتحقق من بيانات الاعتماد والأذونات.

مشاكل شائعة حسب القناة

Discord

راجع دليل استكشاف أخطاء Discord للمشاكل المتعلقة بـ:

  • أخطاء المصادقة بالبوت
  • مشاكل الأذونات
  • البوت لا يستجيب في الخوادم

Telegram

إصلاح سريع: أخطاء Network

إذا ظهر الخطأ:

HttpError: Network request for 'sendMessage' failed

السبب: مشكلة DNS IPv6. إذا كان api.telegram.org يحل إلى IPv6 والمضيف يفتقر إلى دعم IPv6.

الحل: فرض IPv4 أو قم بتمكين IPv6. راجع دليل Telegram

WhatsApp

راجع دليل WhatsApp السريع للمشاكل المتعلقة بـ:

  • مشاكل إقران QR
  • انقطاع الاتصال المتكرر
  • أخطاء Multi-device

مشاكل عامة

البوت لا يستجيب

  1. تحقق من أن Gateway قيد التشغيل: openclaw gateway status
  2. تحقق من أن القناة مفعّلة في التكوين: enabled: true
  3. راجع السجلات: openclaw gateway logs --follow
  4. تحقق من بيانات الاعتماد (API tokens، secrets)

أخطاء المصادقة

  • Token غير صحيح: تحقق من أن الرمز منسوخ بالكامل بدون مسافات إضافية
  • Token منتهي الصلاحية: أنشئ token جديد من لوحة تحكم القناة
  • أذونات غير كافية: تأكد من أن البوت لديه الأذونات المطلوبة

الرسائل لا تصل

  • تحقق من إعدادات dmPolicy و groupPolicy
  • إذا كانت dmPolicy: "pairing"، قد تحتاج إلى الموافقة على المرسل
  • في المجموعات، قد تحتاج إلى ذكر البوت (@mention) أولاً

الأوامر المفيدة للتشخيص

# فحص حالة Gateway
openclaw gateway status

# فحص حالة القنوات مع اختبارات مباشرة
openclaw channels status --probe

# عرض السجلات المباشرة
openclaw gateway logs --follow

# إعادة تشغيل Gateway
openclaw gateway restart

# فحص التكوين
openclaw config show channels

المشكلة مستمرة؟

إذا لم تحل المشكلة بعد اتباع هذه الخطوات:

  • راجع دليل القناة المحدد للحصول على تفاصيل أكثر
  • تحقق من الأسئلة الشائعة
  • انضم إلى Discord للحصول على الدعم