​

Oturum Yönetimi ve Sıkıştırma (Derinlemesine İnceleme)

• Oturum yönlendirme (gelen mesajların bir sessionKey değerine nasıl eşlendiği)
• Oturum deposu (sessions.json) ve neyi izlediği
• Transkript kalıcılığı (*.jsonl) ve yapısı
• Transkript hijyeni (çalıştırmalardan önce sağlayıcıya özgü düzeltmeler)
• Bağlam sınırları (bağlam penceresi ile izlenen token’lar)
• Sıkıştırma (elle + otomatik sıkıştırma) ve sıkıştırma öncesi işlerin nereye bağlanacağı
• Sessiz bakım (ör. kullanıcıya görünür çıktı üretmemesi gereken bellek yazımları)

• /concepts/session
• /concepts/compaction
• /concepts/memory
• /concepts/memory-search
• /concepts/session-pruning
• /reference/transcript-hygiene

​

Doğruluğun kaynağı: Gateway

• UI’ler (macOS uygulaması, web Control UI, TUI), oturum listeleri ve token sayıları için Gateway’i sorgulamalıdır.
• Uzak modda oturum dosyaları uzak ana makinededir; “yerel Mac dosyalarınızı kontrol etmek”, Gateway’in kullandığını yansıtmaz.

​

İki kalıcılık katmanı

1. Oturum deposu (sessions.json)
   • Anahtar/değer eşlemesi: sessionKey -> SessionEntry
   • Küçük, değiştirilebilir, düzenlenmesi güvenli (veya girdiler silinebilir)
   • Oturum meta verilerini izler (geçerli oturum kimliği, son etkinlik, anahtarlar, token sayaçları vb.)
2. Transkript (<sessionId>.jsonl)
   • Ağaç yapılı eklemeli transkript (girdilerde id + parentId vardır)
   • Gerçek konuşmayı + araç çağrılarını + sıkıştırma özetlerini saklar
   • Gelecek turlar için model bağlamını yeniden oluşturmakta kullanılır

​

Disk üzerindeki konumlar

• Depo: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• Transkriptler: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
  • Telegram konu oturumları: .../<sessionId>-topic-<threadId>.jsonl

​

Depo bakımı ve disk denetimleri

• mode: warn (varsayılan) veya enforce
• pruneAfter: eski giriş yaş sınırı (varsayılan 30d)
• maxEntries: sessions.json içindeki giriş sınırı (varsayılan 500)
• rotateBytes: sessions.json aşırı büyüdüğünde döndürme eşiği (varsayılan 10mb)
• resetArchiveRetention: *.reset.<timestamp> transkript arşivleri için saklama süresi (varsayılan: pruneAfter ile aynı; false temizlemeyi devre dışı bırakır)
• maxDiskBytes: isteğe bağlı oturumlar dizini bütçesi
• highWaterBytes: temizlikten sonraki isteğe bağlı hedef (varsayılan maxDiskBytes değerinin %80’i)

1. Önce en eski arşivlenmiş veya sahipsiz transkript yapılarını kaldırın.
2. Hâlâ hedefin üzerindeyse en eski oturum girdilerini ve transkript dosyalarını çıkarın.
3. Kullanım highWaterBytes değerine veya altına inene kadar devam edin.

openclaw sessions cleanup --dry-run
openclaw sessions cleanup --enforce

​

Cron oturumları ve çalıştırma günlükleri

• cron.sessionRetention (varsayılan 24h), oturum deposundaki eski yalıtılmış cron çalıştırma oturumlarını budar (false bunu devre dışı bırakır).
• cron.runLog.maxBytes + cron.runLog.keepLines, ~/.openclaw/cron/runs/<jobId>.jsonl dosyalarını budar (varsayılanlar: 2_000_000 bayt ve 2000 satır).

​

Oturum anahtarları (sessionKey)

• Ana/doğrudan sohbet (agent başına): agent:<agentId>:<mainKey> (varsayılan main)
• Grup: agent:<agentId>:<channel>:group:<id>
• Oda/kanal (Discord/Slack): agent:<agentId>:<channel>:channel:<id> veya ...:room:<id>
• Cron: cron:<job.id>
• Webhook: hook:<uuid> (geçersiz kılınmadıkça)

​

Oturum kimlikleri (sessionId)

