---
read_when:
    - تشخيص اتصال القناة أو صحة Gateway
    - فهم أوامر وخيارات فحص الصحة في CLI
summary: أوامر فحص الحالة ومراقبة حالة Gateway
title: فحوصات الصحة
x-i18n:
    generated_at: "2026-05-02T07:27:06Z"
    model: gpt-5.5
    provider: openai
    source_hash: bf1e0073a09592c6502f697e615f44d0f1a960caf4599888a8b72f22098c1e91
    source_path: gateway/health.md
    workflow: 16
---

دليل قصير للتحقق من اتصال القناة دون تخمين.

## فحوصات سريعة

- `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، ومخرجات الأدوات، وبيانات الاعتماد، وملفات تعريف الارتباط، ومعرّفات الحسابات/الرسائل، والقيم السرية. راجع [تصدير التشخيصات](/ar/gateway/diagnostics).

## إعدادات مراقب الصحة

- `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` (وقت الفحص)، وحالة كل قناة، وتوافر الوكيل، وملخص مخزن الجلسات.

## ذات صلة

- [دليل تشغيل Gateway](/ar/gateway)
- [تصدير التشخيصات](/ar/gateway/diagnostics)
- [استكشاف أخطاء Gateway وإصلاحها](/ar/gateway/troubleshooting)