---
read_when:
    - تريد فهم معنى "السياق" في OpenClaw
    - أنت تستكشف سبب "معرفة" النموذج شيئًا ما (أو نسيانه له)
    - تريد تقليل عبء السياق (/context, /status, /compact)
summary: 'السياق: ما يراه النموذج، وكيفية بنائه، وكيفية فحصه'
title: السياق
x-i18n:
    generated_at: "2026-05-10T19:33:36Z"
    model: gpt-5.5
    provider: openai
    source_hash: dc2dae290e63f82111d865ae066567ef58ec3f48eb62b409b76ee9e6ff65d696
    source_path: concepts/context.md
    workflow: 16
---

"السياق" هو **كل ما يرسله OpenClaw إلى النموذج للتشغيل**. وهو محدود بـ **نافذة السياق** الخاصة بالنموذج (حد الرموز).

نموذج ذهني للمبتدئين:

- **موجّه النظام** (يبنيه OpenClaw): القواعد، والأدوات، وقائمة Skills، والوقت/بيئة التشغيل، وملفات مساحة العمل المحقونة.
- **سجل المحادثة**: رسائلك + رسائل المساعد لهذه الجلسة.
- **استدعاءات/نتائج الأدوات + المرفقات**: خرج الأوامر، وقراءات الملفات، والصور/الصوت، وما إلى ذلك.

السياق _ليس الشيء نفسه_ مثل "الذاكرة": يمكن تخزين الذاكرة على القرص وإعادة تحميلها لاحقًا؛ أما السياق فهو ما يوجد داخل النافذة الحالية للنموذج.

## البدء السريع (فحص السياق)

- `/status` → عرض سريع لـ "ما مدى امتلاء نافذتي؟" + إعدادات الجلسة.
- `/context list` → ما الذي تم حقنه + الأحجام التقريبية (لكل ملف + الإجماليات).
- `/context detail` → تفصيل أعمق: أحجام كل ملف، وأحجام مخططات كل أداة، وأحجام إدخالات كل Skill، وحجم موجّه النظام.
- `/context map` → صورة خريطة شجرية بأسلوب WinDirStat لمساهمي السياق المتتبَّعين في الجلسة الحالية.
- `/usage tokens` → إلحاق تذييل استخدام لكل رد بالردود العادية.
- `/compact` → تلخيص السجل الأقدم في إدخال مضغوط لتحرير مساحة النافذة.

انظر أيضًا: [أوامر الشرطة المائلة](/ar/tools/slash-commands)، [استخدام الرموز والتكاليف](/ar/reference/token-use)، [Compaction](/ar/concepts/compaction).

## مثال على الخرج

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

### `/context list`

```
🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,000 chars
Sandbox: mode=non-main sandboxed=false
System prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok))

Injected workspace files:
- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)
- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)
- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)
- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)
- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)
- HEARTBEAT.md: MISSING | raw 0 | injected 0
- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok)

Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)
Tools: read, edit, write, exec, process, browser, message, sessions_send, …
Tool list (system prompt text): 1,032 chars (~258 tok)
Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)
Tools: (same as above)

Session tokens (cached): 14,250 total / ctx=32,000
```

### `/context detail`

```
🧠 Context breakdown (detailed)
…
Top skills (prompt entry size):
- frontend-design: 412 chars (~103 tok)
- oracle: 401 chars (~101 tok)
… (+10 more skills)

Top tools (schema size):
- browser: 9,812 chars (~2,453 tok)
- exec: 6,240 chars (~1,560 tok)
… (+N more tools)
```

### `/context map`

يرسل صورة مولَّدة من أحدث تقرير تشغيل مخزَّن مؤقتًا. قبل أن تنتج رسالة عادية تقرير تشغيل في الجلسة، يعيد `/context map` رسالة تفيد بعدم التوفر بدلًا من عرض تقدير. تتناسب مساحة المستطيل مع أحرف الموجّه المتتبَّعة:

