​

Context Engine

​

البدء السريع

openclaw doctor
# أو افحص التكوين مباشرة:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

تثبيت plugin لمحرك سياق

# التثبيت من npm
openclaw plugins install @martian-engineering/lossless-claw

# أو التثبيت من مسار محلي (للتطوير)
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // يجب أن يطابق معرّف المحرك المسجل في plugin
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // يذهب هنا التكوين الخاص بـ plugin (راجع وثائق plugin)
      },
    },
  },
}

​

كيف يعمل

1. Ingest — يُستدعى عند إضافة رسالة جديدة إلى الجلسة. يمكن للمحرك تخزين الرسالة أو فهرستها في مخزن البيانات الخاص به.
2. Assemble — يُستدعى قبل كل تشغيل للنموذج. يعيد المحرك مجموعة مرتبة من الرسائل (وsystemPromptAddition اختياريًا) تتلاءم مع ميزانية الرموز.
3. Compact — يُستدعى عندما تمتلئ نافذة السياق، أو عندما يشغّل المستخدم /compact. يقوم المحرك بتلخيص السجل الأقدم لتحرير مساحة.
4. After turn — يُستدعى بعد اكتمال التشغيل. يمكن للمحرك حفظ الحالة، أو تشغيل ضغط في الخلفية، أو تحديث الفهارس.

​

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

• onSubagentEnded — تنظيف عند اكتمال جلسة وكيل فرعي أو عند إزالتها.

​

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

​

المحرك القديم

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

​

محركات plugin

export default function register(api) {
  api.registerContextEngine("my-engine", () => ({
    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 }) {
      // Return messages that fit the budget
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    async compact({ sessionId, force }) {
      // Summarize older context
      return { ok: true, compacted: true };
    },
  }));
}

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

​

واجهة ContextEngine

• messages — الرسائل المرتبة التي سيتم إرسالها إلى النموذج.
• estimatedTokens ‏(مطلوب، number) — تقدير المحرك لإجمالي الرموز في السياق المجمع. يستخدم OpenClaw هذا لاتخاذ قرارات حدود الضغط ولإعداد تقارير التشخيص.
• systemPromptAddition ‏(اختياري، string) — يُضاف في مقدمة مطالبة النظام.

​

ownsCompaction

• true — يمتلك المحرك سلوك الضغط. يعطّل OpenClaw الضغط التلقائي المدمج في Pi لذلك التشغيل، ويصبح تنفيذ compact() الخاص بالمحرك مسؤولًا عن /compact، وضغط استعادة تجاوز السعة، وأي ضغط استباقي يريد تنفيذه في afterTurn().
• false أو غير معيّن — قد يستمر الضغط التلقائي المدمج في Pi أثناء تنفيذ المطالبة، لكن تظل طريقة compact() الخاصة بالمحرك النشط تُستدعى من أجل /compact واستعادة تجاوز السعة.

• وضع التملك — نفّذ خوارزمية الضغط الخاصة بك واضبط ownsCompaction: true.
• وضع التفويض — اضبط ownsCompaction: false واجعل compact() تستدعي delegateCompactionToRuntime(...) من openclaw/plugin-sdk/core لاستخدام سلوك الضغط المدمج في OpenClaw.

​

مرجع التكوين

{
  plugins: {
    slots: {
      // حدد محرك السياق النشط. الافتراضي: "legacy".
      // اضبطه على معرّف plugin لاستخدام محرك plugin.
      contextEngine: "legacy",
    },
  },
}

​

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

• الضغط هو إحدى مسؤوليات محرك السياق. يفوض المحرك القديم إلى التلخيص المدمج في OpenClaw. ويمكن لمحركات plugin تنفيذ أي استراتيجية ضغط (ملخصات DAG، أو استدعاء vector، وما إلى ذلك).
• Plugins الذاكرة (plugins.slots.memory) منفصلة عن محركات السياق. توفر Plugins الذاكرة البحث/الاستدعاء؛ بينما تتحكم محركات السياق فيما يراه النموذج. ويمكنهما العمل معًا — فقد يستخدم محرك السياق بيانات plugin الذاكرة أثناء التجميع.
• يظل تشذيب الجلسة (قص نتائج الأدوات القديمة في الذاكرة) يعمل بغض النظر عن محرك السياق النشط.

​

نصائح

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

​

ذو صلة

• السياق — كيفية بناء السياق لأدوار الوكيل
• بنية plugin — تسجيل Plugins لمحركات السياق
• الضغط — تلخيص المحادثات الطويلة