​

Oturum Yönetimi ve Sıkıştırma (Ayrıntılı İnceleme)

• Oturum yönlendirme (gelen mesajların bir sessionKey ile nasıl eşlendiği)
• Oturum deposu (sessions.json) ve bunun neleri izlediği
• Döküm kalıcılığı (*.jsonl) ve yapısı
• Döküm 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 (manuel + otomatik sıkıştırma) ve sıkıştırma öncesi işlerin nereye bağlanacağı
• Sessiz bakım işlemleri (ö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

​

Gerçek kaynak: 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üzenlemesi güvenli (veya girdileri silebilirsiniz)
   • Oturum meta verilerini izler (geçerli oturum kimliği, son etkinlik, anahtarlar, token sayaçları vb.)
2. Döküm (<sessionId>.jsonl)
   • Ağaç yapısına sahip salt eklemeli döküm (id + parentId içeren girdiler)
   • Gerçek konuşmayı + araç çağrılarını + sıkıştırma özetlerini depolar
   • Gelecek dönüşler için model bağlamını yeniden oluşturmakta kullanılır

​

Disk üzerindeki konumlar

• Depo: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• Dökümler: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
  • Telegram konu oturumları: .../<sessionId>-topic-<threadId>.jsonl

​

Depo bakımı ve disk kontrolleri

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

1. Önce en eski arşivlenmiş veya sahipsiz döküm yapıtlarını kaldırır.
2. Hâlâ hedefin üzerindeyse, en eski oturum girdilerini ve bunların döküm dosyalarını çıkarır.
3. Kullanım highWaterBytes değerine eşit veya altına inene kadar devam eder.

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

​

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

• cron.sessionRetention (varsayılan 24h) eski yalıtılmış cron çalıştırma oturumlarını oturum deposundan temizler (false 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 (aracı 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ıysa)

​

Oturum kimlikleri (sessionId)

• Sıfırlama (/new, /reset), o sessionKey için yeni bir sessionId oluşturur.
• Günlük sıfırlama (varsayılan olarak Gateway ana makinesinin yerel saatinde sabah 4:00) sıfırlama sınırından sonraki ilk mesajda yeni bir sessionId oluşturur.
• Boşta kalma sona ermesi (session.reset.idleMinutes veya eski session.idleMinutes), boşta kalma penceresinden sonra bir mesaj geldiğinde yeni bir sessionId oluşturur. Günlük + boşta kalma birlikte yapılandırılmışsa hangisi önce sona ererse o geçerli olur.
• İş parçacığı üst çatallanma koruması (session.parentForkMaxTokens, varsayılan 100000), üst oturum zaten çok büyük olduğunda üst döküm çatallanmasını atlar; yeni iş parçacığı temiz başlar. Devre dışı bırakmak için 0 ayarlayın.

​

Oturum deposu şeması (sessions.json)

• sessionId: geçerli döküm kimliği (eğer sessionFile ayarlı değilse dosya adı bundan türetilir)
• updatedAt: son etkinlik zaman damgası
• sessionFile: isteğe bağlı açık döküm 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ı (yaklaşık / 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ığı andaki sıkıştırma sayısı

​

Döküm yapısı (*.jsonl)

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

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

​

Bağlam pencereleri ile 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 kayan 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ştirmesi

• Token payı bölünmesi 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 tool-result bloğu başka türlü parçayı hedefin üstüne çıkaracaksa, OpenClaw bu bekleyen araç bloğunu korur ve özetlenmemiş kuyruğu bozulmadan tutar.
• İptal edilmiş/hatalı araç çağrısı blokları bekleyen bölmeyi açık tutmaz.

​

Otomatik sıkıştırma ne zaman gerçekleşir (Pi çalışma zamanı)

1. Taşma kurtarma: model 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 dönüşten sonra, şu durumda:

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

​

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 20000 token’dır.
• Tabanı devre dışı bırakmak için agents.defaults.compaction.reserveTokensFloor: 0 ayarlayın.
• Zaten daha yüksekse, OpenClaw buna dokunmaz.

​

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 işlemleri (NO_REPLY)

• Asistan, çıktısına tam sessiz belirteç olan NO_REPLY / no_reply ile başlayarak “kullanıcıya yanıt gönderme” anlamını belirtir.
• OpenClaw bunu teslim katmanında ayıklar/baskılar.
• Tam sessiz belirteç baskılaması büyük/küçük harfe duyarsızdır; dolayısıyla tüm yük yalnızca sessiz belirteç olduğunda NO_REPLY ve no_reply ikisi de geçerlidir.
• Bu yalnızca gerçekten arka plan/teslimatsız dönüşler içindir; sıradan eyleme geçirilebilir 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. Bir “yumuşak eşiği” (Pi’nin sıkıştırma eşiğinin altında) geçtiğinde, ajana sessiz bir “şimdi belleğe yaz” yönergesi çalıştırın.
3. Kullanıcının hiçbir şey görmemesi için tam sessiz belirteç NO_REPLY / no_reply kullanın.

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

• Varsayılan prompt/system prompt, teslimatı baskılamak için bir NO_REPLY ipucu içerir.
• Boşaltma her sıkıştırma döngüsünde bir kez çalışır (sessions.json içinde izlenir).
• Boşaltma yalnızca gömülü Pi oturumları için ç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 kalıpları için bkz. Memory.

​

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 döküm eşleşmiyor mu? Gateway ana makinesini ve openclaw status içinden 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 fazla yüksekse daha erken sıkıştırmaya neden olabilir)
  • tool-result şişmesi: oturum budamayı etkinleştirin/ayarlayın
• Sessiz dönüşler sızıyor mu? Yanıtın NO_REPLY ile başladığını (büyük/küçük harfe duyarsız tam belirteç) ve akış baskılama düzeltmesini içeren bir derleme kullandığınızı doğrulayın.