`openclaw sessions`

Saklanan konuşma oturumlarını listeleyin. Oturum listeleri kanal/sağlayıcı çalışırlık denetimleri değildir. Oturum depolarında kalıcı olarak saklanan konuşma satırlarını gösterirler. Sessiz bir Discord, Slack, Telegram veya başka bir kanal, bir ileti işlenene kadar yeni bir oturum satırı oluşturmadan başarıyla yeniden bağlanabilir. Canlı kanal bağlantısına ihtiyaç duyduğunuzda openclaw channels status --probe, openclaw status --deep veya openclaw health --verbose kullanın.

openclaw sessions
openclaw sessions --agent work
openclaw sessions --all-agents
openclaw sessions --active 120
openclaw sessions --limit 25
openclaw sessions --store ./tmp/sessions.json
openclaw sessions --json

Bayraklar:

Bayrak	Açıklama
`--agent <id>`	Yapılandırılmış tek bir aracı deposu (varsayılan: yapılandırılmış varsayılan aracı).
`--all-agents`	Yapılandırılmış tüm aracı depolarını birleştirir.
`--store <path>`	Açık depo yolu (`--agent` veya `--all-agents` ile birlikte kullanılamaz).
`--active <minutes>`	Yalnızca son N dakika içinde güncellenen oturumları gösterir.
`--limit <n\|all>`	Çıktılanacak en fazla satır sayısı (varsayılan `100`; `all` tam çıktıyı geri getirir).
`--json`	Makine tarafından okunabilir çıktı.
`--verbose`	Ayrıntılı günlük kaydı.

openclaw sessions ve Gateway sessions.list RPC’si varsayılan olarak sınırlıdır; böylece büyük ve uzun ömürlü depolar CLI işlemini veya Gateway olay döngüsünü tekeline alamaz. CLI varsayılan olarak en yeni 100 oturumu döndürür; daha küçük/büyük bir aralık için --limit <n>, tam depoya bilinçli olarak ihtiyaç duyduğunuzda ise --limit all iletin. JSON yanıtları, çağıranların daha fazla satır bulunduğunu göstermesi gerektiğinde totalCount, limitApplied ve hasMore içerir. RPC istemcileri, geniş birleşik keşif kaynağını koruyup yalnızca yapılandırmada mevcut aracılara ait satırları döndürmek için configuredAgentsOnly: true iletebilir. Control UI bu modu varsayılan olarak kullanır; böylece silinmiş veya yalnızca diskte bulunan aracı depoları Oturumlar görünümünde yeniden belirmez. --all-agents, yapılandırılmış aracı depolarını okur. Gateway ve ACP oturum keşfi daha geniştir: yapılandırılmış aracı köklerinden veya şablonlu bir session.store kökünden çözümlenen SQLite depolarını da içerir. Eski seçici yolları aracı kökü içinde çözümlenmelidir; sembolik bağlantılar ve kök dışındaki yollar atlanır. openclaw sessions --all-agents --json:

{
  "path": null,
  "stores": [
    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },
    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }
  ],
  "allAgents": true,
  "count": 2,
  "totalCount": 2,
  "limitApplied": 100,
  "hasMore": false,
  "activeMinutes": null,
  "sessions": [
    { "agentId": "main", "key": "agent:main:main", "model": "openai/gpt-5.6-sol" },
    { "agentId": "work", "key": "agent:work:main", "model": "anthropic/claude-sonnet-4-6" }
  ]
}

Yörünge ilerlemesini izleme

openclaw sessions tail
openclaw sessions tail --follow
openclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25
openclaw sessions --agent work tail --follow
openclaw sessions --all-agents tail --follow

openclaw sessions tail, son çalışma zamanı yörünge olaylarını kısa ilerleme satırları olarak işler. --session-key olmadan önce çalışan oturumları, ardından saklanan en son oturumu izler. --tail <count>, takip modundan önce kaç mevcut olayın yazdırılacağını belirler; varsayılan 80 değeridir ve 0 geçerli sondan başlar. --follow, seçilen SQLite destekli oturumu veya açıkça belirtilmiş eski bir yörünge dosyasını izlemeyi sürdürür. İlerleme görünümü bilinçli olarak tutucudur: istem metni, araç bağımsız değişkenleri ve araç sonucu gövdeleri yazdırılmaz. Araç çağrıları, araç adını {...redacted...} ile gösterir; araç sonuçları ok, error veya done gibi durumları gösterir; model tamamlama satırları sağlayıcıyı/modeli ve terminal durumunu gösterir.

