Skip to main content
يمكن لـ OpenClaw إنشاء ملف تشخيصات محلي بصيغة .zip لإرفاقه بتقارير الأخطاء، ويتضمن حالة Gateway بعد تنقيحها، ومعلومات الصحة، والسجلات، وبنية الإعدادات، وأحداث الاستقرار الحديثة الخالية من الحمولات. تعامل مع حزم التشخيصات كما تتعامل مع الأسرار إلى أن تتم مراجعتها. تُنقَّح الحمولات وبيانات الاعتماد بحكم التصميم، لكن الحزمة تظل تلخّص سجلات Gateway المحلية وحالة وقت التشغيل على مستوى المضيف.

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

يطبع مسار ملف zip الذي تمت كتابته. لاختيار مسار إخراج:
للأتمتة:

​
أمر المحادثة

يمكن للمالكين تشغيل /diagnostics [note] في أي محادثة لطلب تصدير محلي من Gateway في صورة تقرير دعم واحد قابل للنسخ واللصق:
  1. أرسل /diagnostics، ويمكنك اختياريًا إرفاق ملاحظة قصيرة (/diagnostics bad tool choice).
  2. يرسل OpenClaw تمهيدًا ويطلب موافقة صريحة واحدة على التنفيذ، والتي تشغّل openclaw gateway diagnostics export --json. لا توافق على التشخيصات عبر قاعدة تسمح بكل شيء.
  3. بعد الموافقة، يرد OpenClaw بمسار الحزمة المحلية وملخص البيان وملاحظات الخصوصية ومعرّفات الجلسات ذات الصلة.
في المحادثات الجماعية، يظل بإمكان المالك تشغيل /diagnostics، لكن OpenClaw يرسل نتيجة التصدير ومطالبات الموافقة وتفاصيل جلسات/سلاسل Codex إلى المالك على نحو خاص. لا ترى المجموعة سوى إشعار قصير يفيد بأن التشخيصات أُرسلت بشكل خاص. إذا لم يتوفر مسار خاص إلى المالك، يفشل الأمر بشكل مغلق ويطلب من المالك تشغيله من رسالة مباشرة. عندما تستخدم الجلسة النشطة بيئة OpenAI Codex الأصلية، تغطي موافقة التنفيذ نفسها أيضًا رفع ملاحظات إلى OpenAI بشأن سلاسل Codex التي يعرفها OpenClaw. يكون هذا الرفع منفصلًا عن ملف zip المحلي الخاص بـ Gateway، ولا يحدث إلا لجلسات بيئة Codex. توضّح مطالبة الموافقة أن الموافقة ترسل أيضًا ملاحظات Codex، من دون إدراج معرّفات جلسات Codex أو سلاسلها. بعد الموافقة، يسرد الرد القنوات ومعرّفات جلسات OpenClaw ومعرّفات سلاسل Codex وأوامر الاستئناف المحلية للسلاسل التي أُرسلت إلى OpenAI. يؤدي رفض الموافقة أو تجاهلها إلى تخطي التصدير ورفع ملاحظات Codex وقائمة معرّفات Codex. وهذا يجعل دورة تصحيح أخطاء Codex قصيرة: لاحظ السلوك السيئ في قناة، وشغّل /diagnostics، ووافق مرة واحدة، وشارك التقرير، ثم شغّل أمر codex resume <thread-id> المطبوع محليًا إذا أردت فحص السلسلة بنفسك. راجع بيئة Codex.

​
محتويات التصدير

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

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

