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

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

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

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

openclaw gateway diagnostics export

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

openclaw gateway diagnostics export --output openclaw-diagnostics.zip

للأتمتة:

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 لتدفق عمل الفحص هذا.

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

يتضمن ملف zip:

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

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

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

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

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

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

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

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

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

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

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

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

افحص المسجل المباشر:

openclaw gateway stability
openclaw gateway stability --type payload.large
openclaw gateway stability --json

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

openclaw gateway stability --bundle latest

أنشئ ملف zip تشخيصات من أحدث حزمة مستمرة:

openclaw gateway stability --bundle latest --export

توجد الحزم المستمرة ضمن ~/.openclaw/logs/stability/ عند وجود أحداث.

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

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: اطبع بيانات تعريف التصدير القابلة للقراءة آليًا.

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

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

{
  diagnostics: {
    enabled: false,
  },
}

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

# ذات صلة

• فحوصات الصحة
• CLI الخاص بـ Gateway
• بروتوكول Gateway
• التسجيل
• تصدير OpenTelemetry — تدفق منفصل لبث التشخيصات إلى جامع