Compaction

Her modelin bir bağlam penceresi vardır: işleyebileceği maksimum token sayısı. Bir konuşma bu sınıra yaklaştığında OpenClaw, sohbetin devam edebilmesi için eski mesajları bir özete compaction uygular.

Nasıl çalışır?

1. Eski konuşma turları kompakt bir girdide özetlenir.
2. Özet, oturum dökümüne kaydedilir.
3. Son mesajlar olduğu gibi korunur.

OpenClaw geçmişi compaction parçalarına böldüğünde, asistan araç çağrılarını eşleşen toolResult girdileriyle birlikte tutar. Bir bölme noktası bir araç bloğunun içine denk gelirse OpenClaw, çiftin birlikte kalması ve mevcut özetlenmemiş kuyruğun korunması için sınırı taşır.

Tam konuşma geçmişi diskte kalır. Compaction yalnızca modelin bir sonraki turda gördüklerini değiştirir.

Otomatik compaction

Otomatik compaction varsayılan olarak açıktır. Oturum bağlam sınırına yaklaştığında veya model bir bağlam taşması hatası döndürdüğünde çalışır; bu durumda OpenClaw compaction uygular ve yeniden dener.

Şunları görürsünüz:

• Normal Gateway günlüklerinde embedded run auto-compaction start / complete.
• Ayrıntılı modda 🧹 Auto-compaction complete.
• /status çıktısında 🧹 Compactions: <count>.

Manuel compaction

Compaction zorlamak için herhangi bir sohbette /compact yazın. Özeti yönlendirmek için yönergeler ekleyin:

/compact Focus on the API design decisions

agents.defaults.compaction.keepRecentTokens ayarlandığında manuel compaction, bu OpenClaw kesme noktasına uyar ve yeniden oluşturulan bağlamda son kuyruğu korur. Açık bir koruma bütçesi olmadan manuel compaction sert bir kontrol noktası gibi davranır ve yalnızca yeni özetten devam eder.

Yapılandırma

Compaction ayarlarını openclaw.json dosyanızda agents.defaults.compaction altında yapılandırın. En yaygın ayarlar aşağıda listelenmiştir; tam başvuru için Oturum yönetimi ayrıntılı incelemesi bölümüne bakın.

Farklı bir model kullanma

Varsayılan olarak compaction, aracın birincil modelini kullanır. Özetlemeyi daha yetenekli veya uzmanlaşmış bir modele devretmek için agents.defaults.compaction.model ayarını belirleyin. Geçersiz kılma, bir provider/model-id dizesini veya agents.defaults.models altında yapılandırılmış yalın bir takma adı kabul eder:

{  "agents": {    "defaults": {      "compaction": {        "model": "openrouter/anthropic/claude-sonnet-4-6"      }    }  }}

Yalın yapılandırılmış takma adlar, compaction başlamadan önce kurallı sağlayıcılarına ve modellerine çözümlenir. Yalın bir değer hem bir takma adla hem de yapılandırılmış değişmez bir model kimliğiyle eşleşirse değişmez model kimliği kazanır. Eşleşmeyen yalın bir değer, etkin sağlayıcıda model kimliği olarak kalır.

Bu yerel modellerle de çalışır; örneğin özetlemeye ayrılmış ikinci bir Ollama modeli:

{  "agents": {    "defaults": {      "compaction": {        "model": "ollama/llama3.1:8b"      }    }  }}

Ayarlanmadığında compaction, etkin oturum modeliyle başlar. Özetleme, model yedeğine uygun bir sağlayıcı hatasıyla başarısız olursa OpenClaw, bu compaction denemesini oturumun mevcut model yedek zinciri üzerinden yeniden dener. Yedek seçimi geçicidir ve oturum durumuna geri yazılmaz. Açık bir agents.defaults.compaction.model geçersiz kılması kesin kalır ve oturum yedek zincirini devralmaz.

Tanımlayıcı koruması

Compaction özetlemesi, opak tanımlayıcıları varsayılan olarak korur (identifierPolicy: "strict"). Devre dışı bırakmak için identifierPolicy: "off" ile, özel yönlendirme içinse identifierPolicy: "custom" artı identifierInstructions ile geçersiz kılın.

Etkin döküm bayt koruması

