​

Context Engine

​

Hızlı başlangıç

openclaw doctor
# veya yapılandırmayı doğrudan inceleyin:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

​

Bir bağlam motoru eklentisi yükleme

# npm'den yükleyin
openclaw plugins install @martian-engineering/lossless-claw

# Veya yerel bir yoldan yükleyin (geliştirme için)
openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // eklentinin kaydettiği motor kimliğiyle eşleşmelidir
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Eklentiye özgü yapılandırma buraya gelir (eklentinin belgelerine bakın)
      },
    },
  },
}

​

Nasıl çalışır

1. Ingest — oturuma yeni bir mesaj eklendiğinde çağrılır. Motor, mesajı kendi veri deposunda saklayabilir veya indeksleyebilir.
2. Assemble — her model çalıştırmasından önce çağrılır. Motor, belirteç bütçesine sığan sıralı bir mesaj kümesi (ve isteğe bağlı bir systemPromptAddition) döndürür.
3. Compact — bağlam penceresi dolduğunda veya kullanıcı /compact çalıştırdığında çağrılır. Motor, yer açmak için eski geçmişi özetler.
4. After turn — bir çalıştırma tamamlandıktan sonra çağrılır. Motor durumu kalıcı hale getirebilir, arka plan sıkıştırmasını tetikleyebilir veya indeksleri güncelleyebilir.

​

Alt ajan yaşam döngüsü (isteğe bağlı)

• onSubagentEnded — bir alt ajan oturumu tamamlandığında veya temizlendiğinde temizleme yapar.

​

Sistem istemi eklemesi

​

Legacy motoru

• Ingest: işlem yok (mesaj kalıcılığını doğrudan oturum yöneticisi işler).
• Assemble: olduğu gibi geçirme (çalışma zamanındaki mevcut sanitize → validate → limit işlem hattı bağlam oluşturmayı işler).
• Compact: yerleşik özetleme sıkıştırmasına devreder; bu işlem eski mesajların tek bir özetini oluşturur ve son mesajları olduğu gibi tutar.
• After turn: işlem yok.

​

Eklenti motorları

export default function register(api) {
  api.registerContextEngine("my-engine", () => ({
    info: {
      id: "my-engine",
      name: "My Context Engine",
      ownsCompaction: true,
    },

    async ingest({ sessionId, message, isHeartbeat }) {
      // Mesajı veri deponuzda saklayın
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget }) {
      // Bütçeye sığan mesajları döndürün
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: "Use lcm_grep to search history...",
      };
    },

    async compact({ sessionId, force }) {
      // Eski bağlamı özetleyin
      return { ok: true, compacted: true };
    },
  }));
}

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

​

ContextEngine arayüzü

• messages — modele gönderilecek sıralı mesajlar.
• estimatedTokens (zorunlu, number) — motorun oluşturulan bağlamdaki toplam belirteç sayısı tahmini. OpenClaw bunu sıkıştırma eşiği kararları ve tanılama raporlaması için kullanır.
• systemPromptAddition (isteğe bağlı, string) — sistem isteminin başına eklenir.

​

ownsCompaction

• true — sıkıştırma davranışı motora aittir. OpenClaw, o çalıştırma için Pi’nin yerleşik otomatik sıkıştırmasını devre dışı bırakır ve motorun compact() uygulaması /compact, taşma kurtarma sıkıştırması ve afterTurn() içinde yapmak istediği proaktif sıkıştırmadan sorumlu olur.
• false veya ayarlanmamış — Pi’nin yerleşik otomatik sıkıştırması istem yürütme sırasında yine de çalışabilir, ancak etkin motorun compact() yöntemi /compact ve taşma kurtarma için yine çağrılır.

• Sahiplenen mod — kendi sıkıştırma algoritmanızı uygulayın ve ownsCompaction: true ayarlayın.
• Devreden mod — ownsCompaction: false ayarlayın ve OpenClaw’ın yerleşik sıkıştırma davranışını kullanmak için compact() içinde openclaw/plugin-sdk/core içinden delegateCompactionToRuntime(...) çağırın.

​

Yapılandırma başvurusu

{
  plugins: {
    slots: {
      // Etkin bağlam motorunu seçin. Varsayılan: "legacy".
      // Bir eklenti motoru kullanmak için bunu bir eklenti kimliğine ayarlayın.
      contextEngine: "legacy",
    },
  },
}

​

Sıkıştırma ve bellekle ilişkisi

• Sıkıştırma, bağlam motorunun sorumluluklarından biridir. Legacy motoru OpenClaw’ın yerleşik özetlemesine devreder. Eklenti motorları herhangi bir sıkıştırma stratejisini uygulayabilir (DAG özetleri, vektör geri getirme vb.).
• Bellek eklentileri (plugins.slots.memory) bağlam motorlarından ayrıdır. Bellek eklentileri arama/geri getirme sağlar; bağlam motorları modelin ne gördüğünü kontrol eder. Birlikte çalışabilirler — bir bağlam motoru oluşturma sırasında bellek eklentisi verilerini kullanabilir.
• Oturum budama (bellekte eski araç sonuçlarını kırpma), hangi bağlam motoru etkin olursa olsun yine de çalışır.

​

İpuçları

• Motorunuzun düzgün yüklendiğini doğrulamak için openclaw doctor kullanın.
• Motor değiştiriyorsanız mevcut oturumlar, geçerli geçmişleriyle devam eder. Yeni motor gelecekteki çalıştırmaları devralır.
• Motor hataları günlüğe kaydedilir ve tanılamalarda gösterilir. Bir eklenti motoru kaydedilemezse veya seçilen motor kimliği çözülemezse, OpenClaw otomatik olarak geri dönmez; eklentiyi düzeltene veya plugins.slots.contextEngine değerini yeniden "legacy" olarak değiştirene kadar çalıştırmalar başarısız olur.
• Geliştirme için, yerel bir eklenti dizinini kopyalamadan bağlamak üzere openclaw plugins install -l ./my-engine kullanın.

​

İlgili

• Context — ajan turları için bağlamın nasıl oluşturulduğu
• Plugin Architecture — bağlam motoru eklentilerini kaydetme
• Compaction — uzun konuşmaları özetleme