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 sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --store ./tmp/sessions.jsonopenclaw sessions --json

Bayraklar:

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 tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw 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-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw 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:

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 200openclaw 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.

sessions.compact RPC

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

Ö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}

İlgili

• Oturum yapılandırması
• Oturum yönetimi
• Compaction
• CLI referansı