Bağlam

"Context", OpenClaw'ın bir çalıştırma için modele gönderdiği her şeydir. Modelin context window'u (token sınırı) tarafından sınırlandırılır.

Yeni başlayanlar için zihinsel model:

• System prompt (OpenClaw tarafından oluşturulur): kurallar, araçlar, Skills listesi, zaman/runtime ve enjekte edilen çalışma alanı dosyaları.
• Konuşma geçmişi: bu oturum için sizin mesajlarınız + asistanın mesajları.
• Araç çağrıları/sonuçları + ekler: komut çıktısı, dosya okumaları, görüntüler/ses, vb.

Context, "memory" ile aynı şey değildir: memory diskte saklanıp daha sonra yeniden yüklenebilir; context ise modelin mevcut penceresinin içinde olan şeydir.

Hızlı başlangıç (context'i inceleme)

• /status → hızlı "pencerem ne kadar dolu?" görünümü + oturum ayarları.
• /context list → nelerin enjekte edildiği + yaklaşık boyutlar (dosya başına + toplamlar).
• /context detail → daha derin döküm: dosya başına, araç şeması boyutları başına, Skill girdisi boyutları başına ve system prompt boyutu.
• /context map → mevcut oturumun izlenen context katkıda bulunanlarının WinDirStat tarzı ağaç haritası görüntüsü.
• /usage tokens → normal yanıtlara yanıt başına kullanım alt bilgisini ekle.
• /compact → pencere alanı açmak için eski geçmişi kompakt bir girdiye özetle.

Ayrıca bkz.: Eğik çizgi komutları, Token kullanımı ve maliyetler, Compaction.

Örnek çıktı

Değerler modele, sağlayıcıya, araç politikasına ve çalışma alanınızda ne olduğuna göre değişir.

/context list

🧠 Context breakdownWorkspace: <workspaceDir>Bootstrap max/file: 12,000 charsSandbox: mode=non-main sandboxed=falseSystem prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok)) Injected workspace files:- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)- HEARTBEAT.md: MISSING | raw 0 | injected 0- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok) Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)Tools: read, edit, write, exec, process, browser, message, sessions_send, …Tool list (system prompt text): 1,032 chars (~258 tok)Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)Tools: (same as above) Session tokens (cached): 14,250 total / ctx=32,000

/context detail

🧠 Context breakdown (detailed)…Top skills (prompt entry size):- frontend-design: 412 chars (~103 tok)- oracle: 401 chars (~101 tok)… (+10 more skills) Top tools (schema size):- browser: 9,812 chars (~2,453 tok)- exec: 6,240 chars (~1,560 tok)… (+N more tools)

/context map

En son önbelleğe alınmış çalıştırma raporundan oluşturulan bir görüntü gönderir. Oturumda normal bir mesaj bir çalıştırma raporu üretmeden önce, /context map tahmin render etmek yerine kullanılamaz mesajı döndürür. Dikdörtgen alanı, izlenen prompt karakterleriyle orantılıdır:

• enjekte edilen çalışma alanı dosyaları
• temel system prompt metni
• Skill prompt girdileri
• araç JSON şemaları

/context list, /context detail ve /context json, önbelleğe alınmış çalıştırma raporu olmadığında da isteğe bağlı bir tahmini inceleyebilir.

Context window'a neler dahil edilir

Modelin aldığı her şey dahil edilir, bunlar dahil:

• System prompt (tüm bölümler).
• Konuşma geçmişi.
• Araç çağrıları + araç sonuçları.
• Ekler/transkriptler (görüntüler/ses/dosyalar).
• Compaction özetleri ve budama artefaktları.
• Sağlayıcı "sarmalayıcıları" veya gizli başlıkları (görünmez, yine de sayılır).

OpenClaw system prompt'u nasıl oluşturur

System prompt OpenClaw'a aittir ve her çalıştırmada yeniden oluşturulur. Şunları içerir:

• Araç listesi + kısa açıklamalar.
• Skills listesi (yalnızca metadata; aşağıya bakın).
• Çalışma alanı konumu.
• Zaman (UTC + yapılandırılmışsa dönüştürülmüş kullanıcı zamanı).
• Runtime metadata'sı (host/OS/model/thinking).
• Project Context altında enjekte edilen çalışma alanı bootstrap dosyaları.

Tam döküm: System Prompt.

Enjekte edilen çalışma alanı dosyaları (Project Context)

Varsayılan olarak, OpenClaw sabit bir çalışma alanı dosyaları kümesini (varsa) enjekte eder:

