Bağlam motoru

Bir bağlam motoru, OpenClaw'ın her çalıştırma için model bağlamını nasıl oluşturduğunu denetler: hangi iletilerin dahil edileceğ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 varsayılan olarak bunu kullanır. Yalnızca farklı bir birleştirme, Compaction veya oturumlar arası hatırlama davranışı istendiğinde 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", // Pluginin kayıtlı motor kimliğiyle eşleşmelidir    },    entries: {      "lossless-claw": {        enabled: true,        // Plugine özgü yapılandırma buraya yazılır (Plugin belgelerine bakın)      },    },  },}

Nasıl çalışır?

OpenClaw bir model istemini her çalıştırdığında bağlam motoru, yaşam döngüsünün dört noktasına katılır:

Motorlar ayrıca önyüklemeden, başarılı bir turdan veya Compaction işleminden sonra transkript bakımı (runtimeContext.rewriteTranscriptEntries() aracılığıyla güvenli yeniden yazma) için isteğe bağlı bir maintain() yöntemi uygulayabilir. Yanıtı engellemek yerine ertelenmiş iş olarak çalıştırmak için info.turnMaintenanceMode: "background" değerini ayarlayın.

Paketle birlikte gelen ACP dışı Codex koşum takımı için OpenClaw, birleştirilmiş bağlamı Codex geliştirici talimatlarına ve mevcut turun istemine yansıtarak aynı yaşam döngüsünü uygular. Codex, yerel iş parçacığı geçmişini ve yerel Compaction bileşenini yönetmeye devam eder.

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

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

Sistem istemine ekleme

assemble yöntemi bir systemPromptAddition dizesi döndürebilir. OpenClaw bunu çalıştırmanın sistem isteminin başına ekler. Böylece motorlar, statik çalışma alanı dosyaları gerektirmeden dinamik hatırlama yönlendirmeleri, erişim talimatları veya bağlama duyarlı ipuçları ekleyebilir.

Eski motor

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

• Alma: işlem yapmaz (ileti kalıcılığını doğrudan oturum yöneticisi işler).
• Birleştirme: değişiklik yapmadan geçirir (çalışma zamanındaki mevcut temizle → doğrula → sınırla işlem hattı bağlam birleştirmeyi işler).
• Compaction: eski iletilerin tek bir özetini oluşturan ve son iletileri olduğu gibi koruyan yerleşik özetleme Compaction işlemine devreder.
• Tur sonrası: işlem yapmaz.

Eski motor araç kaydetmez veya bir systemPromptAddition sağlamaz.

