​

محرك السياق

​

البدء السريع

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

​

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

# Install from npm
openclaw plugins install @martian-engineering/lossless-claw

# Or install from a local path (for development)
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)
      },
    },
  },
}

​

كيف يعمل

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

​

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

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

​

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

​

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

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

​

محركات plugin

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

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, 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 };
    },
  }));
}

{
  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: {
      // Select the active context engine. Default: "legacy".
      // Set to a plugin id to use a plugin engine.
      contextEngine: "legacy",
    },
  },
}

​

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

• الضغط هو إحدى مسؤوليات محرك السياق. يفوّض المحرك القديم إلى التلخيص المدمج في OpenClaw. ويمكن لمحركات plugin تنفيذ أي استراتيجية ضغط (ملخصات DAG، أو استرجاع متجهي، وما إلى ذلك).
• plugins الذاكرة (plugins.slots.memory) منفصلة عن محركات السياق. توفّر plugins الذاكرة البحث/الاسترجاع؛ بينما تتحكم محركات السياق فيما يراه النموذج. ويمكنهما العمل معًا — فقد يستخدم محرك سياق بيانات plugin الذاكرة أثناء التجميع. ويُفضّل أن تستخدم محركات plugin التي تريد مسار مطالبة الذاكرة النشط buildMemorySystemPromptAddition(...) من openclaw/plugin-sdk/core، إذ يحوّل مقاطع مطالبة الذاكرة النشطة إلى systemPromptAddition جاهزة للإضافة في البداية. وإذا احتاج المحرك إلى تحكم على مستوى أدنى، فلا يزال بإمكانه سحب الأسطر الخام من openclaw/plugin-sdk/memory-host-core عبر buildActiveMemoryPromptSection(...).
• تهذيب الجلسة (قص نتائج الأدوات القديمة داخل الذاكرة) يظل يعمل بغض النظر عن محرك السياق النشط.

​

نصائح

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

​

ذو صلة

• السياق — كيف يُبنى السياق لأدوار الوكيل
• معمارية Plugin — تسجيل plugins لمحرك السياق
• الضغط — تلخيص المحادثات الطويلة