Ana içeriğe atla

​
Oturum Yönetimi

OpenClaw, konuşmaları oturumlar hâlinde düzenler. Her mesaj, geldiği yere göre bir oturuma yönlendirilir — DM’ler, grup sohbetleri, cron işleri vb.

​
Mesajlar nasıl yönlendirilir

KaynakDavranış
Doğrudan mesajlarVarsayılan olarak paylaşılan oturum
Grup sohbetleriGrup başına yalıtılmış
Odalar/kanallarOda başına yalıtılmış
Cron işleriHer çalıştırma için yeni oturum
Webhook’larHook başına yalıtılmış

​
DM yalıtımı

Varsayılan olarak tüm DM’ler süreklilik için tek bir oturumu paylaşır. Bu, tek kullanıcılı kurulumlar için uygundur.
Birden fazla kişi agent’ınıza mesaj gönderebiliyorsa DM yalıtımını etkinleştirin. Aksi takdirde tüm kullanıcılar aynı konuşma bağlamını paylaşır — Alice’in özel mesajları Bob tarafından görülebilir.
Düzeltme: 
{
  session: {
    dmScope: "per-channel-peer", // kanal + göndericiye göre yalıt
  },
}
Diğer seçenekler:
  • main (varsayılan) — tüm DM’ler tek bir oturumu paylaşır.
  • per-peer — göndericiye göre yalıt (kanallar arasında).
  • per-channel-peer — kanal + göndericiye göre yalıt (önerilir).
  • per-account-channel-peer — hesap + kanal + göndericiye göre yalıt.
Aynı kişi size birden fazla kanaldan ulaşıyorsa, kimliklerini bağlayıp tek bir oturumu paylaşmaları için session.identityLinks kullanın.
Kurulumunuzu openclaw security audit ile doğrulayın.

​
Oturum yaşam döngüsü

Oturumlar, süreleri dolana kadar yeniden kullanılır:
  • Günlük sıfırlama (varsayılan) — gateway ana bilgisayarında yerel saatle sabah 4:00’te yeni oturum.
  • Boşta kalma sıfırlaması (isteğe bağlı) — belirli bir hareketsizlik süresinden sonra yeni oturum. Bunun için session.reset.idleMinutes ayarlayın.
  • Manuel sıfırlama — sohbette /new veya /reset yazın. /new <model> ayrıca modeli de değiştirir.
Hem günlük hem de boşta kalma sıfırlaması yapılandırılmışsa, hangisinin süresi önce dolarsa o geçerli olur.

​
Durumun bulunduğu 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

​
Oturum bakımı

OpenClaw, zaman içinde oturum depolamasını otomatik olarak sınırlar. Varsayılan olarak warn modunda çalışır (neyin temizleneceğini bildirir). Otomatik temizleme için session.maintenance.mode değerini "enforce" olarak ayarlayın: 
{
  session: {
    maintenance: {
      mode: "enforce",
      pruneAfter: "30d",
      maxEntries: 500,
    },
  },
}
Önizleme için openclaw sessions cleanup --dry-run kullanın.

​
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 isteminde neler olduğu.

​
Daha fazla bilgi

  • Session Pruning — araç sonuçlarını kırpma
  • Compaction — uzun konuşmaları özetleme
  • Session Tools — oturumlar arası işler için agent araçları
  • Session Management Deep Dive — depo şeması, transkriptler, gönderim ilkesi, kaynak meta verileri ve gelişmiş yapılandırma
  • Multi-Agent — agent’lar arasında yönlendirme ve oturum yalıtımı
  • Background Tasks — ayrık işlerin oturum başvurularıyla görev kayıtlarını nasıl oluşturduğu
  • Channel Routing — gelen mesajların oturumlara nasıl yönlendirildiği