- ملفات مساحة العمل المحقونة
- نص موجّه النظام الأساسي
- إدخالات موجّه Skills
- مخططات JSON للأدوات

لا يزال بإمكان `/context list` و`/context detail` و`/context json` فحص تقدير عند الطلب عند عدم وجود تقرير تشغيل مخزَّن مؤقتًا.

## ما الذي يُحتسب ضمن نافذة السياق

كل ما يتلقاه النموذج يُحتسب، بما في ذلك:

- موجّه النظام (كل الأقسام).
- سجل المحادثة.
- استدعاءات الأدوات + نتائج الأدوات.
- المرفقات/النصوص المفروغة (الصور/الصوت/الملفات).
- ملخصات Compaction وآثار التقليم.
- "أغلفة" المزوّد أو الترويسات المخفية (غير مرئية، لكنها لا تزال تُحتسب).

## كيف يبني OpenClaw موجّه النظام

موجّه النظام **مملوك لـ OpenClaw** ويُعاد بناؤه في كل تشغيل. يتضمن:

- قائمة الأدوات + أوصافًا قصيرة.
- قائمة Skills (البيانات الوصفية فقط؛ انظر أدناه).
- موقع مساحة العمل.
- الوقت (UTC + وقت المستخدم المحوَّل إذا تم تكوينه).
- بيانات تعريف بيئة التشغيل (المضيف/نظام التشغيل/النموذج/التفكير).
- ملفات تمهيد مساحة العمل المحقونة ضمن **سياق المشروع**.

التفصيل الكامل: [موجّه النظام](/ar/concepts/system-prompt).

## ملفات مساحة العمل المحقونة (سياق المشروع)

افتراضيًا، يحقن OpenClaw مجموعة ثابتة من ملفات مساحة العمل (إذا كانت موجودة):

- `AGENTS.md`
- `SOUL.md`
- `TOOLS.md`
- `IDENTITY.md`
- `USER.md`
- `HEARTBEAT.md`
- `BOOTSTRAP.md` (التشغيل الأول فقط)

تُقتطع الملفات الكبيرة لكل ملف باستخدام `agents.defaults.bootstrapMaxChars` (الافتراضي `12000` حرفًا). يفرض OpenClaw أيضًا حدًا أقصى إجماليًا لحقن التمهيد عبر الملفات باستخدام `agents.defaults.bootstrapTotalMaxChars` (الافتراضي `60000` حرفًا). يعرض `/context` أحجام **الخام مقابل المحقون** وما إذا حدث اقتطاع.

عند حدوث الاقتطاع، يمكن لبيئة التشغيل حقن كتلة تحذير داخل الموجّه ضمن سياق المشروع. كوّن ذلك باستخدام `agents.defaults.bootstrapPromptTruncationWarning` (`off`، `once`، `always`؛ الافتراضي `once`).

## Skills: المحقونة مقابل المحمَّلة عند الطلب

يتضمن موجّه النظام **قائمة Skills** مضغوطة (الاسم + الوصف + الموقع). لهذه القائمة كلفة فعلية.

لا تُضمَّن تعليمات Skill _افتراضيًا_. يُتوقع من النموذج أن يستخدم `read` لقراءة `SKILL.md` الخاصة بالـ Skill **عند الحاجة فقط**.

## الأدوات: هناك كلفتان

تؤثر الأدوات في السياق بطريقتين:

1. **نص قائمة الأدوات** في موجّه النظام (ما تراه باسم "الأدوات").
2. **مخططات الأدوات** (JSON). تُرسل هذه إلى النموذج كي يتمكن من استدعاء الأدوات. وهي تُحتسب ضمن السياق رغم أنك لا تراها كنص عادي.

يفصّل `/context detail` أكبر مخططات الأدوات حتى تتمكن من رؤية ما يهيمن على الحجم.

## الأوامر، والتوجيهات، و"الاختصارات المضمّنة"

تتعامل Gateway مع أوامر الشرطة المائلة. هناك عدة سلوكيات مختلفة:

