استكشاف أخطاء القناة وإصلاحها

استخدم هذه الصفحة عندما تتصل قناة لكن يكون السلوك غير صحيح.

# سلم الأوامر

شغّل هذه الأوامر بالترتيب أولاً:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

الخط الأساسي السليم:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only أو write-capable أو admin-capable
• يعرض فحص القناة أن النقل متصل، وحيثما كان مدعوماً، works أو audit ok

# WhatsApp

# مؤشرات فشل WhatsApp

العرض	أسرع فحص	الإصلاح
متصل لكن لا توجد ردود DM	openclaw pairing list whatsapp	وافق على المرسل أو بدّل سياسة DM/قائمة السماح.
يتم تجاهل رسائل المجموعة	تحقق من requireMention + أنماط الإشارة في التكوين	أشر إلى البوت أو خفف سياسة الإشارة لتلك المجموعة.
تنتهي مهلة تسجيل الدخول عبر QR بـ 408	تحقق من متغيرات بيئة Gateway HTTPS_PROXY / HTTP_PROXY	اضبط وكيلاً يمكن الوصول إليه؛ استخدم NO_PROXY للتجاوزات فقط.
حلقات قطع اتصال/إعادة تسجيل دخول عشوائية	openclaw channels status --probe + السجلات	تتم الإشارة إلى عمليات إعادة الاتصال الأخيرة حتى عند الاتصال حالياً؛ راقب السجلات، وأعد تشغيل Gateway، ثم أعد الربط إذا استمر التذبذب.
تصل الردود متأخرة بثوانٍ/دقائق	openclaw doctor --fix	يوقف Doctor عملاء TUI المحليين المتقادمين والمتحقق منهم عندما يضعفون حلقة أحداث Gateway.

استكشاف الأخطاء الكامل: استكشاف أخطاء WhatsApp

# Telegram

# مؤشرات فشل Telegram

العرض	أسرع فحص	الإصلاح
/start لكن لا يوجد تدفق رد قابل للاستخدام	openclaw pairing list telegram	وافق على الاقتران أو غيّر سياسة DM.
البوت متصل لكن المجموعة تبقى صامتة	تحقق من متطلب الإشارة ووضع خصوصية البوت	عطّل وضع الخصوصية لإظهار المجموعة أو أشر إلى البوت.
فشل الإرسال مع أخطاء شبكة	افحص السجلات بحثاً عن فشل استدعاءات Telegram API	أصلح توجيه DNS/IPv6/الوكيل إلى api.telegram.org.
يبلّغ بدء التشغيل أن getMe returned 401	تحقق من مصدر الرمز المميز المكوّن	أعد نسخ رمز BotFather المميز أو أنشئه من جديد وحدّث botToken أو tokenFile أو TELEGRAM_BOT_TOKEN للحساب الافتراضي.
يتوقف الاستقصاء أو يعيد الاتصال ببطء	openclaw logs --follow لتشخيصات الاستقصاء	قم بالترقية؛ إذا كانت عمليات إعادة التشغيل نتائج إيجابية كاذبة، فاضبط pollingStallThresholdMs. لا تزال التوقفات المستمرة تشير إلى الوكيل/DNS/IPv6.
يتم رفض setMyCommands عند بدء التشغيل	افحص السجلات بحثاً عن BOT_COMMANDS_TOO_MUCH	قلّل أوامر Telegram الخاصة بـ Plugin/Skill/الأوامر المخصصة أو عطّل القوائم الأصلية.
قمت بالترقية وقائمة السماح تحظرك	openclaw security audit وقوائم السماح في التكوين	شغّل openclaw doctor --fix أو استبدل @username بمعرّفات مرسل رقمية.

استكشاف الأخطاء الكامل: استكشاف أخطاء Telegram

# Discord

# مؤشرات فشل Discord

العرض	أسرع فحص	الإصلاح
البوت متصل لكن لا توجد ردود في الخادم	openclaw channels status --probe	اسمح بالخادم/القناة وتحقق من نية محتوى الرسائل.
يتم تجاهل رسائل المجموعة	تحقق من السجلات بحثاً عن إسقاطات بوابة الإشارة	أشر إلى البوت أو اضبط requireMention: false للخادم/القناة.
استخدام للكتابة/الرموز لكن لا توجد رسالة Discord	يعرض سجل الجلسة نص المساعد مع didSendViaMessagingTool: false	أجاب النموذج بشكل خاص بدلاً من استدعاء أداة الرسائل. استخدم نموذجاً موثوقاً في استدعاء الأدوات، أو اضبط messages.groupChat.visibleReplies: "automatic" للنشر التلقائي.
ردود DM مفقودة	openclaw pairing list discord	وافق على اقتران DM أو عدّل سياسة DM.