• AGENTS.md
• SOUL.md
• TOOLS.md
• IDENTITY.md
• USER.md
• HEARTBEAT.md
• BOOTSTRAP.md (yalnızca ilk çalıştırma)

Büyük dosyalar, agents.defaults.bootstrapMaxChars kullanılarak dosya başına kırpılır (varsayılan 12000 karakter). OpenClaw ayrıca agents.defaults.bootstrapTotalMaxChars ile dosyalar genelinde toplam bootstrap enjeksiyon sınırı uygular (varsayılan 60000 karakter). /context, ham ve enjekte edilen boyutları ve kırpma olup olmadığını gösterir.

Kırpma gerçekleştiğinde runtime, Project Context altında prompt içinde bir uyarı bloğu enjekte edebilir. Bunu agents.defaults.bootstrapPromptTruncationWarning ile yapılandırın (off, once, always; varsayılan once).

Skills: enjekte edilen ve isteğe bağlı yüklenen

System prompt kompakt bir Skills listesi içerir (ad + açıklama + konum). Bu listenin gerçek bir ek yükü vardır.

Skill talimatları varsayılan olarak dahil edilmez. Modelin Skill'in SKILL.md dosyasını yalnızca gerektiğinde read etmesi beklenir.

Araçlar: iki maliyet vardır

Araçlar context'i iki şekilde etkiler:

1. System prompt içindeki araç listesi metni ("Tooling" olarak gördüğünüz şey).
2. Araç şemaları (JSON). Bunlar, modelin araçları çağırabilmesi için modele gönderilir. Düz metin olarak görmeseniz bile context'e dahil edilirler.

/context detail, en büyük araç şemalarını dökümler; böylece neyin baskın olduğunu görebilirsiniz.

Komutlar, yönergeler ve "satır içi kısayollar"

Eğik çizgi komutları Gateway tarafından işlenir. Birkaç farklı davranış vardır:

• Bağımsız komutlar: yalnızca /... olan bir mesaj komut olarak çalışır.
• Yönergeler: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue model mesajı görmeden önce çıkarılır.
  • Yalnızca yönerge içeren mesajlar oturum ayarlarını kalıcı hale getirir.
  • Normal bir mesajdaki satır içi yönergeler, mesaj başına ipuçları gibi davranır.
• Satır içi kısayollar (yalnızca izin verilen göndericiler): normal bir mesaj içindeki belirli /... token'ları hemen çalışabilir (örnek: "hey /status") ve model kalan metni görmeden önce çıkarılır.

Ayrıntılar: Eğik çizgi komutları.

Oturumlar, Compaction ve budama (ne kalıcı olur)

Mesajlar arasında neyin kalıcı olduğu mekanizmaya bağlıdır:

• Normal geçmiş, politika tarafından compact/prune edilene kadar oturum transkriptinde kalıcı olur.
• Compaction, transkripte bir özet kalıcılaştırır ve son mesajları olduğu gibi tutar.
• Budama, context-window alanı açmak için eski araç sonuçlarını bellekteki prompt'tan düşürür, ancak oturum transkriptini yeniden yazmaz - tam geçmiş diskte hâlâ incelenebilir.

Belgeler: Oturum, Compaction, Oturum budama.

Varsayılan olarak OpenClaw, birleştirme ve Compaction için yerleşik legacy context engine'i kullanır. kind: "context-engine" sağlayan bir Plugin yüklerseniz ve plugins.slots.contextEngine ile seçerseniz OpenClaw bunun yerine context birleştirmeyi, /compact komutunu ve ilgili subagent context yaşam döngüsü hook'larını o engine'e devreder. ownsCompaction: false, legacy engine'e otomatik geri dönüş yapmaz; etkin engine yine de compact() öğesini doğru şekilde uygulamalıdır. Tam takılabilir arayüz, yaşam döngüsü hook'ları ve yapılandırma için Context Engine bölümüne bakın.

/context gerçekte ne raporlar

/context, mevcut olduğunda en son çalıştırmada oluşturulmuş system prompt raporunu tercih eder:

• System prompt (run) = son gömülü (araç kullanabilen) çalıştırmadan yakalanır ve oturum deposunda kalıcılaştırılır.
• System prompt (estimate) = çalıştırma raporu olmadığında (veya raporu üretmeyen bir CLI backend'i üzerinden çalışırken) anında hesaplanır.

Her iki durumda da boyutları ve en büyük katkıda bulunanları raporlar; tam system prompt'u veya araç şemalarını dökmez.

İlgili