حزم المسارات

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

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

• ما الموجه، وموجه النظام، والأدوات التي أُرسلت إلى النموذج؟
• ما رسائل النص المسجل واستدعاءات الأدوات التي أدت إلى هذه الإجابة؟
• هل انتهى التشغيل بمهلة، أو أُجهض، أو خضع لـ Compaction، أو واجه خطأ من المزوّد؟
• ما النموذج، وPlugins، و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/. تُرفض المسارات المطلقة ومسارات ~.

يمكن أن تحتوي حزم المسار على موجهات، ورسائل نموذج، ومخططات أدوات، ونتائج أدوات، وأحداث وقت تشغيل، ومسارات محلية. لذلك يمر أمر الشرطة المائلة في الدردشة عبر موافقة exec في كل مرة. وافق على التصدير مرة واحدة عندما تقصد إنشاء الحزمة؛ لا تستخدم السماح للجميع. في الدردشات الجماعية، يرسل 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 مع وسم المخطط هذا:

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

ملفات الحزمة

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

يسرد 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 ملفات مسار وقت التشغيل الجانبية أثناء تنظيف الوكيل. مهلة التنظيف الافتراضية هي 10,000 ms. على الأقراص البطيئة أو المخازن الكبيرة، اضبط OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS قبل بدء OpenClaw:

export OPENCLAW_TRAJECTORY_FLUSH_TIMEOUT_MS=30000

يتحكم هذا في وقت تسجيل OpenClaw لمهلة openclaw-trajectory-flush ثم المتابعة. لا يغير هذا حدود حجم المسار. لضبط جميع خطوات تنظيف الوكيل التي لا تمرر مهلة صريحة، اضبط OPENCLAW_AGENT_CLEANUP_TIMEOUT_MS.

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

صُممت حزم المسار للدعم وتصحيح الأخطاء، وليس للنشر العام. ينقح 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/

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

ذو صلة

• الفروقات
• إدارة الجلسات
• أداة Exec