استكشاف الأخطاء الكامل: استكشاف أخطاء Discord

# Slack

# مؤشرات فشل Slack

العرض	أسرع فحص	الإصلاح
وضع Socket متصل لكن لا توجد استجابات	openclaw channels status --probe	تحقق من رمز التطبيق + رمز البوت والنطاقات المطلوبة؛ راقب botTokenStatus / appTokenStatus = configured_unavailable في الإعدادات المدعومة بـ SecretRef.
رسائل DM محظورة	openclaw pairing list slack	وافق على الاقتران أو خفف سياسة DM.
يتم تجاهل رسالة القناة	تحقق من groupPolicy وقائمة سماح القناة	اسمح للقناة أو بدّل السياسة إلى open.

استكشاف الأخطاء الكامل: استكشاف أخطاء Slack

# iMessage وBlueBubbles

# مؤشرات فشل iMessage وBlueBubbles

العرض	أسرع فحص	الإصلاح
لا توجد أحداث واردة	تحقق من إمكانية الوصول إلى Webhook/الخادم وأذونات التطبيق	أصلح عنوان URL الخاص بـ Webhook أو حالة خادم BlueBubbles.
يمكن الإرسال لكن لا يوجد استقبال على macOS	تحقق من أذونات خصوصية macOS لأتمتة Messages	أعد منح أذونات TCC وأعد تشغيل عملية القناة.
مرسل DM محظور	openclaw pairing list imessage أو openclaw pairing list bluebubbles	وافق على الاقتران أو حدّث قائمة السماح.

استكشاف الأخطاء الكامل:

• استكشاف أخطاء iMessage
• استكشاف أخطاء BlueBubbles

# Signal

# مؤشرات فشل Signal

العرض	أسرع فحص	الإصلاح
البرنامج الخفي قابل للوصول لكن البوت صامت	openclaw channels status --probe	تحقق من عنوان URL/حساب برنامج signal-cli الخفي ووضع الاستقبال.
DM محظور	openclaw pairing list signal	وافق على المرسل أو عدّل سياسة DM.
لا يتم تشغيل ردود المجموعة	تحقق من قائمة سماح المجموعة وأنماط الإشارة	أضف المرسل/المجموعة أو خفف البوابة.

استكشاف الأخطاء الكامل: استكشاف أخطاء Signal

# QQ Bot

# مؤشرات فشل QQ Bot

العرض	أسرع فحص	الإصلاح
يرد البوت "gone to Mars"	تحقق من appId وclientSecret في التكوين	اضبط بيانات الاعتماد أو أعد تشغيل Gateway.
لا توجد رسائل واردة	openclaw channels status --probe	تحقق من بيانات الاعتماد على QQ Open Platform.
لا يتم نسخ الصوت	تحقق من تكوين مزود STT	كوّن channels.qqbot.stt أو tools.media.audio.
لا تصل الرسائل الاستباقية	تحقق من متطلبات تفاعل منصة QQ	قد يحظر QQ الرسائل التي يبدأها البوت دون تفاعل حديث.

استكشاف الأخطاء الكامل: استكشاف أخطاء QQ Bot

# Matrix

# مؤشرات فشل Matrix

العرض	أسرع فحص	الإصلاح
تم تسجيل الدخول لكنه يتجاهل رسائل الغرفة	openclaw channels status --probe	تحقق من groupPolicy وقائمة سماح الغرف وبوابة الإشارة.
لا تتم معالجة DM	openclaw pairing list matrix	وافق على المرسل أو عدّل سياسة DM.
تفشل الغرف المشفرة	openclaw matrix verify status	أعد التحقق من الجهاز، ثم تحقق من openclaw matrix verify backup status.
استعادة النسخة الاحتياطية معلقة/معطلة	openclaw matrix verify backup status	شغّل openclaw matrix verify backup restore أو أعد التشغيل باستخدام مفتاح استرداد.
يبدو التوقيع المتقاطع/التمهيد غير صحيح	openclaw matrix verify bootstrap	أصلح التخزين السري والتوقيع المتقاطع وحالة النسخ الاحتياطي في تمريرة واحدة.

الإعداد والتكوين الكاملان: Matrix

# ذو صلة

• الاقتران
• توجيه القنوات
• استكشاف أخطاء Gateway