Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Trajectory capture, OpenClaw’ın oturum başına uçuş kaydedicisidir. Her agent çalıştırması için yapılandırılmış bir zaman çizelgesi kaydeder; ardından /export-trajectory, geçerli oturumu redakte edilmiş bir destek paketi hâline getirir. Şunlar gibi soruları yanıtlamanız gerektiğinde kullanın:
  • Modele hangi prompt, sistem prompt’u ve araçlar gönderildi?
  • Hangi transcript mesajları ve araç çağrıları bu yanıta yol açtı?
  • Çalıştırma zaman aşımına mı uğradı, iptal mi edildi, compact mı edildi veya bir sağlayıcı hatasıyla mı karşılaştı?
  • Hangi model, Plugin’ler, Skills ve runtime ayarları etkindi?
  • Sağlayıcı hangi kullanım ve prompt önbelleği meta verilerini döndürdü?
Canlı bir Gateway sorunu için geniş kapsamlı bir destek raporu açıyorsanız, /diagnostics ile başlayın. Diagnostics, temizlenmiş Gateway paketini toplar ve OpenAI Codex harness oturumları için, onaydan sonra Codex geri bildirimini OpenAI sunucularına da gönderebilir. Özellikle oturum başına ayrıntılı prompt, araç ve transcript zaman çizelgesine ihtiyacınız olduğunda /export-trajectory kullanın.

​
Hızlı başlangıç

Bunu etkin oturumda gönderin: 
/export-trajectory
Alias: 
/trajectory
OpenClaw paketi çalışma alanı altında yazar: 
.openclaw/trajectory-exports/openclaw-trajectory-<session>-<timestamp>/
Göreli bir çıktı dizini adı seçebilirsiniz: 
/export-trajectory bug-1234
Özel yol .openclaw/trajectory-exports/ içinde çözümlenir. Mutlak yollar ve ~ yolları reddedilir. Trajectory paketleri prompt’lar, model mesajları, araç şemaları, araç sonuçları, runtime olayları ve yerel yollar içerebilir. Bu nedenle chat slash komutu her seferinde exec onayından geçer. Paketi oluşturmak istediğinizde dışa aktarmayı bir kez onaylayın; allow-all kullanmayın. Grup sohbetlerinde OpenClaw, onay prompt’unu ve dışa aktarma sonucunu, trajectory ayrıntılarını paylaşılan odaya geri göndermek yerine sahibine özel olarak gönderir. Yerel inceleme veya destek iş akışları için onaylanmış komut yolunu doğrudan da çalıştırabilirsiniz: 
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .

​
Erişim

Trajectory export bir sahip komutudur. Gönderen, kanal için normal komut yetkilendirme kontrollerini ve sahip kontrollerini geçmelidir.

​
Kaydedilenler

Trajectory capture, OpenClaw agent çalıştırmaları için varsayılan olarak açıktır. Runtime olayları şunları içerir:
  • session.started
  • trace.metadata
  • context.compiled
  • prompt.submitted
  • kaynak model, sonraki model, hata nedeni/ayrıntısı, zincir konumu ve fallback’in zincirde ilerleyip ilerlemediği, başarılı olup olmadığı veya zinciri tüketip tüketmediği dahil model.fallback_step
  • model.completed
  • trace.artifacts
  • session.ended
Transcript olayları da etkin oturum dalından yeniden oluşturulur:
  • kullanıcı mesajları
  • assistant mesajları
  • araç çağrıları
  • araç sonuçları
  • compaction’lar
  • model değişiklikleri
  • etiketler ve özel oturum girdileri
Olaylar, şu şema işaretçisiyle JSON Lines olarak yazılır: 
{
  "traceSchema": "openclaw-trajectory",
  "schemaVersion": 1
}

​
Paket dosyaları

