الانتقال إلى المحتوى الرئيسي

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 المحلية وحالة وقت التشغيل على مستوى المضيف.

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

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 تمهيد التشخيصات ويطلب موافقة exec صريحة واحدة. تشغل الموافقة openclaw gateway diagnostics export --json. لا توافق على التشخيصات عبر قاعدة سماح شاملة.
  3. بعد الموافقة، يرد OpenClaw بتقرير قابل للصق يحتوي على مسار الحزمة المحلي، وملخص البيان، وملاحظات الخصوصية، ومعرفات الجلسات ذات الصلة.
في الدردشات الجماعية، يظل بإمكان المالك تشغيل /diagnostics، لكن OpenClaw لا ينشر تفاصيل التشخيصات مرة أخرى في الدردشة المشتركة. يرسل التمهيد، ومطالبات الموافقة، ونتيجة تصدير Gateway، وتفصيل جلسة/سلسلة Codex إلى المالك عبر مسار الموافقة الخاص. لا تحصل المجموعة إلا على إشعار قصير بأن تدفق التشخيصات أُرسل بشكل خاص. إذا تعذر على OpenClaw العثور على مسار خاص للمالك، يفشل الأمر مغلقًا ويطلب من المالك تشغيله من رسالة مباشرة. عندما تستخدم جلسة OpenClaw النشطة حزمة OpenAI Codex الأصلية، تغطي موافقة exec نفسها أيضًا رفع ملاحظات 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 العادي.

​
ذات صلة