Bir yörünge paketini dışa aktarma

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

Bu, sahibin yürütme isteğini onaylamasının ardından /export-trajectory eğik çizgi komutu tarafından kullanılan komut yoludur. Çıktı dizini her zaman seçilen çalışma alanındaki .openclaw/trajectory-exports/ içinde çözümlenir.

Temizleme bakımı

Bir sonraki yazma döngüsünü beklemek yerine bakımı şimdi çalıştırın:

openclaw sessions cleanup --dry-run
openclaw sessions cleanup --agent work --dry-run
openclaw sessions cleanup --all-agents --dry-run
openclaw sessions cleanup --enforce
openclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"
openclaw sessions cleanup --dry-run --fix-dm-scope
openclaw sessions cleanup --json

openclaw sessions cleanup, yapılandırmadaki session.maintenance ayarlarını kullanır (Yapılandırma başvurusu):

Kapsam notu: openclaw sessions cleanup; oturum depolarını, dökümleri, yörünge satırlarını ve eski yörünge yan dosyalarını korur. İş başına en yeni 2000 satırı otomatik olarak tutan Cron çalıştırma geçmişini budamaz (Cron yapılandırması).
Temizleme ayrıca başvurulmayan eski/arşiv döküm yapıtlarını, Compaction denetim noktalarını ve session.maintenance.pruneAfter değerinden daha eski yörünge yan dosyalarını budar; SQLite oturum satırları tarafından hâlâ başvurulan yapıtlar korunur.
Temizleme, kısa ömürlü Gateway model çalıştırma yoklaması temizliğini ayrıca modelRunPruned olarak bildirir. Bu yalnızca agent:*:explicit:model-run-<uuid> biçimindeki kesin ve açık anahtarlarla eşleşir. Saklama süresi sabit bir 24h değeridir ve baskıya bağlıdır: eski yoklama satırlarını yalnızca oturum girdisi bakımı/kapasite baskısına ulaşıldığında kaldırır. Çalıştığında model çalıştırma temizliği, genel eski veri temizliği ve sınırlandırmadan önce gerçekleşir.

Bayraklar:

Bayrak	Açıklama
`--dry-run`	Yazma yapmadan kaç girdinin budanacağını/sınırlandırılacağını önizler. Metin modunda oturum başına bir eylem tablosu (`Action`, `Key`, `Age`, `Model`, `Flags`) ve oturum etiketine göre gruplandırılmış bir özet yazdırır.
`--enforce`	`session.maintenance.mode`, `warn` olsa bile bakımı uygular.
`--fix-missing`	Normalde henüz yaş/sayı sınırına ulaşmamış olsalar bile, arşivlenmiş döküm yapıtları eksik veya yalnızca üst bilgi içeren/boş olan eski girdileri kaldırır.
`--fix-dm-scope`	`session.dmScope`, `main` olduğunda önceki `per-peer`, `per-channel-peer` veya `per-account-channel-peer` yönlendirmesinden kalan eski, eş anahtarlı doğrudan DM satırlarını kullanımdan kaldırır. Önce `--dry-run` kullanın; uygulama bu satırları SQLite’tan kaldırır ve eski döküm yapıtlarını silinmiş arşivler olarak korur.
`--active-key <key>`	Belirli bir etkin anahtarı disk bütçesi nedeniyle çıkarılmaya karşı korur. Grup oturumları ve ileti dizisi kapsamlı sohbet oturumları gibi kalıcı harici konuşma işaretçileri de yaş/sayı/disk bütçesi bakımı sırasında tutulur.
`--agent <id>`	Temizlemeyi yapılandırılmış tek bir aracı deposu için çalıştırır.
`--all-agents`	Temizlemeyi yapılandırılmış tüm aracı depoları için çalıştırır.
`--store <path>`	Belirli bir eski depo seçici yolunda çalıştırır.
`--json`	JSON özeti yazdırır. `--all-agents` ile çıktı, depo başına bir özet içerir.

