محرك السياق

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

يأتي OpenClaw مع محرك legacy مدمج ويستخدمه افتراضيًا - لا يحتاج معظم المستخدمين إلى تغيير ذلك. ثبّت محرك Plugin وحدده فقط عندما تريد سلوكًا مختلفًا للتجميع أو Compaction أو الاستدعاء عبر الجلسات.

البدء السريع

openclaw doctor# or inspect config directly:cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

openclaw plugins install @martian-engineering/lossless-claw

openclaw plugins install -l ./my-context-engine

// openclaw.json{  plugins: {    slots: {      contextEngine: "lossless-claw", // must match the plugin's registered engine id    },    entries: {      "lossless-claw": {        enabled: true,        // Plugin-specific config goes here (see the plugin's docs)      },    },  },}

كيف يعمل

في كل مرة يشغّل فيها OpenClaw مطالبة نموذج، يشارك محرك السياق في أربع نقاط من دورة الحياة:

بالنسبة إلى حزمة Codex غير ACP المضمّنة، يطبق OpenClaw دورة الحياة نفسها عبر إسقاط السياق المجمّع في تعليمات مطوّر Codex ومطالبة الدور الحالي. يظل Codex مالكًا لسجل المحادثة الأصلي وCompactor الأصلي الخاص به.

دورة حياة الوكيل الفرعي (اختياري)

يستدعي OpenClaw خطافي دورة حياة اختياريين للوكلاء الفرعيين:

إضافة مطالبة النظام

يمكن لطريقة assemble أن تعيد سلسلة systemPromptAddition. يضيف OpenClaw هذه السلسلة في بداية مطالبة النظام للتشغيل. يتيح ذلك للمحركات حقن إرشادات استدعاء ديناميكية، أو تعليمات استرجاع، أو تلميحات واعية بالسياق دون الحاجة إلى ملفات مساحة عمل ثابتة.

المحرك legacy

يحافظ المحرك legacy المدمج على السلوك الأصلي لـ OpenClaw:

• الإدخال: بلا إجراء (يتولى مدير الجلسة حفظ الرسائل مباشرة).
• التجميع: تمرير مباشر (يتولى خط sanitize → validate → limit الحالي في وقت التشغيل تجميع السياق).
• Compaction: يفوض إلى Compaction التلخيص المدمج، الذي ينشئ ملخصًا واحدًا للرسائل الأقدم ويحافظ على الرسائل الحديثة كما هي.
• بعد الدور: بلا إجراء.

لا يسجل المحرك legacy أدوات ولا يوفر systemPromptAddition.

عندما لا يتم تعيين plugins.slots.contextEngine (أو يكون معينًا إلى "legacy")، يُستخدم هذا المحرك تلقائيًا.

محركات Plugin