- **الأوامر المستقلة**: الرسالة التي تكون فقط `/...` تُشغَّل كأمر.
- **التوجيهات**: تُزال `/think` و`/verbose` و`/trace` و`/reasoning` و`/elevated` و`/model` و`/queue` قبل أن يرى النموذج الرسالة.
  - رسائل التوجيه فقط تُبقي إعدادات الجلسة.
  - التوجيهات المضمّنة في رسالة عادية تعمل كتلميحات خاصة بتلك الرسالة.
- **الاختصارات المضمّنة** (للمرسلين المدرجين في قائمة السماح فقط): يمكن لبعض رموز `/...` داخل رسالة عادية أن تُشغَّل فورًا (مثال: "مرحبًا /status")، وتُزال قبل أن يرى النموذج النص المتبقي.

التفاصيل: [أوامر الشرطة المائلة](/ar/tools/slash-commands).

## الجلسات، وCompaction، والتقليم (ما الذي يستمر)

ما يستمر عبر الرسائل يعتمد على الآلية:

- **السجل العادي** يستمر في نص الجلسة حتى يتم ضغطه/تقليمه حسب السياسة.
- **Compaction** يحفظ ملخصًا في النص ويبقي الرسائل الحديثة كما هي.
- **التقليم** يسقط نتائج الأدوات القديمة من الموجّه _الموجود في الذاكرة_ لتحرير مساحة نافذة السياق، لكنه لا يعيد كتابة نص الجلسة - فلا يزال السجل الكامل قابلًا للفحص على القرص.

المستندات: [الجلسة](/ar/concepts/session)، [Compaction](/ar/concepts/compaction)، [تقليم الجلسة](/ar/concepts/session-pruning).

افتراضيًا، يستخدم OpenClaw محرك السياق المدمج `legacy` للتجميع وCompaction. إذا ثبّت Plugin يوفّر `kind: "context-engine"` واخترته باستخدام `plugins.slots.contextEngine`، يفوّض OpenClaw تجميع السياق، و`/compact`، وخطافات دورة حياة سياق الوكيل الفرعي ذات الصلة إلى ذلك المحرك بدلًا من ذلك. لا يؤدي `ownsCompaction: false` إلى رجوع تلقائي إلى محرك `legacy`؛ فلا يزال يجب على المحرك النشط تنفيذ `compact()` بشكل صحيح. راجع [محرك السياق](/ar/concepts/context-engine) للاطلاع على الواجهة القابلة للتوصيل الكاملة، وخطافات دورة الحياة، والتكوين.

## ما الذي يبلّغ عنه `/context` فعليًا

يفضّل `/context` أحدث تقرير موجّه نظام **مبني أثناء التشغيل** عند توفره:

- `System prompt (run)` = مُلتقط من آخر تشغيل مضمّن (قادر على استخدام الأدوات) ومُحفَظ في مخزن الجلسة.
- `System prompt (estimate)` = محسوب فورًا عند عدم وجود تقرير تشغيل (أو عند التشغيل عبر خلفية CLI لا تولّد التقرير).

في كلتا الحالتين، يبلّغ عن الأحجام وأبرز المساهمين؛ ولا **يفرغ** موجّه النظام الكامل أو مخططات الأدوات.

## ذات صلة

<CardGroup cols={2}>
  <Card title="محرك السياق" href="/ar/concepts/context-engine" icon="puzzle-piece">
    حقن سياق مخصص عبر plugins.
  </Card>
  <Card title="Compaction" href="/ar/concepts/compaction" icon="compress">
    تلخيص المحادثات الطويلة لإبقائها داخل نافذة النموذج.
  </Card>
  <Card title="موجّه النظام" href="/ar/concepts/system-prompt" icon="message-lines">
    كيف يُبنى موجّه النظام وما الذي يحقنه في كل دور.
  </Card>
  <Card title="حلقة الوكيل" href="/ar/concepts/agent-loop" icon="arrows-rotate">
    دورة تنفيذ الوكيل الكاملة من الرسالة الواردة إلى الرد النهائي.
  </Card>
</CardGroup>
