Gateway
فحوصات الصحة
دليل قصير للتحقق من اتصال القناة دون تخمين.
فحوصات سريعة
openclaw status— ملخص محلي: قابلية الوصول إلى Gateway/الوضع، تلميح التحديث، عمر مصادقة القناة المرتبطة، الجلسات + النشاط الأخير.openclaw status --all— تشخيص محلي كامل (للقراءة فقط، ملوّن، آمن للصقه عند التصحيح).openclaw status --deep— يطلب من Gateway قيد التشغيل إجراء فحص صحة مباشر (healthمعprobe:true)، بما في ذلك فحوصات القنوات لكل حساب عند دعمها.openclaw health— يطلب من Gateway قيد التشغيل لقطة حالته الصحية (WS فقط؛ لا توجد مقابس قنوات مباشرة من CLI).openclaw health --verbose— يفرض فحص صحة مباشرًا ويطبع تفاصيل اتصال Gateway.openclaw health --json— إخراج لقطة الصحة بصيغة قابلة للقراءة آليًا.- أرسل
/statusكرسالة مستقلة في WhatsApp/WebChat للحصول على رد حالة دون استدعاء الوكيل. - السجلات: تابع
/tmp/openclaw/openclaw-*.logوصفِّ حسبweb-heartbeat، وweb-reconnect، وweb-auto-reply، وweb-inbound.
بالنسبة إلى Discord وموفري الدردشة الآخرين، لا تمثل صفوف الجلسات حيوية المقبس.
تقرأ openclaw sessions وsessions.list في Gateway وأداة الوكيل sessions_list
حالة المحادثة المخزنة. يمكن للمزوّد إعادة الاتصال وإظهار حالة قناة سليمة
قبل تجسيد أي صف جلسة جديد. استخدم حالة القناة وأوامر الصحة أعلاه لفحوصات الاتصال المباشر.
تشخيصات معمقة
- بيانات الاعتماد على القرص:
ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json(ينبغي أن يكون mtime حديثًا). - مخزن الجلسات:
ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json(يمكن تجاوز المسار في الإعدادات). يعرضstatusالعدد والمستلمين الأحدث. - تدفق إعادة الربط:
openclaw channels logout && openclaw channels login --verboseعند ظهور رموز الحالة 409–515 أوloggedOutفي السجلات. (ملاحظة: تدفق تسجيل الدخول عبر QR يعيد التشغيل تلقائيًا مرة واحدة للحالة 515 بعد الاقتران.) - التشخيصات مفعّلة افتراضيًا. يسجل Gateway الحقائق التشغيلية ما لم يتم ضبط
diagnostics.enabled: false. تسجل أحداث الذاكرة أعداد بايت RSS/heap، وضغط العتبة، وضغط النمو. تسجل تحذيرات الحيوية تأخير حلقة الأحداث، واستخدام حلقة الأحداث، ونسبة نوى CPU، وأعداد الجلسات النشطة/المنتظرة/المصفوفة عندما تكون العملية قيد التشغيل لكنها مشبعة. تسجل أحداث الحمولة الزائدة ما رُفض أو اقتُطع أو قُسّم، بالإضافة إلى الأحجام والحدود عند توفرها. لا تسجل نص الرسالة، أو محتويات المرفقات، أو جسم Webhook، أو جسم الطلب أو الاستجابة الخام، أو الرموز، أو ملفات تعريف الارتباط، أو القيم السرية. يبدأ Heartbeat نفسه مسجل الاستقرار المحدود، المتاح عبرopenclaw gateway stabilityأوdiagnostics.stabilityفي Gateway RPC. تستمر عمليات خروج Gateway الفادحة، ومهل إيقاف التشغيل، وفشل بدء إعادة التشغيل في حفظ أحدث لقطة للمسجل ضمن~/.openclaw/logs/stability/عند وجود أحداث؛ افحص أحدث حزمة محفوظة باستخدامopenclaw gateway stability --bundle latest. - لتقارير الأخطاء، شغّل
openclaw gateway diagnostics exportوأرفق ملف zip المُنشأ. يجمع التصدير ملخص Markdown، وأحدث حزمة استقرار، وبيانات وصفية منقّحة للسجلات، ولقطات حالة/صحة Gateway منقّحة، وشكل الإعدادات. وهو مصمم للمشاركة: تُحذف أو تُنقّح نصوص الدردشة، وأجسام Webhook، ومخرجات الأدوات، وبيانات الاعتماد، وملفات تعريف الارتباط، ومعرّفات الحسابات/الرسائل، والقيم السرية. راجع تصدير التشخيصات.
إعدادات مراقب الصحة
gateway.channelHealthCheckMinutes: عدد مرات فحص Gateway لصحة القناة. الافتراضي:5. اضبطه على0لتعطيل عمليات إعادة التشغيل الخاصة بمراقب الصحة عالميًا.gateway.channelStaleEventThresholdMinutes: المدة التي يمكن أن تبقى فيها قناة متصلة خاملة قبل أن يعتبرها مراقب الصحة قديمة ويعيد تشغيلها. الافتراضي:30. أبقِ هذا أكبر من أو يساويgateway.channelHealthCheckMinutes.gateway.channelMaxRestartsPerHour: حد متحرك لمدة ساعة واحدة لعمليات إعادة تشغيل مراقب الصحة لكل قناة/حساب. الافتراضي:10.channels.<provider>.healthMonitor.enabled: تعطيل عمليات إعادة تشغيل مراقب الصحة لقناة محددة مع إبقاء المراقبة العالمية مفعّلة.channels.<provider>.accounts.<accountId>.healthMonitor.enabled: تجاوز متعدد الحسابات تكون له الأولوية على الإعداد على مستوى القناة.- تنطبق هذه التجاوزات لكل قناة على مراقبات القنوات المدمجة التي تعرضها اليوم: Discord، وGoogle Chat، وiMessage، وMicrosoft Teams، وSignal، وSlack، وTelegram، وWhatsApp.
عند فشل شيء ما
logged outأو الحالة 409–515 ← أعد الربط باستخدامopenclaw channels logoutثمopenclaw channels login.- تعذر الوصول إلى Gateway ← ابدأ تشغيله:
openclaw gateway --port 18789(استخدم--forceإذا كان المنفذ مشغولًا). - لا توجد رسائل واردة ← تأكد من أن الهاتف المرتبط متصل بالإنترنت وأن المرسل مسموح به (
channels.whatsapp.allowFrom)؛ في دردشات المجموعات، تأكد من تطابق قائمة السماح + قواعد الإشارة (channels.whatsapp.groups، وagents.list[].groupChat.mentionPatterns).
الأمر المخصص "health"
يطلب openclaw health من Gateway قيد التشغيل لقطة حالته الصحية (لا توجد مقابس قنوات
مباشرة من CLI). افتراضيًا، يمكنه إرجاع لقطة Gateway مخزنة مؤقتًا حديثة؛ ثم
يحدّث Gateway ذلك التخزين المؤقت في الخلفية. يفرض openclaw health --verbose
فحصًا مباشرًا بدلًا من ذلك. يبلّغ الأمر عن بيانات الاعتماد المرتبطة/عمر المصادقة عند توفرها،
وملخصات الفحص لكل قناة، وملخص مخزن الجلسات، ومدة الفحص. يخرج
برمز غير صفري إذا تعذر الوصول إلى Gateway أو فشل الفحص/انتهت مهلته.
الخيارات:
--json: إخراج JSON قابل للقراءة آليًا--timeout <ms>: تجاوز مهلة الفحص الافتراضية البالغة 10 ثوانٍ--verbose: فرض فحص مباشر وطباعة تفاصيل اتصال Gateway--debug: اسم مستعار لـ--verbose
تتضمن لقطة الصحة: ok (قيمة منطقية)، وts (طابع زمني)، وdurationMs (وقت الفحص)، وحالة كل قناة، وتوافر الوكيل، وملخص مخزن الجلسات.