---
read_when:
    - تفيد آلية نقل القناة بأنها متصلة، لكن الردود تفشل
    - تحتاج إلى فحوصات خاصة بالقناة قبل التعمق في مستندات المزوّد.
summary: استكشاف أخطاء سريع على مستوى القناة مع بصمات الفشل والإصلاحات لكل قناة
title: استكشاف أخطاء القناة وإصلاحها
x-i18n:
    generated_at: "2026-05-10T19:24:59Z"
    model: gpt-5.5
    provider: openai
    source_hash: f9a314cd772e15c038008b78603f811caaa40a3be31e7268c8fb1eefbb000b32
    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`

## WhatsApp

### بصمات فشل WhatsApp

| العَرَض                             | أسرع فحص                                            | الإصلاح                                                                                                                              |
| ----------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| متصل لكن لا توجد ردود على الرسائل المباشرة | `openclaw pairing list whatsapp`                    | اعتمد المُرسِل أو بدّل سياسة الرسائل المباشرة/قائمة السماح.                                                                         |
| يتم تجاهل رسائل المجموعة            | تحقق من `requireMention` + أنماط الإشارة في التكوين | أشر إلى البوت أو خفف سياسة الإشارة لتلك المجموعة.                                                                                   |
| تنتهي مهلة تسجيل الدخول عبر QR مع 408 | تحقق من متغيرات بيئة Gateway `HTTPS_PROXY` / `HTTP_PROXY` | عيّن وكيلًا يمكن الوصول إليه؛ استخدم `NO_PROXY` للتجاوزات فقط.                                                                      |
| حلقات عشوائية لقطع الاتصال/إعادة تسجيل الدخول | `openclaw channels status --probe` + السجلات        | تُعلَّم عمليات إعادة الاتصال الأخيرة حتى عند الاتصال حاليًا؛ راقب السجلات، وأعد تشغيل 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

| العَرَض                                   | أسرع فحص                                                              | الإصلاح                                                                                                                                                                     |
| ----------------------------------------- | ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| البوت متصل لكن لا يرد في guild            | `openclaw channels status --probe`                                     | اسمح بـ guild/channel وتحقق من نية محتوى الرسائل.                                                                                                                          |
| يتم تجاهل رسائل المجموعة                  | تحقق من السجلات بحثًا عن إسقاطات بوابة الإشارة                         | أشر إلى البوت أو اضبط `requireMention: false` لـ guild/channel.                                                                                                             |
| استخدام typing/الرموز لكن لا تظهر رسالة Discord | يُظهر سجل الجلسة نص المساعد مع `didSendViaMessagingTool: false` | أجاب النموذج بشكل خاص بدلًا من استدعاء أداة الرسائل. استخدم نموذجًا موثوقًا في استدعاء الأدوات، أو اضبط `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 الخاص بالرسائل أو استخدم غلاف 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 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](/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` أو أعد التشغيل بمفتاح استرداد. |
| يبدو cross-signing/bootstrap خاطئًا | `openclaw matrix verify bootstrap`        | أصلح التخزين السري وcross-signing وحالة النسخ الاحتياطي دفعة واحدة.          |

الإعداد والتكوين الكاملان: [Matrix](/ar/channels/matrix)

## ذو صلة

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