agents.defaults.compaction.maxActiveTranscriptBytes ayarlandığında OpenClaw, etkin JSONL bu boyuta ulaşırsa bir çalışmadan önce normal yerel compaction tetikler. Bu, sağlayıcı tarafı bağlam yönetiminin model bağlamını sağlıklı tutabildiği ancak yerel dökümün büyümeye devam ettiği uzun süre çalışan oturumlar için kullanışlıdır. Ham JSONL baytlarını bölmez; normal compaction işlem hattından anlamsal bir özet oluşturmasını ister.

Ardıl dökümler

agents.defaults.compaction.truncateAfterCompaction etkinleştirildiğinde OpenClaw, mevcut dökümü yerinde yeniden yazmaz. Compaction özetinden, korunmuş durumdan ve özetlenmemiş kuyruktan yeni bir etkin ardıl döküm oluşturur, ardından dal/geri yükleme akışlarını bu kompakt ardıla yönelten kontrol noktası üst verilerini kaydeder. Ardıl dökümler ayrıca kısa bir yeniden deneme penceresi içinde gelen birebir aynı uzun kullanıcı turlarını düşürür; böylece kanal yeniden deneme fırtınaları compaction sonrasında bir sonraki etkin döküme taşınmaz.

OpenClaw artık yeni compaction işlemleri için ayrı .checkpoint.*.jsonl kopyaları yazmaz. Mevcut eski kontrol noktası dosyaları, başvuruldukları sürece kullanılabilir ve normal oturum temizliği tarafından budanır.

Compaction bildirimleri

Varsayılan olarak compaction sessiz çalışır. Compaction başladığında ve tamamlandığında kısa durum mesajları göstermek için notifyUser ayarını belirleyin:

{  agents: {    defaults: {      compaction: {        notifyUser: true,      },    },  },}

Bellek boşaltma

Compaction öncesinde OpenClaw, kalıcı notları diske depolamak için sessiz bellek boşaltma turu çalıştırabilir. Bu bakım turunun etkin konuşma modeli yerine yerel bir model kullanması gerektiğinde agents.defaults.compaction.memoryFlush.model ayarını belirleyin:

{  "agents": {    "defaults": {      "compaction": {        "memoryFlush": {          "model": "ollama/qwen3:8b"        }      }    }  }}

Bellek boşaltma modeli geçersiz kılması kesindir ve etkin oturum yedek zincirini devralmaz. Ayrıntılar ve yapılandırma için Bellek bölümüne bakın.

Takılabilir compaction sağlayıcıları

Plugin'ler, plugin API üzerinde registerCompactionProvider() aracılığıyla özel bir compaction sağlayıcısı kaydedebilir. Bir sağlayıcı kaydedilip yapılandırıldığında OpenClaw, özetlemeyi yerleşik LLM işlem hattı yerine ona devreder.

Kayıtlı bir sağlayıcı kullanmak için yapılandırmanızda kimliğini ayarlayın:

{  "agents": {    "defaults": {      "compaction": {        "provider": "my-provider"      }    }  }}

Bir provider ayarlamak otomatik olarak mode: "safeguard" zorlar. Sağlayıcılar, yerleşik yolla aynı compaction yönergelerini ve tanımlayıcı koruma politikasını alır; OpenClaw sağlayıcı çıktısından sonra da son tur ve bölünmüş tur sonek bağlamını korur.

Compaction ve budama

Oturum budama, araç çıktısını özetlemeden kırpan daha hafif bir tamamlayıcıdır.

Sorun giderme

Çok sık compaction mı uygulanıyor? Modelin bağlam penceresi küçük olabilir veya araç çıktıları büyük olabilir. Oturum budamayı etkinleştirmeyi deneyin.

Compaction sonrasında bağlam eski mi hissettiriyor? Özeti yönlendirmek için /compact Focus on <topic> kullanın veya notların korunması için bellek boşaltmayı etkinleştirin.

Temiz bir başlangıç mı gerekiyor? /new, compaction uygulamadan yeni bir oturum başlatır.

Gelişmiş yapılandırma için (ayrılmış token'lar, tanımlayıcı koruması, özel bağlam motorları, OpenAI sunucu tarafı compaction) Oturum yönetimi ayrıntılı incelemesi bölümüne bakın.

İlgili

• Oturum: oturum yönetimi ve yaşam döngüsü.
• Oturum budama: araç sonuçlarını kırpma.
• Bağlam: aracı turları için bağlamın nasıl oluşturulduğu.
• Hooks: compaction yaşam döngüsü hook'ları (before_compaction, after_compaction).