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

بداية سريعة

openclaw gateway diagnostics export
يطبع الأمر مسار ملف zip المكتوب. لاختيار مسار محدد:
openclaw gateway diagnostics export --output openclaw-diagnostics.zip
للأتمتة:
openclaw gateway diagnostics export --json

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

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

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

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

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

تسجّل 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 لـ Gateway WebSocket لالتقاط لقطات الحالة والسلامة.
  • --token <token>: رمز Gateway المميز لالتقاط لقطات الحالة والسلامة.
  • --password <password>: كلمة مرور Gateway لالتقاط لقطات الحالة والسلامة.
  • --timeout <ms>: مهلة لقطة الحالة والسلامة.
  • --no-stability-bundle: تخطي البحث عن حزمة الاستقرار المحفوظة.
  • --json: طباعة بيانات تعريف التصدير بشكل قابل للقراءة آليًا.

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

تكون التشخيصات مفعّلة افتراضيًا. ولتعطيل مسجل الاستقرار وجمع أحداث التشخيص:
{
  diagnostics: {
    enabled: false,
  },
}
يؤدي تعطيل التشخيصات إلى تقليل تفاصيل تقارير الأخطاء. ولا يؤثر ذلك في تسجيل Gateway العادي.

وثائق ذات صلة