الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

  • /status → عرض سريع لـ “ما مدى امتلاء نافذتي؟” + إعدادات الجلسة.
  • /context list → ما الذي تم حقنه + الأحجام التقريبية (لكل ملف + الإجماليات).
  • /context detail → تفصيل أعمق: أحجام كل ملف، وأحجام مخططات كل أداة، وأحجام إدخالات كل Skill، وحجم موجّه النظام.
  • /context map → صورة خريطة شجرية بأسلوب WinDirStat لمساهمي السياق المتتبَّعين في الجلسة الحالية.
  • /usage tokens → إلحاق تذييل استخدام لكل رد بالردود العادية.
  • /compact → تلخيص السجل الأقدم في إدخال مضغوط لتحرير مساحة النافذة.
انظر أيضًا: أوامر الشرطة المائلة، استخدام الرموز والتكاليف، 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 + وقت المستخدم المحوَّل إذا تم تكوينه).
  • بيانات تعريف بيئة التشغيل (المضيف/نظام التشغيل/النموذج/التفكير).
  • ملفات تمهيد مساحة العمل المحقونة ضمن سياق المشروع.
التفصيل الكامل: موجّه النظام.

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

افتراضيًا، يحقن 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”)، وتُزال قبل أن يرى النموذج النص المتبقي.
التفاصيل: أوامر الشرطة المائلة.

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

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

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

يفضّل /context أحدث تقرير موجّه نظام مبني أثناء التشغيل عند توفره:
  • System prompt (run) = مُلتقط من آخر تشغيل مضمّن (قادر على استخدام الأدوات) ومُحفَظ في مخزن الجلسة.
  • System prompt (estimate) = محسوب فورًا عند عدم وجود تقرير تشغيل (أو عند التشغيل عبر خلفية CLI لا تولّد التقرير).
في كلتا الحالتين، يبلّغ عن الأحجام وأبرز المساهمين؛ ولا يفرغ موجّه النظام الكامل أو مخططات الأدوات.

ذات صلة

محرك السياق

حقن سياق مخصص عبر plugins.

Compaction

تلخيص المحادثات الطويلة لإبقائها داخل نافذة النموذج.

موجّه النظام

كيف يُبنى موجّه النظام وما الذي يحقنه في كل دور.

حلقة الوكيل

دورة تنفيذ الوكيل الكاملة من الرسالة الواردة إلى الرد النهائي.