> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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    | تحقق من متغيرات بيئة Gateway `HTTPS_PROXY` / `HTTP_PROXY` | عيّن وكيلًا يمكن الوصول إليه؛ استخدم `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 API     | أصلح توجيه DNS/IPv6/الوكيل إلى `api.telegram.org`.                                                                                         |
| يبلّغ بدء التشغيل أن `getMe returned 401`   | تحقق من مصدر الرمز المهيأ                            | انسخ رمز BotFather مجددًا أو أعد توليده وحدّث `botToken` أو `tokenFile` أو `TELEGRAM_BOT_TOKEN` للحساب الافتراضي.                          |
| يتوقف polling أو يعيد الاتصال ببطء          | `openclaw logs --follow` لتشخيصات polling            | رقّ؛ إذا كانت عمليات إعادة التشغيل إنذارات كاذبة، فاضبط `pollingStallThresholdMs`. ما زالت حالات التوقف المستمرة تشير إلى الوكيل/DNS/IPv6. |
| رُفض `setMyCommands` عند بدء التشغيل        | افحص السجلات بحثًا عن `BOT_COMMANDS_TOO_MUCH`        | قلّل أوامر Telegram الخاصة بـ Plugin/skill/المخصصة أو عطّل القوائم الأصلية.                                                                |
| بعد الترقية أصبحت قائمة السماح تحظرك        | `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

| العَرَض                              | أسرع فحص                                  | الإصلاح                                                                                                                                                   |
| ------------------------------------ | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| وضع Socket متصل لكن لا توجد استجابات | `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

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

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

## بوت QQ

### بصمات فشل بوت QQ

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

استكشاف الأخطاء الكامل: [استكشاف أخطاء QQ Bot وإصلاحها](/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)