Bağlam motoru

Bir bağlam motoru, OpenClaw'ın her çalıştırma için model bağlamını nasıl oluşturduğunu kontrol eder: hangi iletilerin ekleneceği, eski geçmişin nasıl özetleneceği ve alt ajan sınırları arasında bağlamın nasıl yönetileceği.

OpenClaw yerleşik bir legacy motoruyla gelir ve bunu varsayılan olarak kullanır - çoğu kullanıcının bunu değiştirmesi gerekmez. Yalnızca farklı bir birleştirme, Compaction veya oturumlar arası hatırlama davranışı istediğinizde bir Plugin motoru kurup seçin.

Hızlı başlangıç

openclaw doctor# veya yapılandırmayı doğrudan inceleyin: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", // plugin'in kayıtlı motor id'siyle eşleşmelidir    },    entries: {      "lossless-claw": {        enabled: true,        // Plugin'e özgü yapılandırma buraya gelir (plugin'in belgelerine bakın)      },    },  },}

Nasıl çalışır?

OpenClaw her model istemi çalıştırdığında, bağlam motoru dört yaşam döngüsü noktasında yer alır:

Paketle gelen ACP dışı Codex araç takımı için OpenClaw, birleştirilmiş bağlamı Codex geliştirici talimatlarına ve geçerli tur istemine yansıtarak aynı yaşam döngüsünü uygular. Codex hâlâ kendi yerel iş parçacığı geçmişinin ve yerel sıkıştırıcısının sahibidir.

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

OpenClaw iki isteğe bağlı alt ajan yaşam döngüsü kancasını çağırır:

Sistem istemi eklemesi

assemble yöntemi bir systemPromptAddition dizesi döndürebilir. OpenClaw bunu çalıştırmanın sistem isteminin başına ekler. Bu, motorların statik çalışma alanı dosyaları gerektirmeden dinamik hatırlama yönlendirmesi, geri getirme talimatları veya bağlama duyarlı ipuçları enjekte etmesini sağlar.

legacy motoru

Yerleşik legacy motoru, OpenClaw'ın özgün davranışını korur:

• İçeri alma: işlem yok (oturum yöneticisi ileti kalıcılığını doğrudan işler).
• Birleştirme: geçiş (runtime'daki mevcut temizle → doğrula → sınırla hattı bağlam birleştirmeyi işler).
• Compact: eski iletilerin tek bir özetini oluşturan ve son iletileri olduğu gibi tutan yerleşik özetleme Compaction'ına devreder.
• Turdan sonra: işlem yok.

legacy motoru araç kaydetmez veya systemPromptAddition sağlamaz.

plugins.slots.contextEngine ayarlanmadığında (veya "legacy" olarak ayarlandığında), bu motor otomatik olarak kullanılır.

Plugin motorları

Bir Plugin, Plugin API'sini kullanarak bir bağlam motoru kaydedebilir:

 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 fabrikası, Plugin'lerin ilk yaşam döngüsü kancası çalışmadan önce ajan başına veya çalışma alanı başına durumu başlatabilmesi için isteğe bağlı config, agentDir ve workspaceDir değerlerini içerir.

Ardından yapılandırmada etkinleştirin:

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

ContextEngine arayüzü

Zorunlu üyeler:

assemble, şunları içeren bir AssembleResult döndürür:

compact, bir CompactResult döndürür. Compaction etkin transkripti döndürdüğünde, result.sessionId ve result.sessionFile sonraki yeniden denemenin veya turun kullanması gereken ardıl oturumu tanımlar.

İsteğe bağlı üyeler:

Runtime ayarları

OpenClaw içinde çalışan yaşam döngüsü kancaları isteğe bağlı bir runtimeSettings nesnesi alır. Bu, sürümlendirilmiş, salt okunur bir iç üretici/tüketici API yüzeyidir: OpenClaw bunu seçili bağlam motoru için üretir ve bağlam motoru bunu yaşam döngüsü kancaları içinde tüketir. Kullanıcılara doğrudan gösterilmez ve özel bir raporlama yüzeyi oluşturmaz.

• schemaVersion: şu anda 1
• runtime: OpenClaw barındırıcısı, runtime modu (normal, fallback veya degraded) ve isteğe bağlı araç takımı/runtime id'leri
• contextEngineSelection: seçili bağlam motoru id'si ve seçim kaynağı
• executionHost: kancayı çağıran yüzey için barındırıcı id'si ve etiketi
• model: istenen model, çözümlenen model, sağlayıcı ve isteğe bağlı model ailesi
• limits: bilindiğinde istem token bütçesi ve maksimum çıktı token'ları
• diagnostics: bilindiğinde kapalı fallback ve degraded neden kodları

Bilinmeyen olabilecek alanlar null olarak temsil edilir; runtime modu ve seçim kaynağı gibi ayırıcı alanlar null yapılamaz kalır. Eski motorlar uyumlu kalır: katı bir eski motor runtimeSettings değerini bilinmeyen bir özellik olarak reddederse, OpenClaw motoru karantinaya almak yerine yaşam döngüsü çağrısını onsuz yeniden dener.

Barındırıcı gereksinimleri

Bağlam motorları, info.hostRequirements üzerinde barındırıcı yetenek gereksinimleri bildirebilir. OpenClaw, işleme başlamadan önce bu gereksinimleri denetler ve seçili runtime bunları karşılayamadığında açıklayıcı bir hatayla kapalı şekilde başarısız olur.

Ajan çalıştırmaları için, motor gerçek model istemini assemble() aracılığıyla kontrol etmeliyse assemble-before-prompt bildirin:

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.",    },  },}

Yerel Codex ve OpenClaw gömülü ajan çalıştırmaları assemble-before-prompt özelliğini karşılar. Genel CLI arka uçları karşılamaz; bu nedenle bunu gerektiren motorlar CLI süreci başlamadan önce reddedilir.

Hata yalıtımı

OpenClaw, seçilen Plugin motorunu çekirdek yanıt yolundan yalıtır. Eski olmayan bir motor eksikse, sözleşme doğrulamasında başarısız olursa, fabrika oluşturma sırasında hata fırlatırsa veya bir yaşam döngüsü yönteminden hata fırlatırsa, OpenClaw bu motoru geçerli Gateway işlemi için karantinaya alır ve bağlam motoru işini yerleşik legacy motora düşürür. Hata, başarısız işlemle birlikte günlüğe yazılır; böylece operatör, ajan sessiz kalmadan Plugin’i onarabilir, güncelleyebilir veya devre dışı bırakabilir.

Ana makine gereksinimi hataları farklıdır: Bir motor, bir çalışma zamanının gerekli bir yetenekten yoksun olduğunu bildirirse, OpenClaw çalıştırmayı başlatmadan önce kapalı hata verir. Bu, desteklenmeyen bir ana makinede çalıştıklarında durumu bozabilecek motorları korur.

ownsCompaction

ownsCompaction, OpenClaw çalışma zamanının yerleşik deneme içi otomatik Compaction özelliğinin çalıştırma için etkin kalıp kalmayacağını denetler:

Bu, iki geçerli Plugin deseni olduğu anlamına gelir:

İşlem yapmayan bir compact(), etkin ve sahiplenmeyen bir motor için güvenli değildir; çünkü bu motor yuvası için normal /compact ve taşma kurtarma Compaction yolunu devre dışı bırakır.

Yapılandırma başvurusu

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

Compaction ve bellek ile ilişkisi

İpuçları

• Motorunuzun doğru yüklendiğini doğrulamak için openclaw doctor kullanın.
• Motorları değiştiriyorsanız, mevcut oturumlar geçerli geçmişleriyle devam eder. Yeni motor gelecekteki çalıştırmalar için devralır.
• Motor hataları günlüğe yazılır ve seçilen Plugin motoru geçerli Gateway işlemi için karantinaya alınır. Yanıtların devam edebilmesi için OpenClaw kullanıcı turlarında legacy değerine geri döner, ancak bozuk Plugin’i yine de onarmalı, güncellemeli, devre dışı bırakmalı veya kaldırmalısınız.
• Geliştirme için, yerel bir Plugin dizinini kopyalamadan bağlamak üzere openclaw plugins install -l ./my-engine kullanın.

İlgili

• Compaction - uzun konuşmaları özetleme
• Bağlam - ajan turları için bağlamın nasıl oluşturulduğu
• Plugin Mimarisi - bağlam motoru Plugin’lerini kaydetme
• Plugin manifest’i - Plugin manifest alanları
• Plugin’ler - Plugin genel bakışı