Hiçbir 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 }) {      // İletiyi veri deponuzda saklayın      return { ingested: true };    },     async assemble({      sessionId,      sessionKey,      messages,      tokenBudget,      availableTools,      citationsMode,    }) {      // Bütçeye sığan iletileri döndürün      return {        messages: buildContext(messages, tokenBudget),        estimatedTokens: countTokens(messages),        systemPromptAddition: buildMemorySystemPromptAddition({          availableTools: availableTools ?? new Set(),          citationsMode,          agentSessionKey: sessionKey,        }),      };    },     async compact({ sessionId, force }) {      // Eski bağlamı özetleyin      return { ok: true, compacted: true };    },  }));}

ctx fabrikası, Pluginlerin ilk yaşam döngüsü çağrısından önce ajan veya çalışma alanı başına durumu başlatabilmesi için isteğe bağlı config, agentDir ve workspaceDir değerlerini içerir. Eski olmayan bir assemble() çağrısından önce ana makine, kayıtlı eşzamansız bellek istemi hazırlığını tamamlar. Eşzamanlı buildMemorySystemPromptAddition(...) yardımcısı bu değişmez çalıştırma anlık görüntüsünü okur; sağlanan araç, alıntı, ajan ve oturum bağlamını değiştirmeden aktarın.

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

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

ContextEngine arayüzü

Gerekli üyeler:

assemble, aşağıdakileri içeren bir AssembleResult döndürür:

compact, bir CompactResult döndürür. Compaction etkin oturum kimliğini değiştirdiğinde, result.sessionTarget (oturum kimliğini ve depo kapsamını taşıyan türü belirlenmiş bir ContextEngineSessionTarget), sonraki yeniden denemenin veya turun kullanması gereken ardıl oturumu tanımlar; result.sessionId ardıl kimliği yansıtır.

İsteğe bağlı üyeler:

Çalışma zamanı 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ş ve salt okunur bir dahili üretici/tüketici API yüzeyidir: OpenClaw bunu seçilen bağlam motoru için üretir ve bağlam motoru bunu yaşam döngüsü kancaları içinde tüketir. Doğrudan kullanıcılara gösterilmez ve özel bir raporlama yüzeyi oluşturmaz.

• schemaVersion: şu anda 1
• runtime: OpenClaw ana bilgisayarı, çalışma zamanı modu (normal, fallback veya degraded) ve isteğe bağlı test donanımı/çalışma zamanı kimlikleri
• contextEngineSelection: seçilen bağlam motoru kimliği ve seçim kaynağı
• executionHost: kancayı çağıran yüzeyin ana bilgisayar kimliği ve etiketi
• model: istenen model, çözümlenen model, sağlayıcı ve isteğe bağlı model ailesi
• limits: biliniyorsa istem belirteci bütçesi ve maksimum çıktı belirteci sayısı
• diagnostics: biliniyorsa kapalı geri dönüş ve düşürülmüş çalışma nedeni kodları

Bilinmeyebilen alanlar null olarak gösterilir; çalışma zamanı modu ve seçim kaynağı gibi ayırt edici alanlar null değer kabul etmez. Eski motorlar uyumlu kalır: katı bir eski motor runtimeSettings özelliğini bilinmeyen bir özellik olarak reddederse OpenClaw, motoru karantinaya almak yerine yaşam döngüsü çağrısını bu özellik olmadan yeniden dener.

Ana bilgisayar gereksinimleri

Bağlam motorları, info.hostRequirements üzerinde ana bilgisayar yeteneği gereksinimleri bildirebilir. OpenClaw, işleme başlamadan önce bu gereksinimleri denetler ve seçilen çalışma zamanı bunları karşılayamadığında açıklayıcı bir hatayla kapalı durumda başarısız olur.

Motorun gerçek model istemini assemble() aracılığıyla denetlemesi gerektiğinde ajan çalıştırmaları için assemble-before-prompt bildirin:

info: {  id: "my-context-engine",  name: "Bağlam Motorum",  hostRequirements: {    "agent-run": {      requiredCapabilities: ["assemble-before-prompt"],      unsupportedMessage:        "Yerel Codex veya OpenClaw gömülü çalışma zamanını kullanın ya da eski bağlam motorunu seçin.",    },  },}

Yerel Codex ve OpenClaw gömülü ajan çalıştırmaları assemble-before-prompt gereksinimini karşılar. Genel CLI arka uçları bunu karşılamaz; bu nedenle bu yeteneği gerektiren motorlar CLI işlemi 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ını geçemezse, fabrika oluşturulurken hata fırlatırsa veya bir yaşam döngüsü yönteminden hata fırlatırsa OpenClaw, söz konusu motoru mevcut Gateway işlemi için karantinaya alır ve bağlam motoru işlemlerini yerleşik legacy motoruna düşürür. Hata, başarısız işlemle birlikte günlüğe kaydedilir; böylece operatör, ajan sessiz kalmadan plugin'i onarabilir, güncelleyebilir veya devre dışı bırakabilir.

Ana bilgisayar gereksinimi hataları farklıdır: Bir motor, çalışma zamanında gerekli bir yeteneğin bulunmadığını bildirdiğinde OpenClaw, çalıştırmayı başlatmadan önce kapalı durumda başarısız olur. Bu, desteklenmeyen bir ana bilgisayarda çalışmaları hâlinde durumu bozacak 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 kalıbı olduğu anlamına gelir:

Hiçbir işlem yapmayan bir compact(), etkin ve sahip olmayan bir motor için güvenli değildir; çünkü söz konusu motor yuvasının normal /compact ve taşma kurtarma Compaction yolunu devre dışı bırakır.

Yapılandırma referansı

{  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 bellekle ilişkisi

İpuçları

• Motorunuzun doğru şekilde yüklendiğini doğrulamak için openclaw doctor kullanın.
• Motorlar arasında geçiş yapıldığında mevcut oturumlar geçerli geçmişleriyle devam eder. Yeni motor, gelecekteki çalıştırmaları devralır.
• Motor hataları günlüğe kaydedilir ve seçilen plugin motoru mevcut Gateway işlemi için karantinaya alınır. Yanıtların devam edebilmesi için OpenClaw, kullanıcı turlarında legacy seçeneğine 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 manifesti - plugin manifesti alanları
• Plugin'ler - plugin'e genel bakış