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

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

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

العَرَض	أسرع فحص	الإصلاح
البوت متصل لكن لا يرد في guild	`openclaw channels status --probe`	اسمح بـ guild/channel وتحقق من نية محتوى الرسائل.
يتم تجاهل رسائل المجموعة	تحقق من السجلات بحثًا عن إسقاطات بوابة الإشارة	أشر إلى البوت أو اضبط `requireMention: false` لـ guild/channel.
استخدام typing/الرموز لكن لا تظهر رسالة Discord	يُظهر سجل الجلسة نص المساعد مع `didSendViaMessagingTool: false`	أجاب النموذج بشكل خاص بدلًا من استدعاء أداة الرسائل. استخدم نموذجًا موثوقًا في استدعاء الأدوات، أو اضبط `messages.groupChat.visibleReplies: "automatic"` للنشر التلقائي.
ردود الرسائل المباشرة مفقودة	`openclaw pairing list discord`	اعتمد اقتران الرسائل المباشرة أو عدّل سياسة الرسائل المباشرة.

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

Slack

بصمات فشل Slack

العَرَض	أسرع فحص	الإصلاح
وضع المقبس متصل لكن لا توجد استجابات	`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 الخاص بالرسائل أو استخدم غلاف SSH لـ `cliPath`.
يمكن الإرسال لكن لا يوجد استقبال على macOS	تحقق من أذونات خصوصية macOS لأتمتة Messages	امنح أذونات TCC مجددًا وأعد تشغيل عملية القناة.
مُرسِل الرسائل المباشرة محظور	`openclaw pairing list imessage`	اعتمد الاقتران أو حدّث قائمة السماح.

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

استكشاف أخطاء iMessage

Signal

بصمات فشل Signal

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

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

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

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

ذو صلة

Was this useful?