Oturum yönetimi

OpenClaw konuşmaları oturumlar halinde düzenler. Her ileti, geldiği yere göre bir oturuma yönlendirilir -- DM'ler, grup sohbetleri, cron işleri vb.

İletiler nasıl yönlendirilir

DM yalıtımı

Varsayılan olarak, süreklilik için tüm DM'ler tek bir oturumu paylaşır. Bu, tek kullanıcılı kurulumlar için uygundur.

Düzeltme:

{  session: {    dmScope: "per-channel-peer", // kanala + gönderene göre yalıt  },}

Diğer seçenekler:

• main (varsayılan) -- tüm DM'ler tek bir oturumu paylaşır.
• per-peer -- gönderene göre yalıt (kanallar arasında).
• per-channel-peer -- kanala + gönderene göre yalıt (önerilir).
• per-account-channel-peer -- hesaba + kanala + gönderene göre yalıt.

Bağlı kanalları dock etme

Dock komutları, kullanıcının geçerli doğrudan sohbet oturumunun yanıt rotasını yeni bir oturum başlatmadan başka bir bağlı kanala taşımasına olanak tanır. Örnekler, yapılandırma ve sorun giderme için Kanal docking bölümüne bakın.

Kurulumunuzu openclaw security audit ile doğrulayın.

Oturum yaşam döngüsü

Oturumlar süresi dolana kadar yeniden kullanılır:

• Günlük sıfırlama (varsayılan) -- gateway host'unda yerel saatle 04:00'te yeni oturum. Günlük tazelik, sonraki metadata yazmalarına değil, geçerli sessionId başladığı zamana dayanır.
• Boşta sıfırlama (isteğe bağlı) -- belirli bir hareketsizlik süresinden sonra yeni oturum. session.reset.idleMinutes değerini ayarlayın. Boşta tazelik, son gerçek kullanıcı/kanal etkileşimine dayanır; bu nedenle Heartbeat, cron ve exec sistem olayları oturumu canlı tutmaz.
• Manuel sıfırlama -- sohbette /new veya /reset yazın. /new <model> ayrıca modeli değiştirir.

Hem günlük hem de boşta sıfırlamalar yapılandırıldığında, hangisinin süresi önce dolarsa o geçerli olur. Heartbeat, cron, exec ve diğer sistem olayı dönüşleri oturum metadata'sı yazabilir, ancak bu yazmalar günlük veya boşta sıfırlama tazeliğini uzatmaz. Bir sıfırlama oturumu değiştirdiğinde, eski oturum için kuyruğa alınmış sistem olayı bildirimleri atılır; böylece bayat arka plan güncellemeleri yeni oturumdaki ilk prompt'un başına eklenmez.

Etkin, sağlayıcıya ait bir CLI oturumu bulunan oturumlar örtük günlük varsayılan tarafından kesilmez. Bu oturumların bir zamanlayıcıyla süresinin dolması gerektiğinde /reset kullanın veya session.reset değerini açıkça yapılandırın.

Durumun yaşadığı yer

Tüm oturum durumu gateway tarafından sahiplenilir. UI istemcileri oturum verileri için gateway'i sorgular.

• Depo: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• Transkriptler: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl

sessions.json ayrı yaşam döngüsü zaman damgaları tutar:

• sessionStartedAt: geçerli sessionId başladığı zaman; günlük sıfırlama bunu kullanır.
• lastInteractionAt: boşta kalma ömrünü uzatan son kullanıcı/kanal etkileşimi.
• updatedAt: son depo satırı mutasyonu; listeleme ve budama için yararlıdır, ancak günlük/boşta sıfırlama tazeliği için yetkili kaynak değildir.

sessionStartedAt içermeyen eski satırlar, mevcut olduğunda transkript JSONL oturum başlığından çözümlenir. Eski bir satırda lastInteractionAt da yoksa, boşta tazelik sonraki defter tutma yazmalarına değil, o oturum başlangıç zamanına geri döner.

Oturum bakımı

OpenClaw zaman içinde oturum depolamasını otomatik olarak sınırlar. Varsayılan olarak enforce modunda çalışır ve bakım sırasında temizleme uygular. Depoyu/dosyaları değiştirmeden neyin temizleneceğini raporlamak için session.maintenance.mode değerini "warn" olarak ayarlayın:

{  session: {    maintenance: {      mode: "enforce",      pruneAfter: "30d",      maxEntries: 500,    },  },}

Üretim boyutundaki maxEntries sınırları için Gateway runtime yazmaları küçük bir üst sınır tamponu kullanır ve toplu işlemler halinde yapılandırılmış limite geri temizler. Oturum deposu okumaları Gateway başlangıcı sırasında girişleri budamaz veya sınırlamaz. Bu, her başlangıçta ya da yalıtılmış cron oturumunda tam depo temizliği çalıştırmayı önler. openclaw sessions cleanup --enforce sınırı hemen uygular.

Gateway model çalıştırma probe oturumları varsayılan olarak kısa ömürlüdür. agent:*:explicit:model-run-<uuid> gibi katı açık anahtarlarla eşleşen satırlar sabit 24h saklama kullanır, ancak temizleme baskıya bağlıdır: bayat probe satırlarını yalnızca oturum girişi bakım/sınır baskısına ulaşıldığında kaldırır. Model çalıştırma temizliği çalıştığında, daha geniş bayat giriş yaş eşiğinden ve giriş sınırından önce çalışır. Normal doğrudan, grup, iş parçacığı, cron, hook, Heartbeat, ACP ve alt agent oturumları bu 24h saklamayı devralmaz.

Bakım, grup oturumları ve iş parçacığı kapsamlı sohbet oturumları dahil olmak üzere dayanıklı dış konuşma işaretçilerini korurken, sentetik cron, hook, Heartbeat, ACP ve alt agent girişlerinin yaşlanarak silinmesine yine de izin verir.

Daha önce doğrudan ileti yalıtımı kullandıysanız ve sonra session.dmScope değerini main olarak geri döndürdüyseniz, bayat peer anahtarlı DM satırlarını openclaw sessions cleanup --dry-run --fix-dm-scope ile önizleyin. Aynı bayrağı uygulamak bu eski doğrudan DM satırlarını emekliye ayırır ve transkriptlerini silinmiş arşivler olarak tutar.

openclaw sessions cleanup --dry-run ile önizleyin.

Oturumları inceleme

• openclaw status -- oturum deposu yolu ve son etkinlik.
• openclaw sessions --json -- tüm oturumlar (--active <minutes> ile filtreleyin).
• Sohbette /status -- bağlam kullanımı, model ve geçişler.
• /context list -- sistem prompt'unda neler var.

Daha fazla okuma

• Oturum Budama -- araç sonuçlarını kırpma
• Compaction -- uzun konuşmaları özetleme
• Oturum Araçları -- oturumlar arası çalışma için agent araçları
• Oturum Yönetimi Derinlemesine İnceleme -- depo şeması, transkriptler, gönderim politikası, origin metadata'sı ve gelişmiş yapılandırma
• Çoklu Agent — agent'lar arasında yönlendirme ve oturum yalıtımı
• Arka Plan Görevleri — ayrılmış çalışmanın oturum referanslarıyla görev kayıtlarını nasıl oluşturduğu
• Kanal Yönlendirme — gelen iletilerin oturumlara nasıl yönlendirildiği

İlgili

• Oturum budama
• Oturum araçları
• Komut kuyruğu