محرك السياق

يعالج محرك السياق كيفية بناء 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 يملك سجل السلسلة الأصلي والضاغط الأصلي الخاصين به.

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

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

# إضافة موجه النظام

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

# محرك legacy

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

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

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

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

# محركات Plugin

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

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 جلسة الخلف التي يجب أن تستخدمها المحاولة التالية أو الدور التالي.

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

# ownsCompaction

يتحكم ownsCompaction فيما إذا كان Compaction التلقائي المدمج داخل محاولة Pi يبقى مفعلا للتشغيل:

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

إن compact() الذي لا يفعل شيئا غير آمن لمحرك نشط غير مالك، لأنه يعطل مسار /compact وCompaction استعادة تجاوز السعة الطبيعيين لفتحة ذلك المحرك.

# مرجع الإعدادات

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

# العلاقة بـ Compaction والذاكرة

# نصائح

• استخدم openclaw doctor للتحقق من أن محركك يُحمَّل بشكل صحيح.
• عند تبديل المحركات، تواصل الجلسات الحالية العمل بسجلها الحالي. يتولى المحرك الجديد التشغيل في الجولات المستقبلية.
• تُسجل أخطاء المحرك وتظهر في التشخيصات. إذا فشل محرك Plugin في التسجيل أو تعذّر حل معرف المحرك المحدد، لا يعود OpenClaw تلقائيًا إلى البديل؛ تفشل الجولات حتى تصلح Plugin أو تعيد تبديل plugins.slots.contextEngine إلى "legacy".
• لأغراض التطوير، استخدم openclaw plugins install -l ./my-engine لربط دليل Plugin محلي دون نسخه.

# ذات صلة

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