Configuration

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

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

سلّم الأوامر

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

bash

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw 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 --allopenclaw doctor --fixopenclaw gateway restartopenclaw 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	تحقق من متغيرات بيئة 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

بصمات فشل 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

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

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

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

استكشاف الأخطاء الكامل: استكشاف أخطاء Signal

بوت 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 وإصلاحها

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

ذو صلة

Was this useful?