> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# تصدير التشخيصات

يمكن لـ OpenClaw إنشاء ملف ZIP تشخيصات محلي لتقارير الأخطاء. يجمع
حالة Gateway المنقّحة، والصحة، والسجلات، وشكل الإعدادات، وأحداث
الاستقرار الحديثة الخالية من الحمولة.

تعامل مع حزم التشخيصات كأنها أسرار حتى تراجعها. صُممت بحيث تحذف
أو تنقّح الحمولات وبيانات الاعتماد، لكنها لا تزال تلخص سجلات
Gateway المحلية وحالة وقت التشغيل على مستوى المضيف.

## البدء السريع

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway diagnostics export
```

يطبع الأمر مسار ملف ZIP المكتوب. لاختيار مسار:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
```

للأتمتة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway diagnostics export --json
```

## أمر الدردشة

يمكن للمالكين استخدام `/diagnostics [note]` في الدردشة لطلب تصدير Gateway محلي.
استخدم هذا عندما يحدث الخطأ في محادثة حقيقية وتريد تقريرًا واحدًا
قابلًا للنسخ واللصق للدعم:

1. أرسل `/diagnostics` في المحادثة التي لاحظت فيها المشكلة. أضف
   ملاحظة قصيرة إذا كان ذلك مفيدًا، مثل `/diagnostics bad tool choice`.
2. يرسل OpenClaw تمهيد التشخيصات ويطلب موافقة تنفيذ صريحة واحدة.
   تشغّل الموافقة `openclaw gateway diagnostics export --json`.
   لا توافق على التشخيصات من خلال قاعدة سماح شاملة.
3. بعد الموافقة، يرد OpenClaw بتقرير قابل للصق يحتوي على مسار الحزمة المحلي،
   وملخص البيان، وملاحظات الخصوصية، ومعرّفات الجلسات ذات الصلة.

في الدردشات الجماعية، لا يزال بإمكان المالك تشغيل `/diagnostics`، لكن OpenClaw لا
ينشر تفاصيل التشخيصات مرة أخرى في الدردشة المشتركة. يرسل التمهيد،
ومطالبات الموافقة، ونتيجة تصدير Gateway، وتفصيل جلسة/سلسلة Codex
إلى المالك عبر مسار الموافقة الخاص. لا تحصل المجموعة إلا على إشعار قصير
بأن تدفق التشخيصات أُرسل بشكل خاص. إذا لم يتمكن OpenClaw من العثور على مسار مالك
خاص، يفشل الأمر بإغلاق آمن ويطلب من المالك تشغيله من رسالة مباشرة.

عندما تستخدم جلسة OpenClaw النشطة حزمة OpenAI Codex الأصلية،
تغطي موافقة التنفيذ نفسها أيضًا رفع ملاحظات OpenAI لسلاسل وقت تشغيل Codex
التي يعرفها OpenClaw. هذا الرفع منفصل عن ملف ZIP المحلي لـ Gateway
ولا يظهر إلا لجلسات حزمة Codex. قبل الموافقة، يوضح
المطلب أن الموافقة على التشخيصات سترسل أيضًا ملاحظات Codex، لكنه
لا يسرد معرّفات جلسات Codex أو السلاسل. بعد الموافقة، يسرد رد الدردشة
القنوات، ومعرّفات جلسات OpenClaw، ومعرّفات سلاسل Codex، وأوامر الاستئناف المحلية
للسلاسل التي أُرسلت إلى خوادم OpenAI. إذا رفضت الموافقة أو تجاهلتها،
فلن يشغّل OpenClaw التصدير، ولن يرسل ملاحظات Codex، ولن
يطبع معرّفات Codex.

يجعل ذلك حلقة تصحيح أخطاء Codex الشائعة قصيرة: لاحظ السلوك السيئ في
Telegram أو Discord أو قناة أخرى، وشغّل `/diagnostics`، ووافق مرة واحدة، وشارك
التقرير مع الدعم، ثم شغّل الأمر المطبوع `codex resume <thread-id>`
محليًا إذا كنت تريد فحص سلسلة Codex الأصلية بنفسك. راجع
[حزمة Codex](/ar/plugins/codex-harness#inspect-codex-threads-locally) للاطلاع على
سير عمل الفحص هذا.

## ما يحتويه التصدير

يتضمن ملف ZIP:

* `summary.md`: نظرة عامة مقروءة للبشر للدعم.
* `diagnostics.json`: ملخص قابل للقراءة آليًا للإعدادات، والسجلات، والحالة، والصحة،
  وبيانات الاستقرار.
* `manifest.json`: بيانات تعريف التصدير وقائمة الملفات.
* شكل الإعدادات المنقّح وتفاصيل الإعدادات غير السرية.
* ملخصات السجلات المنقّحة وأسطر السجلات الحديثة المنقّحة.
* لقطات حالة وصحة Gateway بأفضل جهد.
* `stability/latest.json`: أحدث حزمة استقرار محفوظة، عندما تكون متاحة.

يكون التصدير مفيدًا حتى عندما تكون Gateway غير سليمة. إذا لم تتمكن Gateway من
الرد على طلبات الحالة أو الصحة، فستظل السجلات المحلية، وشكل الإعدادات، وأحدث
حزمة استقرار تُجمع عندما تكون متاحة.

## نموذج الخصوصية

صُممت التشخيصات لتكون قابلة للمشاركة. يحتفظ التصدير ببيانات تشغيلية
تساعد في تصحيح الأخطاء، مثل:

* أسماء الأنظمة الفرعية، ومعرّفات plugins، ومعرّفات المزوّدين، ومعرّفات القنوات، والأوضاع المهيأة
* رموز الحالة، والمدد، وعدد البايتات، وحالة الطابور، وقراءات الذاكرة
* بيانات تعريف السجلات المنقّحة والرسائل التشغيلية المنقّحة
* شكل الإعدادات وإعدادات الميزات غير السرية

يحذف التصدير أو ينقّح:

* نص الدردشة، والمطالبات، والتعليمات، وأجسام Webhook، ومخرجات الأدوات
* بيانات الاعتماد، ومفاتيح API، والرموز، وملفات تعريف الارتباط، والقيم السرية
* أجسام الطلبات أو الاستجابات الخام
* معرّفات الحسابات، ومعرّفات الرسائل، ومعرّفات الجلسات الخام، وأسماء المضيفين، وأسماء المستخدمين المحليين

عندما تبدو رسالة سجل كنص مستخدم أو دردشة أو مطالبة أو حمولة أداة، فإن
التصدير يحتفظ فقط بأن رسالة حُذفت وعدد البايتات.

## مسجل الاستقرار

تسجل Gateway تدفق استقرار محدودًا وخاليًا من الحمولة افتراضيًا عندما
تكون التشخيصات مفعلة. وهو مخصص للحقائق التشغيلية، وليس للمحتوى.

يسجل Heartbeat التشخيصي نفسه عينات الحيوية عندما تستمر Gateway في العمل
لكن تبدو حلقة أحداث Node.js أو CPU مشبعة. تتضمن أحداث
`diagnostic.liveness.warning` هذه تأخير حلقة الأحداث، واستخدام حلقة الأحداث،
ونسبة أنوية CPU، وعدد الجلسات النشطة/المنتظرة/المصفوفة، ومرحلة
بدء التشغيل/وقت التشغيل الحالية عندما تكون معروفة، وامتدادات المراحل الحديثة، وتسميات
العمل النشط/المصفوف المحدودة. تبقى عينات الخمول في القياسات عن بُعد عند مستوى `info`.
تصبح عينات الحيوية تحذيرات Gateway فقط عندما يكون العمل منتظرًا أو مصفوفًا، أو عندما يتداخل العمل النشط
مع تأخير مستمر في حلقة الأحداث. تبقى طفرات الحد الأقصى للتأخير العابرة أثناء
عمل الخلفية السليم بخلاف ذلك في سجلات التصحيح. لا تعيد تشغيل
Gateway من تلقاء نفسها.

تُصدر مراحل بدء التشغيل أيضًا أحداث `diagnostic.phase.completed` مع توقيت ساعة الحائط و
CPU. تعلّم تشخيصات التشغيل المضمّن المتوقفة `terminalProgressStale=true`
عندما يبدو آخر تقدم للجسر نهائيًا، مثل عنصر استجابة خام أو
حدث اكتمال استجابة، لكن Gateway لا تزال تعتبر التشغيل المضمّن
نشطًا.

افحص المسجل الحي:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json
```

