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

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

تسلسل الأوامر

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

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 حيثما كان ذلك مدعومًا

بعد التحديث

استخدم هذا عندما تختفي Telegram أو iMessage أو إعدادات حقبة BlueBubbles أو قناة Plugin أخرى بعد التحديث.

openclaw status --all
openclaw doctor --fix
openclaw gateway restart
openclaw status --all

ابحث عن plugin load failed: dependency tree corrupted; run openclaw doctor --fix في openclaw status --all. يعني ذلك أن القناة مُعدّة، لكن إعداد Plugin أو تحميله واجه شجرة تبعيات تالفة بدلًا من تسجيل القناة. يمسح openclaw doctor --fix الروابط الرمزية القديمة لتبعيات وقت تشغيل Plugin وظلال المصادقة القديمة، ثم يعيد openclaw gateway restart تحميل حالة سليمة.

مؤشرات فشل WhatsApp

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

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء WhatsApp وإصلاحها

مؤشرات فشل Telegram

العَرَض	أسرع فحص	الإصلاح
`/start` لكن لا يوجد مسار رد قابل للاستخدام	`openclaw pairing list telegram`	وافق على الاقتران أو غيّر سياسة الرسائل الخاصة.
البوت متصل لكن المجموعة تظل صامتة	تحقّق من شرط الإشارة ووضع خصوصية البوت	عطّل وضع الخصوصية لإتاحة رؤية رسائل المجموعة أو أشر إلى البوت.
فشل الإرسال مع أخطاء في الشبكة	افحص السجلات بحثًا عن حالات فشل استدعاء واجهة Telegram البرمجية	أصلح توجيه 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 أو Skills أو الأوامر المخصصة، أو عطّل القوائم الأصلية.
أجريت ترقية وأصبحت قائمة السماح تحظرك	`openclaw security audit` وقوائم السماح في الإعدادات	شغّل `openclaw doctor --fix` أو استبدل `@username` بمعرّفات المُرسِلين الرقمية.

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء Telegram وإصلاحها

Discord

مؤشرات فشل Discord

العَرَض	أسرع فحص	الإصلاح
البوت متصل لكن لا توجد ردود في الخادم	`openclaw channels status --probe`	اسمح بالخادم/القناة وتحقّق من تفعيل صلاحية الوصول إلى محتوى الرسائل.
تُتجاهل رسائل المجموعة	تحقّق من السجلات بحثًا عن عمليات إسقاط ناتجة عن بوابة الإشارات	أشر إلى البوت أو عيّن `requireMention: false` للخادم/القناة.
يوجد نشاط كتابة/استخدام للرموز لكن لا تظهر رسالة في Discord	تحقّق مما إذا كان هذا حدثًا في غرفة محيطة أو غرفة مشتركة اختارت استخدام `message_tool` ولم يستدعِ فيها النموذج `message(action=send)`	افحص سجل Gateway التفصيلي بحثًا عن بيانات تعريف الحمولة النهائية المحجوبة، وتحقّق من `messages.groupChat.unmentionedInbound`، واقرأ أحداث الغرف المحيطة، أو أبقِ `messages.groupChat.visibleReplies: "automatic"` لطلبات المجموعة العادية.
ردود الرسائل الخاصة مفقودة	`openclaw pairing list discord`	وافق على اقتران الرسائل الخاصة أو عدّل سياستها.

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء Discord وإصلاحها

Slack

مؤشرات فشل Slack

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

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء Slack وإصلاحها

iMessage

مؤشرات فشل iMessage

العَرَض	أسرع فحص	الإصلاح
`imsg` مفقود أو يفشل على نظام غير macOS	`openclaw channels status --probe --channel imessage`	شغّل OpenClaw على جهاز Mac الذي يحتوي على Messages أو استخدم مغلّف SSH لـ `cliPath`.
يمكن الإرسال لكن لا يمكن الاستقبال على macOS	تحقّق من أذونات خصوصية macOS لأتمتة Messages	امنح أذونات TCC مجددًا وأعد تشغيل عملية القناة.
مُرسِل الرسائل الخاصة محظور	`openclaw pairing list imessage`	وافق على الاقتران أو حدّث قائمة السماح.

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء iMessage وإصلاحها

Signal

مؤشرات فشل Signal

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

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء Signal وإصلاحها

بوت QQ

مؤشرات فشل بوت QQ

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

استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء بوت QQ وإصلاحها

Matrix

مؤشرات فشل Matrix

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

الإعداد والتهيئة بالكامل: Matrix

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

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

تسلسل الأوامر

بعد التحديث

WhatsApp

مؤشرات فشل WhatsApp

Telegram

مؤشرات فشل Telegram

Discord

مؤشرات فشل Discord

Slack

مؤشرات فشل Slack

iMessage

مؤشرات فشل iMessage

Signal

مؤشرات فشل Signal

بوت QQ

مؤشرات فشل بوت QQ

Matrix

مؤشرات فشل Matrix

ذو صلة

​تسلسل الأوامر

​بعد التحديث

​WhatsApp

​مؤشرات فشل WhatsApp

​Telegram

​مؤشرات فشل Telegram

​Discord

​مؤشرات فشل Discord

​Slack

​مؤشرات فشل Slack

​iMessage

​مؤشرات فشل iMessage

​Signal

​مؤشرات فشل Signal

​بوت QQ

​مؤشرات فشل بوت QQ

​Matrix

​مؤشرات فشل Matrix

​ذو صلة

تسلسل الأوامر

بعد التحديث

WhatsApp

مؤشرات فشل WhatsApp

Telegram

مؤشرات فشل Telegram

Discord

مؤشرات فشل Discord

Slack

مؤشرات فشل Slack

iMessage

مؤشرات فشل iMessage

Signal

مؤشرات فشل Signal

بوت QQ

مؤشرات فشل بوت QQ

Matrix

مؤشرات فشل Matrix

ذو صلة