Configuration
استكشاف أخطاء القناة وإصلاحها
استخدم هذه الصفحة عندما تتصل قناة لكن يكون سلوكها غير صحيح.
تسلسل الأوامر
شغّل هذه الأوامر بالترتيب أولًا:
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeخط الأساس السليم:
Runtime: runningConnectivity probe: okCapability: read-onlyأوwrite-capableأوadmin-capable- يُظهر فحص القناة أن وسيلة النقل متصلة، ويُظهر
worksأوaudit okحيثما كان ذلك مدعومًا
بعد التحديث
استخدم هذا عندما تختفي Telegram أو iMessage أو إعدادات حقبة BlueBubbles أو قناة Plugin أخرى بعد التحديث.
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 | تحقّق من متغيري البيئة HTTPS_PROXY وHTTP_PROXY الخاصين بـ Gateway |
عيّن وكيلًا يمكن الوصول إليه؛ استخدم NO_PROXY لحالات التجاوز فقط. |
| حلقات عشوائية لقطع الاتصال/إعادة تسجيل الدخول | openclaw channels status --probe والسجلات |
تُعلَّم عمليات إعادة الاتصال الحديثة حتى عند وجود اتصال حالي؛ راقب السجلات، وأعد تشغيل Gateway، ثم أعد الربط إذا استمر عدم استقرار الاتصال. |
حلقة status=408 Request Time-out |
الفحص والسجلات وdoctor ثم حالة Gateway | أصلح اتصال المضيف/التوقيت أولًا؛ احتفظ بنسخة احتياطية من بيانات المصادقة وأعد ربط الحساب إذا استمرت الحلقة. |
| تصل الردود متأخرة ثوانٍ/دقائق | openclaw doctor --fix |
يوقف doctor عملاء TUI المحليين المتقادمين الذين تأكد أنهم يضعفون حلقة أحداث Gateway. |
استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء WhatsApp وإصلاحها
Telegram
مؤشرات فشل Telegram
| العَرَض | أسرع فحص | الإصلاح |
|---|---|---|
/start لكن لا يوجد مسار رد قابل للاستخدام |
openclaw pairing list telegram |
وافق على الاقتران أو غيّر سياسة الرسائل الخاصة. |
| البوت متصل لكن المجموعة تظل صامتة | تحقّق من شرط الإشارة ووضع خصوصية البوت | عطّل وضع الخصوصية لإتاحة رؤية رسائل المجموعة أو أشر إلى البوت. |
| فشل الإرسال مع أخطاء في الشبكة | افحص السجلات بحثًا عن حالات فشل استدعاء واجهة Telegram البرمجية | أصلح توجيه DNS أو IPv6 أو الوكيل إلى api.telegram.org. |
يُبلغ بدء التشغيل بأن getMe returned 401 |
تحقّق من مصدر الرمز المميز المُعدّ | أعد نسخ رمز BotFather المميز أو أنشئه مجددًا وحدّث botToken أو tokenFile أو TELEGRAM_BOT_TOKEN للحساب الافتراضي. |
| يتوقف الاستقصاء أو يعيد الاتصال ببطء | استخدم openclaw logs --follow لتشخيصات الاستقصاء |
رقِّ البرنامج؛ إذا كانت عمليات إعادة التشغيل نتائج إيجابية زائفة، فاضبط pollingStallThresholdMs. لا تزال حالات التوقف المستمرة تشير إلى الوكيل أو DNS أو IPv6. |
يُرفض setMyCommands عند بدء التشغيل |
افحص السجلات بحثًا عن BOT_COMMANDS_TOO_MUCH |
قلّل أوامر Telegram الخاصة بـ Plugin أو Skills أو الأوامر المخصصة، أو عطّل القوائم الأصلية. |
| أجريت ترقية وأصبحت قائمة السماح تحظرك | 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
| العَرَض | أسرع فحص | الإصلاح |
|---|---|---|
| وضع المقبس متصل لكن لا توجد استجابات | 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
| العَرَض | أسرع فحص | الإصلاح |
|---|---|---|
| يمكن الوصول إلى الخدمة الخلفية لكن البوت صامت | openclaw channels status --probe |
تحقّق من عنوان URL لخدمة signal-cli الخلفية والحساب ووضع الاستقبال. |
| الرسائل الخاصة محظورة | openclaw pairing list signal |
وافق على المُرسِل أو عدّل سياسة الرسائل الخاصة. |
| لا يتم تشغيل ردود المجموعة | تحقّق من قائمة السماح للمجموعات وأنماط الإشارة | أضف المُرسِل/المجموعة أو خفّف القيود. |
استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء Signal وإصلاحها
بوت QQ
مؤشرات فشل بوت QQ
| العَرَض | أسرع فحص | الإصلاح |
|---|---|---|
| يرد البوت بأنه «ذهب إلى المريخ» | تحقّق من appId وclientSecret في الإعدادات |
عيّن بيانات الاعتماد أو أعد تشغيل Gateway. |
| لا توجد رسائل واردة | openclaw channels status --probe |
تحقّق من بيانات الاعتماد في منصة QQ المفتوحة. |
| لا يتم تحويل الصوت إلى نص | تحقّق من إعدادات مزوّد تحويل الكلام إلى نص | اضبط channels.qqbot.stt أو tools.media.audio. |
| الرسائل الاستباقية لا تصل | تحقّق من متطلبات التفاعل في منصة QQ | قد يحظر QQ الرسائل التي يبدأها البوت إذا لم يكن هناك تفاعل حديث. |
استكشاف الأخطاء وإصلاحها بالكامل: استكشاف أخطاء بوت QQ وإصلاحها
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?