Dışa aktarılan bir paket şunları içerebilir:
Dosyaİçerikler
manifest.jsonPaket şeması, kaynak dosyalar, olay sayıları ve oluşturulan dosya listesi
events.jsonlSıralı runtime ve transcript zaman çizelgesi
session-branch.jsonRedakte edilmiş etkin transcript dalı ve oturum üst bilgisi
metadata.jsonOpenClaw sürümü, OS/runtime, model, config anlık görüntüsü, Plugin’ler, Skills ve prompt meta verileri
artifacts.jsonSon durum, hatalar, kullanım, prompt önbelleği, compaction sayısı, assistant metni ve araç meta verileri
prompts.jsonGönderilen prompt’lar ve seçili prompt oluşturma ayrıntıları
system-prompt.txtYakalandığında, en son derlenmiş sistem prompt’u
tools.jsonYakalandığında, modele gönderilen araç tanımları
manifest.json, o pakette bulunan dosyaları listeler. Oturum karşılık gelen runtime verilerini yakalamadığında bazı dosyalar atlanır.

​
Yakalama konumu

Varsayılan olarak runtime trajectory olayları oturum dosyasının yanına yazılır: 
<session>.trajectory.jsonl
OpenClaw ayrıca oturumun yanına best-effort bir işaretçi dosyası yazar: 
<session>.trajectory-path.json
Runtime trajectory sidecar’larını özel bir dizinde saklamak için OPENCLAW_TRAJECTORY_DIR ayarlayın: 
export OPENCLAW_TRAJECTORY_DIR=/var/lib/openclaw/trajectories
Bu değişken ayarlandığında OpenClaw, o dizinde her oturum kimliği için bir JSONL dosyası yazar. Oturum bakımı, sahip oldukları oturum girdisi sessions disk bütçesi tarafından budandığında, sınırlandığında veya çıkarıldığında trajectory sidecar’larını kaldırır. Sessions dizini dışındaki runtime dosyaları yalnızca işaretçi hedefi hâlâ o oturuma ait olduğunu kanıtladığında kaldırılır.

​
Yakalamayı devre dışı bırakma

OpenClaw’ı başlatmadan önce OPENCLAW_TRAJECTORY=0 ayarlayın: 
export OPENCLAW_TRAJECTORY=0
Bu, runtime trajectory capture’ı devre dışı bırakır. /export-trajectory yine de transcript dalını dışa aktarabilir, ancak derlenmiş bağlam, sağlayıcı artifact’ları ve prompt meta verileri gibi yalnızca runtime dosyaları eksik olabilir.

​
Gizlilik ve sınırlar

Trajectory paketleri destek ve hata ayıklama için tasarlanmıştır, herkese açık paylaşım için değil. OpenClaw, dışa aktarma dosyalarını yazmadan önce hassas değerleri redakte eder:
  • kimlik bilgileri ve bilinen gizli bilgiye benzeyen payload alanları
  • görüntü verileri
  • yerel durum yolları
  • $WORKSPACE_DIR ile değiştirilen çalışma alanı yolları
  • algılandığında home dizini yolları
Exporter ayrıca girdi boyutunu sınırlar:
  • runtime sidecar dosyaları: canlı yakalama 10 MiB’de durur ve alan kaldığında bir kesme olayı kaydeder; export, mevcut runtime sidecar’larını 50 MiB’ye kadar kabul eder
  • oturum dosyaları: 50 MiB
  • runtime olayları: 200.000
  • toplam dışa aktarılan olay: 250.000
  • tekil runtime olay satırları 256 KiB üzerinde kesilir
Paketleri ekibiniz dışında paylaşmadan önce inceleyin. Redaksiyon best-effort’tür ve uygulamaya özgü her gizli bilgiyi bilemez.

​
Sorun giderme

Dışa aktarmada runtime olayı yoksa:
  • OpenClaw’ın OPENCLAW_TRAJECTORY=0 olmadan başlatıldığını doğrulayın
  • OPENCLAW_TRAJECTORY_DIR yazılabilir bir dizini gösteriyor mu kontrol edin
  • oturumda başka bir mesaj çalıştırın, sonra yeniden dışa aktarın
  • runtimeEventCount için manifest.json inceleyin
Komut çıktı yolunu reddederse:
  • bug-1234 gibi göreli bir ad kullanın
  • /tmp/... veya ~/... geçirmeyin
  • dışa aktarmayı .openclaw/trajectory-exports/ içinde tutun
Dışa aktarma bir boyut hatasıyla başarısız olursa, oturum veya sidecar dışa aktarma güvenlik sınırlarını aşmıştır. Yeni bir oturum başlatın veya daha küçük bir reproduction dışa aktarın.

​
İlgili