افحص أحدث حزمة استقرار محفوظة بعد خروج فادح، أو مهلة إيقاف تشغيل،
أو فشل بدء تشغيل بعد إعادة التشغيل:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stability --bundle latest
```

أنشئ ملف ZIP تشخيصات من أحدث حزمة محفوظة:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stability --bundle latest --export
```

توجد الحزم المحفوظة تحت `~/.openclaw/logs/stability/` عند وجود أحداث.

## خيارات مفيدة

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway diagnostics export \
  --output openclaw-diagnostics.zip \
  --log-lines 5000 \
  --log-bytes 1000000
```

* `--output <path>`: اكتب إلى مسار ZIP محدد.
* `--log-lines <count>`: الحد الأقصى لأسطر السجل المنقّحة المطلوب تضمينها.
* `--log-bytes <bytes>`: الحد الأقصى لبايتات السجل المطلوب فحصها.
* `--url <url>`: عنوان URL لـ WebSocket الخاص بـ Gateway للقطات الحالة والصحة.
* `--token <token>`: رمز Gateway للقطات الحالة والصحة.
* `--password <password>`: كلمة مرور Gateway للقطات الحالة والصحة.
* `--timeout <ms>`: مهلة لقطة الحالة والصحة.
* `--no-stability-bundle`: تخطَّ البحث عن حزمة الاستقرار المحفوظة.
* `--json`: اطبع بيانات تعريف التصدير القابلة للقراءة آليًا.

## تعطيل التشخيصات

التشخيصات مفعلة افتراضيًا. لتعطيل مسجل الاستقرار
وجمع أحداث التشخيصات:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  diagnostics: {
    enabled: false,
  },
}
```

يقلل تعطيل التشخيصات تفاصيل تقارير الأخطاء. لا يؤثر ذلك في تسجيل
Gateway العادي.

لقطات ضغط الذاكرة الحرج معطلة افتراضيًا. للاحتفاظ بأحداث التشخيصات
والتقاط لقطة الاستقرار قبل OOM أيضًا:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  diagnostics: {
    memoryPressureSnapshot: true,
  },
}
```

استخدم هذا فقط على المضيفين الذين يمكنهم تحمل فحص نظام الملفات الإضافي وكتابة اللقطة
أثناء ضغط الذاكرة الحرج. لا تزال أحداث ضغط الذاكرة العادية
تسجل RSS، والكومة، والعتبة، وحقائق النمو عندما تكون اللقطة معطلة.

## ذات صلة

* [فحوصات الصحة](/ar/gateway/health)
* [CLI Gateway](/ar/cli/gateway#gateway-diagnostics-export)
* [بروتوكول Gateway](/ar/gateway/protocol#system-and-identity)
* [التسجيل](/ar/logging)
* [تصدير OpenTelemetry](/ar/gateway/opentelemetry) — تدفق منفصل لبث التشخيصات إلى جامع