---
read_when:
    - تصحيح أخطاء سبب ردّ وكيل أو فشله أو استدعائه للأدوات بطريقة معيّنة
    - تصدير حزمة دعم لجلسة OpenClaw
    - التحقيق في سياق الموجّه، واستدعاءات الأدوات، وأخطاء وقت التشغيل، أو بيانات تعريف الاستخدام
    - تعطيل التقاط المسار أو تغيير موقعه
summary: تصدير حزم المسارات المنقّحة لتصحيح أخطاء جلسة وكيل OpenClaw
title: حزم المسارات
x-i18n:
    generated_at: "2026-05-04T09:37:21Z"
    model: gpt-5.5
    provider: openai
    source_hash: b8b1256e52d27185a48ceddaf7937b4f37ad6d57d075fea0d0b6d3abb871f1d8
    source_path: tools/trajectory.md
    workflow: 16
---

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

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

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

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

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

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

```text
/export-trajectory
```

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

```text
/trajectory
```

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

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

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

```text
/export-trajectory bug-1234
```

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

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

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

```bash
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 مع وسم المخطط هذا:

```json
{
  "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` الملفات الموجودة في تلك الحزمة. تُحذف بعض الملفات
عندما لا تلتقط الجلسة بيانات التشغيل المقابلة.

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

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

```text
<session>.trajectory.jsonl
```

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

```text
<session>.trajectory-path.json
```

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

```bash
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
```

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

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

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

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

```bash
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/`

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

## ذات صلة

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