---
read_when:
    - يقول نقل القناة إنه متصل لكن الردود تفشل
    - تحتاج إلى فحوصات خاصة بالقناة قبل مستندات المزوّد المتعمقة
summary: استكشاف أخطاء سريع على مستوى القناة مع توقيعات الفشل والإصلاحات لكل قناة
title: استكشاف أخطاء القناة وإصلاحها
x-i18n:
    generated_at: "2026-06-27T17:15:52Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 56b64030ec56553b4c2e156195806029f91bc8cc449588a242b0f45f8bbddb6e
    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 | تحقق من متغيرات بيئة 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)