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", // 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?

​

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

​

Sistem istemine ekleme

​

Eski motor

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

​

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

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

​

ContextEngine arayüzü

​

Çalışma zamanı ayarları

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

​

Ana bilgisayar gereksinimleri

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

​

Hata yalıtımı

​

ownsCompaction

​

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