Bağlam motoru

​

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?

​

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

​

Sistem istemi eklemesi

​

legacy motoru

• İç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.

​

Plugin motorları

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

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

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

​

ContextEngine arayüzü

​

Runtime ayarları

• 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ı

​

Barındırıcı gereksinimleri

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

​

Hata yalıtımı

​

ownsCompaction

​

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ışı