Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
استخدم هذه الصفحة عندما تتصل قناة لكن يكون السلوك خاطئًا.
تسلسل الأوامر
شغّل هذه بالترتيب أولًا:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Runtime: runningConnectivity probe: okCapability: 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. |
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 بمعرفات المُرسِلين الرقمية. |
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 | اعتمد اقتران الرسائل المباشرة أو عدّل سياسة الرسائل المباشرة. |
Slack
بصمات فشل Slack
| العَرَض | أسرع فحص | الإصلاح |
|---|
| وضع المقبس متصل لكن لا توجد استجابات | openclaw channels status --probe | تحقق من رمز التطبيق + رمز البوت والنطاقات المطلوبة؛ راقب botTokenStatus / appTokenStatus = configured_unavailable في الإعدادات المدعومة بـ SecretRef. |
| الرسائل المباشرة محظورة | openclaw pairing list slack | اعتمد الاقتران أو خفف سياسة الرسائل المباشرة. |
| يتم تجاهل رسالة القناة | تحقق من groupPolicy وقائمة السماح للقناة | اسمح بالقناة أو بدّل السياسة إلى open. |
iMessage
بصمات فشل iMessage
| العَرَض | أسرع فحص | الإصلاح |
|---|
imsg مفقود أو يفشل على غير macOS | openclaw channels status --probe --channel imessage | شغّل OpenClaw على Mac الخاص بالرسائل أو استخدم غلاف SSH لـ cliPath. |
| يمكن الإرسال لكن لا يوجد استقبال على macOS | تحقق من أذونات خصوصية macOS لأتمتة Messages | امنح أذونات TCC مجددًا وأعد تشغيل عملية القناة. |
| مُرسِل الرسائل المباشرة محظور | openclaw pairing list imessage | اعتمد الاقتران أو حدّث قائمة السماح. |
Signal
بصمات فشل Signal
| العَرَض | أسرع فحص | الإصلاح |
|---|
| العفريت قابل للوصول لكن البوت صامت | openclaw channels status --probe | تحقق من عنوان URL/الحساب لعفريت signal-cli ووضع الاستقبال. |
| الرسائل المباشرة محظورة | openclaw pairing list 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 الرسائل التي يبدأها البوت من دون تفاعل حديث. |
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 وحالة النسخ الاحتياطي دفعة واحدة. |
ذو صلة