Bir Gateway erişilebilir olduğunda yapılandırılmış aracı depolarına yönelik deneme çalıştırması olmayan temizleme, çalışma zamanı trafiğiyle aynı oturum deposu yazıcısını paylaşması için Gateway üzerinden gönderilir. Eski bir depo seçicisinin açık çevrimdışı onarımı için --store <path> kullanın. openclaw sessions cleanup --all-agents --dry-run --json:

{
  "allAgents": true,
  "mode": "warn",
  "dryRun": true,
  "stores": [
    {
      "agentId": "main",
      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",
      "beforeCount": 120,
      "afterCount": 80,
      "missing": 0,
      "dmScopeRetired": 0,
      "pruned": 40,
      "capped": 0
    },
    {
      "agentId": "work",
      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",
      "beforeCount": 18,
      "afterCount": 18,
      "missing": 0,
      "dmScopeRetired": 0,
      "pruned": 0,
      "capped": 0
    }
  ]
}

Bir oturumu sıkıştırma

Takılmış veya aşırı büyük bir oturum için bağlam bütçesini geri kazanın. openclaw sessions compact <key>, sessions.compact Gateway RPC’sinin birinci sınıf sarmalayıcısıdır ve çalışan bir Gateway gerektirir.

openclaw sessions compact "agent:main:main"
openclaw sessions compact "agent:main:main" --max-lines 200
openclaw sessions compact "agent:work:main" --agent work --json

--max-lines olmadan Gateway, dökümü LLM ile özetler. CLI varsayılan olarak bir istemci son tarihi dayatmaz; yapılandırılmış Compaction yaşam döngüsünün sahibi Gateway’dir.
--max-lines <n> ile son n döküm satırına kadar kısaltır ve önceki dökümü bir .bak yan dosyası olarak arşivler.
--agent <id>: oturumun sahibi olan aracı; global anahtarları için gereklidir.
--url / --token / --password: Gateway bağlantısı geçersiz kılmaları.
--timeout <ms>: milisaniye cinsinden isteğe bağlı istemci tarafı RPC zaman aşımı.
--json: ham RPC yükünü yazdırır.

Gateway başarısız bir Compaction bildirdiğinde veya erişilemez olduğunda komut sıfırdan farklı bir kodla sonlanır; böylece Cron’lar ve betikler sessizce hiçbir işlem yapılmamasını asla başarı olarak değerlendirmez.

openclaw agent --message '/compact ...' bir Compaction yolu değildir. CLI’dan gelen eğik çizgi komutları yetkili gönderen denetimi tarafından reddedilir; bu çağrı, sessizce hiçbir işlem yapmadan sonlanmak yerine burayı gösteren bir yönlendirmeyle sıfırdan farklı bir kodla sonlanır.

sessions.compact RPC

openclaw gateway call sessions.compact --params '<json>' şunları kabul eder:

Alan	Tür	Gerekli	Açıklama
`key`	string	evet	Compaction uygulanacak oturum anahtarı (örneğin `agent:main:main`).
`agentId`	string	hayır	Oturumun sahibi olan aracı kimliği (`global` anahtarları için).
`maxLines`	integer ≥ 1	hayır	LLM özetlemesi yerine son N satıra kadar kırpın.

Örnek LLM özetleme yanıtı:

{
  "ok": true,
  "key": "agent:main:main",
  "compacted": true,
  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }
}

Örnek kırpma yanıtı (--max-lines 200):

{
  "ok": true,
  "key": "agent:main:main",
  "compacted": true,
  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",
  "kept": 200
}

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Oturumlar

`openclaw sessions`

Yörünge ilerlemesini izleme

Bir yörünge paketini dışa aktarma

Temizleme bakımı

Bir oturumu sıkıştırma

sessions.compact RPC

İlgili

​openclaw sessions

​Yörünge ilerlemesini izleme

​Bir yörünge paketini dışa aktarma

​Temizleme bakımı

​Bir oturumu sıkıştırma

​sessions.compact RPC

​İlgili

`openclaw sessions`

Yörünge ilerlemesini izleme

Bir yörünge paketini dışa aktarma

Temizleme bakımı

Bir oturumu sıkıştırma

sessions.compact RPC

İlgili