---
read_when:
    - تُظهر قناة النقل أنها متصلة، لكن تفشل الردود
    - تحتاج إلى عمليات تحقق خاصة بالقناة قبل التعمق في وثائق مزود الخدمة
summary: استكشاف أخطاء القنوات وإصلاحها بسرعة باستخدام مؤشرات الأعطال والإصلاحات الخاصة بكل قناة
title: استكشاف أخطاء القناة وإصلاحها
x-i18n:
    generated_at: "2026-07-12T05:36:29Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d2699b48ed6ab1f702789d2180daa43aed6ee83023889d0d8821faceb9a943b5
    source_path: channels/troubleshooting.md
    workflow: 16
---

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

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

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

```bash
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 أخرى بعد التحديث.

```bash
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

### مؤشرات فشل 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 وإصلاحها](/ar/channels/whatsapp#troubleshooting)

## Telegram

### مؤشرات فشل 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 وإصلاحها](/ar/channels/telegram#troubleshooting)

## Discord

### مؤشرات فشل Discord

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

استكشاف الأخطاء وإصلاحها بالكامل: [استكشاف أخطاء Discord وإصلاحها](/ar/channels/discord#troubleshooting)

## Slack

### مؤشرات فشل Slack

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

استكشاف الأخطاء وإصلاحها بالكامل: [استكشاف أخطاء Slack وإصلاحها](/ar/channels/slack#troubleshooting)

## iMessage

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

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

استكشاف الأخطاء وإصلاحها بالكامل: [استكشاف أخطاء iMessage وإصلاحها](/ar/channels/imessage#troubleshooting)

## Signal

### مؤشرات فشل Signal

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

استكشاف الأخطاء وإصلاحها بالكامل: [استكشاف أخطاء Signal وإصلاحها](/ar/channels/signal#troubleshooting)

## بوت QQ

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

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

استكشاف الأخطاء وإصلاحها بالكامل: [استكشاف أخطاء بوت QQ وإصلاحها](/ar/channels/qqbot#troubleshooting)

## 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](/ar/channels/matrix)

## ذو صلة

- [الاقتران](/ar/channels/pairing)
- [توجيه القنوات](/ar/channels/channel-routing)
- [استكشاف أخطاء Gateway وإصلاحها](/ar/gateway/troubleshooting)