> ## 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. يسجل خطًا زمنيًا
منظمًا لكل تشغيل وكيل، ثم تحزم `/export-trajectory` الجلسة الحالية في
حزمة دعم منقحة.

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

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

إذا كنت تقدم تقرير دعم واسعًا لمشكلة Gateway مباشرة، فابدأ بـ
[`/diagnostics`](/ar/gateway/diagnostics#chat-command). تجمع التشخيصات حزمة
Gateway المنقحة، وبالنسبة لجلسات أداة OpenAI Codex، يمكنها أيضًا إرسال
ملاحظات Codex إلى خوادم OpenAI بعد الموافقة. استخدم `/export-trajectory` عندما
تحتاج تحديدًا إلى الخط الزمني المفصل للموجهات، والأدوات، والنص المسجل لكل جلسة.

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

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/export-trajectory
```

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/trajectory
```

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
```

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
/export-trajectory bug-1234
```

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 مع وسم المخطط هذا:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}
```

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

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

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

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

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

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
<session>.trajectory.jsonl
```

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

```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
<session>.trajectory-path.json
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
```

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export OPENCLAW_TRAJECTORY=0
```

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

## ضبط مهلة التفريغ

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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/`

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

## ذو صلة

* [الفروقات](/ar/tools/diffs)
* [إدارة الجلسات](/ar/concepts/session)
* [أداة Exec](/ar/tools/exec)