يمكن لـ Plugin تسجيل محرك سياق باستخدام واجهة Plugin API:

 export default function register(api) {  api.registerContextEngine("my-engine", (ctx) => ({    info: {      id: "my-engine",      name: "My Context Engine",      ownsCompaction: true,    },     async ingest({ sessionId, message, isHeartbeat }) {      // Store the message in your data store      return { ingested: true };    },     async assemble({ sessionId, messages, tokenBudget, availableTools, citationsMode }) {      // Return messages that fit the budget      return {        messages: buildContext(messages, tokenBudget),        estimatedTokens: countTokens(messages),        systemPromptAddition: buildMemorySystemPromptAddition({          availableTools: availableTools ?? new Set(),          citationsMode,        }),      };    },     async compact({ sessionId, force }) {      // Summarize older context      return { ok: true, compacted: true };    },  }));}

يتضمن المصنع ctx قيم config وagentDir وworkspaceDir الاختيارية حتى تتمكن Plugins من تهيئة حالة لكل وكيل أو لكل مساحة عمل قبل تشغيل أول خطاف في دورة الحياة.

ثم فعّله في الإعدادات:

{  plugins: {    slots: {      contextEngine: "my-engine",    },    entries: {      "my-engine": {        enabled: true,      },    },  },}

واجهة ContextEngine

الأعضاء المطلوبة:

تعيد assemble قيمة AssembleResult مع:

تعيد compact قيمة CompactResult. عندما تدوّر Compaction النص النشط، يحدد result.sessionId وresult.sessionFile الجلسة اللاحقة التي يجب أن تستخدمها إعادة المحاولة أو الدور التالي.

الأعضاء الاختيارية:

إعدادات وقت التشغيل

تتلقى خطافات دورة الحياة التي تعمل داخل OpenClaw كائن runtimeSettings اختياريًا. إنه سطح API داخلي للمنتج/المستهلك، بإصدارات وقراءة فقط: ينتجه OpenClaw لمحرك السياق المحدد، ويستهلكه محرك السياق داخل خطافات دورة الحياة. لا يُعرض مباشرة للمستخدمين ولا ينشئ سطحًا مخصصًا للتقارير.

• schemaVersion: حاليًا 1
• runtime: مضيف OpenClaw، وضع وقت التشغيل (normal أو fallback أو degraded)، ومعرّفات الحزمة/وقت التشغيل الاختيارية
• contextEngineSelection: معرّف محرك السياق المحدد ومصدر التحديد
• executionHost: معرّف المضيف وتسميته للسطح الذي يستدعي الخطاف
• model: النموذج المطلوب، والنموذج المحلول، والمزوّد، وعائلة النموذج الاختيارية
• limits: ميزانية رموز المطالبة والحد الأقصى لرموز الإخراج عند معرفتها
• diagnostics: رموز أسباب fallback وdegraded المغلقة عند معرفتها

تُمثل الحقول التي يمكن أن تكون غير معروفة بقيمة null؛ وتبقى حقول التمييز مثل وضع وقت التشغيل ومصدر التحديد غير قابلة للقيمة null. تظل المحركات الأقدم متوافقة: إذا رفض محرك legacy صارم runtimeSettings كخاصية غير معروفة، يعيد OpenClaw محاولة استدعاء دورة الحياة بدونها بدلًا من عزل المحرك.

متطلبات المضيف

يمكن لمحركات السياق إعلان متطلبات قدرات المضيف في info.hostRequirements. يفحص OpenClaw هذه المتطلبات قبل بدء العملية ويفشل مغلقًا مع خطأ وصفي عندما لا يستطيع وقت التشغيل المحدد تلبيتها.

لتشغيلات الوكيل، أعلن assemble-before-prompt عندما يجب أن يتحكم المحرك في مطالبة النموذج الفعلية عبر assemble():

info: {  id: "my-context-engine",  name: "My Context Engine",  hostRequirements: {    "agent-run": {      requiredCapabilities: ["assemble-before-prompt"],      unsupportedMessage:        "Use the native Codex or OpenClaw embedded runtime, or select the legacy context engine.",    },  },}

تلبي تشغيلات الوكيل الأصلية في Codex وOpenClaw المدمج assemble-before-prompt. أما خلفيات CLI العامة فلا تفعل ذلك، لذلك تُرفض المحركات التي تتطلبها قبل بدء عملية CLI.

عزل الفشل

يعزل OpenClaw محرك Plugin المحدد عن مسار الرد الأساسي. إذا كان محرك غير قديم مفقودًا، أو فشل في التحقق من العقد، أو رمى خطأ أثناء إنشاء المصنع، أو رمى خطأ من طريقة دورة حياة، يعزل OpenClaw ذلك المحرك لعملية Gateway الحالية ويخفض عمل محرك السياق إلى المحرك المدمج legacy. يُسجَّل الخطأ مع العملية الفاشلة حتى يتمكن المشغّل من إصلاح Plugin أو تحديثه أو تعطيله من دون أن يتوقف الوكيل عن الرد.

تختلف حالات فشل متطلبات المضيف: عندما يعلن محرك أن بيئة تشغيل تفتقر إلى قدرة مطلوبة، يفشل OpenClaw بإغلاق آمن قبل بدء التشغيل. وهذا يحمي المحركات التي قد تفسد الحالة إذا عملت في مضيف غير مدعوم.

ownsCompaction

يتحكم ownsCompaction فيما إذا كان الضغط التلقائي المدمج داخل المحاولة في وقت تشغيل OpenClaw يبقى مفعّلًا للتشغيل:

هذا يعني أن هناك نمطين صالحين للـ Plugin:

يُعد تنفيذ compact() الذي لا يفعل شيئًا غير آمن لمحرك نشط لا يمتلك الضغط، لأنه يعطّل مسار الضغط العادي لـ /compact واسترداد تجاوز السعة في خانة ذلك المحرك.

مرجع الإعداد

{  plugins: {    slots: {      // Select the active context engine. Default: "legacy".      // Set to a plugin id to use a plugin engine.      contextEngine: "legacy",    },  },}

العلاقة بالضغط والذاكرة

نصائح

• استخدم openclaw doctor للتحقق من أن محركك يُحمَّل بشكل صحيح.
• عند تبديل المحركات، تستمر الجلسات الحالية بسجلها الحالي. يتولى المحرك الجديد التشغيلات المستقبلية.
• تُسجَّل أخطاء المحرك ويُعزل محرك Plugin المحدد لعملية Gateway الحالية. يعود OpenClaw إلى legacy لدورات المستخدم حتى تستمر الردود، لكن ينبغي لك مع ذلك إصلاح Plugin المعطّل أو تحديثه أو تعطيله أو إلغاء تثبيته.
• للتطوير، استخدم openclaw plugins install -l ./my-engine لربط دليل Plugin محلي من دون نسخه.

ذو صلة

• Compaction - تلخيص المحادثات الطويلة
• السياق - كيف يُبنى السياق لدورات الوكيل
• بنية Plugin - تسجيل Plugins محرك السياق
• بيان Plugin - حقول بيان Plugin
• Plugins - نظرة عامة على Plugin