• Sıfırlama (/new, /reset), bu sessionKey için yeni bir sessionId oluşturur.
• Günlük sıfırlama (varsayılan olarak gateway ana makinesinin yerel saatine göre sabah 4:00), sıfırlama sınırından sonraki ilk mesajda yeni bir sessionId oluşturur.
• Boşta kalma süresi dolumu (session.reset.idleMinutes veya eski session.idleMinutes), boşta kalma penceresinden sonra mesaj geldiğinde yeni bir sessionId oluşturur. Günlük + boşta kalma birlikte yapılandırıldığında hangisinin süresi önce dolarsa o kazanır.
• Thread üst çatallama koruması (session.parentForkMaxTokens, varsayılan 100000), üst oturum zaten çok büyükse üst transkript çatallamasını atlar; yeni thread temiz başlar. Devre dışı bırakmak için 0 ayarlayın.

​

Oturum deposu şeması (sessions.json)

• sessionId: geçerli transkript kimliği (eğer sessionFile ayarlanmışsa dosya adı bundan türetilmez)
• updatedAt: son etkinlik zaman damgası
• sessionFile: isteğe bağlı açık transkript yolu geçersiz kılması
• chatType: direct | group | room (UI’lere ve gönderim ilkesine yardımcı olur)
• provider, subject, room, space, displayName: grup/kanal etiketlemesi için meta veriler
• Anahtarlar:
  • thinkingLevel, verboseLevel, reasoningLevel, elevatedLevel
  • sendPolicy (oturum başına geçersiz kılma)
• Model seçimi:
  • providerOverride, modelOverride, authProfileOverride
• Token sayaçları (en iyi çaba / sağlayıcıya bağlı):
  • inputTokens, outputTokens, totalTokens, contextTokens
• compactionCount: bu oturum anahtarı için otomatik sıkıştırmanın kaç kez tamamlandığı
• memoryFlushAt: son sıkıştırma öncesi bellek boşaltmanın zaman damgası
• memoryFlushCompactionCount: son boşaltmanın çalıştığı sıradaki sıkıştırma sayısı

​

Transkript yapısı (*.jsonl)

• İlk satır: oturum başlığı (type: "session", id, cwd, timestamp, isteğe bağlı parentSession içerir)
• Sonra: id + parentId içeren oturum girdileri (ağaç)

• message: kullanıcı/asistan/toolResult mesajları
• custom_message: model bağlamına giren uzantı enjeksiyonlu mesajlar (UI’de gizlenebilir)
• custom: model bağlamına girmeyen uzantı durumu
• compaction: firstKeptEntryId ve tokensBefore içeren kalıcı sıkıştırma özeti
• branch_summary: bir ağaç dalında gezinirken kalıcı özet

​

Bağlam pencereleri ve izlenen token’lar

1. Model bağlam penceresi: model başına sabit üst sınır (modele görünen token’lar)
2. Oturum deposu sayaçları: sessions.json içine yazılan dönen istatistikler (/status ve panolar için kullanılır)

• Bağlam penceresi model kataloğundan gelir (ve yapılandırma ile geçersiz kılınabilir).
• Depodaki contextTokens, çalışma zamanı tahmini/raporlama değeridir; bunu katı bir garanti olarak görmeyin.

​

Sıkıştırma: nedir

• Sıkıştırma özeti
• firstKeptEntryId sonrasındaki mesajlar

​

Sıkıştırma parça sınırları ve araç eşleştirme

• Token paylaşımı bölümü bir araç çağrısı ile sonucu arasına denk gelirse OpenClaw çifti ayırmak yerine sınırı asistan araç çağrısı mesajına kaydırır.
• Sondaki bir araç sonucu bloğu parçayı aksi halde hedefin üstüne iteceksa OpenClaw bekleyen bu araç bloğunu korur ve özetlenmemiş kuyruğu bozulmadan tutar.
• İptal edilen/hatalı araç çağrısı blokları bekleyen bir bölünmeyi açık tutmaz.

​

Otomatik sıkıştırma ne zaman olur (Pi çalışma zamanı)

1. Taşma kurtarma: model bir bağlam taşması hatası döndürür (request_too_large, context length exceeded, input exceeds the maximum number of tokens, input token count exceeds the maximum number of input tokens, input is too long for the model, ollama error: context length exceeded ve benzeri sağlayıcı biçimli varyantlar) → sıkıştır → yeniden dene.
2. Eşik bakımı: başarılı bir turdan sonra, şu durumda:

• contextWindow, modelin bağlam penceresidir
• reserveTokens, istemler + bir sonraki model çıktısı için ayrılan boşluk payıdır