يُحتفظ بما يلي: أسماء الأنظمة الفرعية، ومعرّفات Plugin، ومعرّفات المزوّدين، ومعرّفات القنوات، والأوضاع المُعدّة، ورموز الحالة، والمدد، وأعداد البايتات، وحالة قوائم الانتظار، وقراءات الذاكرة، وبيانات السجلات الوصفية المنقّحة، والرسائل التشغيلية المحجوبة، وبنية الإعدادات، وإعدادات الميزات غير السرية. يُحذف أو يُنقّح ما يلي: نصوص المحادثات، والمطالبات، والتعليمات، ومحتويات Webhook، ومخرجات الأدوات، وبيانات الاعتماد، ومفاتيح API، والرموز المميزة، وملفات تعريف الارتباط، والقيم السرية، والمحتويات الأولية للطلبات/الاستجابات، ومعرّفات الحسابات، ومعرّفات الرسائل، ومعرّفات الجلسات الأولية، وأسماء المضيفين، وأسماء المستخدمين المحليين. عندما تبدو رسالة سجل كنص حمولة لمستخدم أو محادثة أو مطالبة أو أداة، لا يحتفظ التصدير إلا بإشارة إلى حذف الرسالة وعدد بايتاتها.

​
مسجّل الاستقرار

يسجّل Gateway افتراضيًا تدفق استقرار محدودًا وخاليًا من الحمولات عندما تكون التشخيصات مفعّلة. وهو يلتقط الحقائق التشغيلية لا المحتوى. تأخذ إشارة Heartbeat نفسها أيضًا عينات من الحيوية عندما تبدو حلقة الأحداث أو وحدة المعالجة المركزية مشبعة، وتصدر أحداث diagnostic.liveness.warning التي تتضمن تأخر حلقة الأحداث، واستخدام حلقة الأحداث، ونسبة أنوية وحدة المعالجة المركزية، وأعداد الجلسات النشطة/المنتظرة/المصطفة، ومرحلة بدء التشغيل/وقت التشغيل الحالية (عندما تكون معروفة)، وفترات المراحل الحديثة، وتسميات العمل المحدودة. لا تتحول هذه إلى أسطر سجلات بمستوى warn في Gateway إلا عندما يكون هناك عمل منتظر أو مصطف، أو عندما يتزامن العمل النشط مع تأخر مستمر في حلقة الأحداث؛ وإلا فتُسجّل بالمستوى debug. تظل عينات الحيوية في حالة الخمول مسجّلة كأحداث تشخيصية، لكنها لا ترتقي إلى تحذير من تلقاء نفسها. تصدر مراحل بدء التشغيل أحداث diagnostic.phase.completed مع توقيت الساعة الفعلي وتوقيت وحدة المعالجة المركزية. وتضع تشخيصات التشغيل المضمّن المتوقف القيمة terminalProgressStale=true عندما يبدو آخر تقدم للجسر نهائيًا (مثل عنصر استجابة أولي أو حدث اكتمال استجابة)، لكن Gateway لا يزال يعتبر التشغيل المضمّن نشطًا. لفحص المسجّل المباشر:
لفحص أحدث حزمة محفوظة بعد خروج فادح أو انتهاء مهلة إيقاف التشغيل أو فشل بدء التشغيل بعد إعادة التشغيل:
لإنشاء ملف zip للتشخيصات من أحدث حزمة محفوظة:
توجد الحزم المحفوظة ضمن ~/.openclaw/logs/stability/ عند وجود أحداث.

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

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

تكون التشخيصات مفعّلة افتراضيًا. لتعطيل مسجّل الاستقرار وجمع أحداث التشخيص:
يقلل تعطيل التشخيصات من تفاصيل تقارير الأخطاء، ولا يؤثر في تسجيل Gateway المعتاد. تكون لقطات ضغط الذاكرة الحرج متوقفة افتراضيًا. لالتقاط لقطة الاستقرار السابقة لنفاد الذاكرة بالإضافة إلى أحداث التشخيصات المعتادة:
لا تستخدم هذا إلا على المضيفين القادرين على تحمّل الفحص الإضافي لنظام الملفات وكتابة اللقطة أثناء ضغط الذاكرة الحرج. تظل أحداث ضغط الذاكرة العادية تسجّل حقائق RSS والكومة والعتبة والنمو (rss_threshold، heap_threshold، وrss_growth) عندما تكون اللقطة متوقفة.

​
ذو صلة