openclaw transcripts

transcripts agent aracı tarafından yazılan transkriptler için salt okunur inceleyici. Yakalama, içe aktarma ve özetleme bu CLI üzerinden değil, söz konusu araç üzerinden çalışır.

Yapıtlar durum dizini altında bulunur:

$OPENCLAW_STATE_DIR/transcripts/YYYY-MM-DD/<session>/  metadata.json  transcript.jsonl  summary.json  summary.md

Varsayılan durum dizini ~/.openclaw dizinidir; OPENCLAW_STATE_DIR ile geçersiz kılabilirsiniz. Tarih dizini oturumun başlangıç zamanından gelir; oturum dizini ise oturum kimliğinden türetilmiş, dosya sistemi açısından güvenli bir kısa addır.

Komutlar

openclaw transcripts listopenclaw transcripts show <session>openclaw transcripts show YYYY-MM-DD/<session>openclaw transcripts path <session>openclaw transcripts path YYYY-MM-DD/<session>openclaw transcripts path <session> --diropenclaw transcripts path <session> --metadataopenclaw transcripts path <session> --transcriptopenclaw transcripts list --jsonopenclaw transcripts show <session> --jsonopenclaw transcripts path <session> --json

<session>, yalnızca oturum kimliğini veya tarih içeren bir seçiciyi (YYYY-MM-DD/<session>) kabul eder. Aynı oturum kimliği birden fazla günde geçiyorsa nitelikli biçimi kullanın; örneğin openclaw transcripts show 2026-05-22/standup. Varsayılan oturum kimlikleri bir zaman damgası ve rastgele bir son ek içerir; bir oturuma yalnızca kimlik aynı gün içinde benzersiz olacaksa sabit bir kimlik verin.

Çıktı

list, her oturum için sekmeyle ayrılmış tek bir satır yazdırır: seçici, başlangıç zamanı, başlık, özet yolu.

2026-05-22/standup  2026-05-22T09:00:00.000Z  Haftalık durum toplantısı  /Users/user/.openclaw/transcripts/2026-05-22/standup/summary.md

Seçici, show veya path komutuna geri iletilecek en güvenli değerdir.

list --json; sessionId, selector, date, title, startedAt, stoppedAt, source, path, summaryPath, hasSummary alanlarını içeren nesneler döndürür.

show --json; saklanan oturum meta verilerini, seçiciyi, oturum dizinini, özet yolunu ve özet Markdown metnini döndürür.

path --json, seçilen yolu ve ilgili dosyanın var olup olmadığını döndürür.

Gün başına birden çok oturum

Oturumlar önce tarihe, ardından oturum kimliğine göre gruplanır. Bir gündeki on toplantı, on kardeş klasöre dönüşür:

~/.openclaw/transcripts/2026-05-22/  transcript-2026-05-22T09-00-00-000Z-a1b2c3d4/  transcript-2026-05-22T10-30-00-000Z-b2c3d4e5/  standup/

Otomasyon için varsayılan olarak oluşturulan kimlikleri kullanın. standup gibi sabit bir kimliği yalnızca aynı tarihte tekrarlanmayacaksa kullanın.

Eksik özetler

Canlı oturumlar, oturum durduğunda summary.md dosyasını yazar; içe aktarılan transkriptler ise içe aktarmanın hemen ardından bu dosyayı yazar. Yakalama hâlâ etkinken, durdurma sırasında bir sağlayıcı başarısız olduğunda veya herhangi bir konuşma ulaşmadan önce meta veriler yazıldığında bir oturum, özeti olmadan list içinde görünebilir.

Salt eklemeli ham transkripti incelemek için path <session> --transcript komutunu kullanın veya Markdown özetini yeniden oluşturmak için transcripts aracının summarize eylemini çalıştırın.

Yapılandırma

Yakalama isteğe bağlıdır (canlı kaynaklar toplantı sesine katılıp kaydedebilir). Şununla etkinleştirin:

{  "transcripts": {    "enabled": true,    "maxUtterances": 2000  }}

• enabled (varsayılan false): aracı etkinleştirir.
• maxUtterances (varsayılan 2000, 1-10000 aralığıyla sınırlandırılır): oturum başına konuşma arabelleği boyutu.

Otomatik başlatma kaynaklarını transcripts.autoStart ile yapılandırın. Her girdi mevcut olduğunda etkinleştirilir; ilgili kaynağı devre dışı bırakmak için girdiyi atlayın. discord-voice, paketle birlikte gelen ve otomatik başlatmayı destekleyen kaynaktır; guildId ve channelId gerektirir:

{  "transcripts": {    "enabled": true,    "autoStart": [      {        "providerId": "discord-voice",        "guildId": "1234567890",        "channelId": "2345678901"      }    ]  }}