​

Sıkıştırma ayarları (reserveTokens, keepRecentTokens)

{
  compaction: {
    enabled: true,
    reserveTokens: 16384,
    keepRecentTokens: 20000,
  },
}

• Eğer compaction.reserveTokens < reserveTokensFloor ise OpenClaw bunu yükseltir.
• Varsayılan taban sınır 20000 token’dır.
• Taban sınırı devre dışı bırakmak için agents.defaults.compaction.reserveTokensFloor: 0 ayarlayın.
• Değer zaten daha yüksekse OpenClaw dokunmaz.

​

Takılabilir sıkıştırma sağlayıcıları

• provider: kayıtlı bir sıkıştırma sağlayıcı plugin’inin kimliği. Varsayılan LLM özetlemesi için boş bırakın.
• provider ayarlamak mode: "safeguard" değerini zorlar.
• Sağlayıcılar, yerleşik yol ile aynı sıkıştırma yönergelerini ve tanımlayıcı koruma ilkesini alır.
• Güvenlik koruması, sağlayıcı çıktısından sonra da son turların ve bölünmüş turun sonek bağlamını korur.
• Sağlayıcı başarısız olursa veya boş sonuç döndürürse OpenClaw otomatik olarak yerleşik LLM özetlemesine geri döner.
• Abort/timeout sinyalleri çağıran iptaline saygı göstermek için yeniden fırlatılır (yutulmaz).

​

Kullanıcıya görünür yüzeyler

• /status (herhangi bir sohbet oturumunda)
• openclaw status (CLI)
• openclaw sessions / sessions --json
• Ayrıntılı mod: 🧹 Auto-compaction complete + sıkıştırma sayısı

​

Sessiz bakım (NO_REPLY)

• Asistan, “kullanıcıya yanıt teslim etme” anlamına gelecek şekilde çıktısına tam sessiz token NO_REPLY / no_reply ile başlar.
• OpenClaw bunu teslim katmanında temizler/bastırır.
• Tam sessiz token bastırması büyük/küçük harfe duyarsızdır; yani tüm yük yalnızca sessiz token ise NO_REPLY ve no_reply ikisi de sayılır.
• Bu yalnızca gerçek arka plan/teslim yok turları içindir; sıradan eyleme dönük kullanıcı istekleri için bir kısayol değildir.

​

Sıkıştırma öncesi “bellek boşaltma” (uygulandı)

1. Oturum bağlam kullanımını izleyin.
2. Bu kullanım bir “yumuşak eşiği” geçtiğinde (Pi’nin sıkıştırma eşiğinin altında), agente sessiz bir “şimdi belleğe yaz” yönergesi çalıştırın.
3. Kullanıcı hiçbir şey görmesin diye tam sessiz token NO_REPLY / no_reply kullanın.

• enabled (varsayılan: true)
• softThresholdTokens (varsayılan: 4000)
• prompt (boşaltma turu için kullanıcı mesajı)
• systemPrompt (boşaltma turu için eklenen ek sistem istemi)

• Varsayılan prompt/system prompt, teslimi bastırmak için NO_REPLY ipucu içerir.
• Boşaltma, sıkıştırma döngüsü başına bir kez çalışır (sessions.json içinde izlenir).
• Boşaltma yalnızca gömülü Pi oturumlarında çalışır (CLI arka uçları bunu atlar).
• Oturum çalışma alanı salt okunursa boşaltma atlanır (workspaceAccess: "ro" veya "none").
• Çalışma alanı dosya düzeni ve yazma desenleri için Memory sayfasına bakın.

​

Sorun giderme kontrol listesi

• Oturum anahtarı yanlış mı? /concepts/session ile başlayın ve /status içindeki sessionKey değerini doğrulayın.
• Depo ile transkript uyuşmuyor mu? Gateway ana makinesini ve openclaw status çıktısındaki depo yolunu doğrulayın.
• Sıkıştırma spam’i mi var? Şunları kontrol edin:
  • model bağlam penceresi (çok küçük olabilir)
  • sıkıştırma ayarları (model penceresi için reserveTokens çok yüksekse daha erken sıkıştırmaya neden olabilir)
  • tool-result şişmesi: oturum budamayı etkinleştirin/ayarlayın
• Sessiz turlar sızıyor mu? Yanıtın NO_REPLY ile başladığını (büyük/küçük harfe duyarsız tam token) ve akış bastırma düzeltmesini içeren bir sürüm kullandığınızı doğrulayın.