الأساسيات

السياق

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

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

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

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

  • /status → عرض سريع "كم هي ممتلئة نافذتي؟" + إعدادات الجلسة.
  • /context list → ما تم حقنه + الأحجام التقريبية (لكل ملف + الإجماليات).
  • /context detail → تفصيل أعمق: لكل ملف، أحجام مخططات الأدوات، أحجام إدخالات المهارات، وحجم موجه النظام.
  • /usage tokens → إلحاق تذييل استخدام لكل رد بالردود العادية.
  • /compact → تلخيص السجل القديم في إدخال مضغوط لتحرير مساحة النافذة.

انظر أيضًا: أوامر الشرطة المائلة، استخدام الرموز المميزة والتكاليف، الضغط.

مثال على الناتج

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

/context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 20,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)

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

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

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

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

موجه النظام مملوك لـ OpenClaw ويتم إعادة بنائه في كل تشغيل. وهو يتضمن:

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

التفصيل الكامل: موجه النظام.

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

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

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

يتم اقتطاع الملفات الكبيرة لكل ملف باستخدام agents.defaults.bootstrapMaxChars (الافتراضي 20000 حرف). يفرض OpenClaw أيضًا حدًا إجماليًا لحقن التمهيد عبر الملفات باستخدام agents.defaults.bootstrapTotalMaxChars (الافتراضي 150000 حرف). يُظهر /context الأحجام الخام مقابل المحقونة وما إذا حدث اقتطاع. عند حدوث الاقتطاع، يمكن لوقت التشغيل حقن كتلة تحذير ضمن الموجه تحت سياق المشروع. قم بتكوين هذا باستخدام agents.defaults.bootstrapPromptTruncationWarning (off, once, always; الافتراضي once).

المهارات: ما يتم حقنه مقابل ما يتم تحميله عند الطلب

يتضمن موجه النظام قائمة مهارات مضغوطة (الاسم + الوصف + الموقع). لهذه القائمة تكلفة حقيقية. تعليمات المهارات غير مُضمنة بشكل افتراضي. من المتوقع أن يقوم النموذج بـ قراءة ملف SKILL.md الخاص بالمهارة فقط عند الحاجة.

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

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

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

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

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

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

  • أوامر مستقلة: الرسالة التي تكون فقط /... تعمل كأمر.
  • التوجيهات: /think, /verbose, /reasoning, /elevated, /model, /queue يتم إزالتها قبل أن يرى النموذج الرسالة.
    • الرسائل التي تحتوي على توجيهات فقط تحافظ على إعدادات الجلسة.
    • التوجيهات المضمنة في رسالة عادية تعمل كتلميحات لكل رسالة.
  • الاختصارات المضمنة (المرسلون المسموح لهم فقط): يمكن لبعض الرموز /... داخل رسالة عادية أن تعمل فورًا (مثال: "مرحبًا /status")، ويتم إزالتها قبل أن يرى النموذج النص المتبقي.

التفاصيل: أوامر الشرطة المائلة.

الجلسات، الضغط، والتقليم (ما يبقى)

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

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

الوثائق: الجلسة، الضغط، تقليم الجلسة. بشكل افتراضي، يستخدم OpenClaw محرك السياق المدمج legacy للتجميع والضغط. إذا قمت بتثبيت مكون إضافي يوفر kind: "context-engine" واخترته باستخدام plugins.slots.contextEngine، فإن OpenClaw يفوض تجميع السياق، /compact، وخطافات دورة حياة السياق الخاصة بالوكيل الفرعي إلى ذلك المحرك بدلاً من ذلك.

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

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

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

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

موجه النظاممساحة عمل الوكيل