حزم المسارات

تسجيل المسار هو مسجّل الرحلة لكل جلسة في OpenClaw. يسجل خطًا زمنيًا منظمًا لكل تشغيل وكيل، ثم تحزم /export-trajectory الجلسة الحالية في حزمة دعم منقحة.

استخدمه عندما تحتاج إلى الإجابة عن أسئلة مثل:

• ما الموجه، وموجه النظام، والأدوات التي أُرسلت إلى النموذج؟
• أي رسائل في النص التفريغي واستدعاءات أدوات أدت إلى هذه الإجابة؟
• هل انتهى التشغيل بالمهلة، أو أُلغي، أو خضع إلى Compaction، أو واجه خطأ من المزوّد؟
• أي نموذج، وPlugin، وSkills، وإعدادات تشغيل كانت نشطة؟
• ما بيانات الاستخدام وبيانات وصفية لذاكرة التخزين المؤقت للموجه التي أعادها المزوّد؟

إذا كنت ترسل تقرير دعم واسعًا لمشكلة Gateway مباشرة، فابدأ بـ /diagnostics. تجمع التشخيصات حزمة Gateway المنقحة، وبالنسبة إلى جلسات بيئة تشغيل OpenAI Codex، يمكنها أيضًا إرسال تعليقات Codex إلى خوادم OpenAI بعد الموافقة. استخدم /export-trajectory عندما تحتاج تحديدًا إلى الخط الزمني التفصيلي لكل جلسة للموجهات والأدوات والنص التفريغي.

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

أرسل هذا في الجلسة النشطة:

/export-trajectory

الاسم المستعار:

/trajectory

يكتب OpenClaw الحزمة ضمن مساحة العمل:

.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/

يمكنك اختيار اسم دليل إخراج نسبي:

/export-trajectory bug-1234

يُحل المسار المخصص داخل .openclaw/trajectory-exports/. تُرفض المسارات المطلقة ومسارات ~.

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

بالنسبة إلى الفحص المحلي أو سير عمل الدعم، يمكنك أيضًا تشغيل مسار الأمر الموافق عليه مباشرة:

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .

# الوصول

تصدير المسار أمر للمالك. يجب أن يجتاز المرسل فحوصات تخويل الأوامر العادية وفحوصات المالك للقناة.

# ما الذي يُسجل

تسجيل المسار مفعّل افتراضيًا لتشغيلات وكيل OpenClaw.

تشمل أحداث التشغيل:

• session.started
• trace.metadata
• context.compiled
• prompt.submitted
• model.fallback_step، بما في ذلك نموذج المصدر، والنموذج التالي، وسبب/تفاصيل الفشل، وموضع السلسلة، وما إذا كان الرجوع الاحتياطي قد تقدم أو نجح أو استنفد السلسلة
• model.completed
• trace.artifacts
• session.ended

تُعاد أيضًا بنية أحداث النص التفريغي من فرع الجلسة النشط:

• رسائل المستخدم
• رسائل المساعد
• استدعاءات الأدوات
• نتائج الأدوات
• عمليات Compaction
• تغييرات النموذج
• التسميات وإدخالات الجلسة المخصصة

تُكتب الأحداث بصيغة JSON Lines مع وسم المخطط هذا:

{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

# ملفات الحزمة

يمكن أن تحتوي الحزمة المصدّرة على:

الملف	المحتويات
manifest.json	مخطط الحزمة، وملفات المصدر، وعدّادات الأحداث، وقائمة الملفات المولدة
events.jsonl	الخط الزمني المرتب للتشغيل والنص التفريغي
session-branch.json	فرع النص التفريغي النشط المنقح وترويسة الجلسة
metadata.json	إصدار OpenClaw، ونظام التشغيل/بيئة التشغيل، والنموذج، ولقطة الإعدادات، وPlugin، وSkills، وبيانات وصفية للموجه
artifacts.json	الحالة النهائية، والأخطاء، والاستخدام، وذاكرة التخزين المؤقت للموجه، وعدّ Compaction، ونص المساعد، وبيانات وصفية للأدوات
prompts.json	الموجهات المرسلة وتفاصيل مختارة لبناء الموجه
system-prompt.txt	أحدث موجه نظام مجمع، عند التقاطه
tools.json	تعريفات الأدوات المرسلة إلى النموذج، عند التقاطها

يسرد manifest.json الملفات الموجودة في تلك الحزمة. تُحذف بعض الملفات عندما لا تلتقط الجلسة بيانات التشغيل المقابلة.

# موقع الالتقاط

افتراضيًا، تُكتب أحداث مسار التشغيل بجانب ملف الجلسة:

<session>.trajectory.jsonl

يكتب OpenClaw أيضًا ملف مؤشر بأفضل جهد بجانب الجلسة:

<session>.trajectory-path.json

اضبط OPENCLAW_TRAJECTORY_DIR لتخزين ملفات مسار التشغيل الجانبية في دليل مخصص:

export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories

عند ضبط هذا المتغير، يكتب OpenClaw ملف JSONL واحدًا لكل معرف جلسة في ذلك الدليل.

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

# تعطيل الالتقاط

اضبط OPENCLAW_TRAJECTORY=0 قبل بدء OpenClaw:

export OPENCLAW_TRAJECTORY=0

يعطل هذا تسجيل مسار التشغيل. لا يزال بإمكان /export-trajectory تصدير فرع النص التفريغي، لكن قد تكون الملفات الخاصة بالتشغيل فقط، مثل السياق المجمع، ومخرجات المزوّد، والبيانات الوصفية للموجه، مفقودة.

# الخصوصية والحدود

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

• بيانات الاعتماد وحقول الحمولة المعروفة بأنها شبيهة بالأسرار
• بيانات الصور
• مسارات الحالة المحلية
• مسارات مساحة العمل، مستبدلة بـ $WORKSPACE_DIR
• مسارات الدليل الرئيسي، عند اكتشافها

يحدّ المصدّر أيضًا حجم الإدخال:

• ملفات التشغيل الجانبية: يتوقف الالتقاط المباشر عند 10 MiB ويسجل حدث اقتطاع عندما تبقى مساحة؛ يقبل التصدير ملفات التشغيل الجانبية الموجودة حتى 50 MiB
• ملفات الجلسات: 50 MiB
• أحداث التشغيل: 200,000
• إجمالي الأحداث المصدّرة: 250,000
• تُقتطع أسطر أحداث التشغيل الفردية فوق 256 KiB

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

# استكشاف الأخطاء وإصلاحها

إذا لم يتضمن التصدير أي أحداث تشغيل:

• تأكد من أن OpenClaw بدأ من دون OPENCLAW_TRAJECTORY=0
• تحقق مما إذا كان OPENCLAW_TRAJECTORY_DIR يشير إلى دليل قابل للكتابة
• شغّل رسالة أخرى في الجلسة، ثم صدّر مرة أخرى
• افحص manifest.json بحثًا عن runtimeEventCount

إذا رفض الأمر مسار الإخراج:

• استخدم اسمًا نسبيًا مثل bug-1234
• لا تمرر /tmp/... أو ~/...
• أبقِ التصدير داخل .openclaw/trajectory-exports/

إذا فشل التصدير بسبب خطأ في الحجم، فهذا يعني أن الجلسة أو الملف الجانبي تجاوز حدود أمان التصدير. ابدأ جلسة جديدة أو صدّر إعادة إنتاج أصغر.

# ذات صلة

• الفروقات
• إدارة الجلسات
• أداة التنفيذ