​

Session Tools

OpenClaw, agent’lara oturumlar arasında çalışmak, durumu incelemek ve alt ajanları orkestre etmek için araçlar verir.

​

Kullanılabilir araçlar

​

Oturumları listeleme ve okuma

sessions_list, oturumları anahtarları, türleri, kanalları, modelleri, token sayıları ve zaman damgalarıyla birlikte döndürür. Tür (main, group, cron, hook, node) veya yakın zamanlılık (activeMinutes) bazında filtreleyin. sessions_history, belirli bir oturum için konuşma transkriptini getirir. Varsayılan olarak araç sonuçları hariç tutulur — görmek için includeTools: true geçin. Döndürülen görünüm kasıtlı olarak sınırlandırılmış ve güvenlik filtresinden geçirilmiştir:

• assistant metni geri çağırmadan önce normalize edilir:
  • thinking etiketleri kaldırılır
  • <relevant-memories> / <relevant_memories> iskele blokları kaldırılır
  • <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls> ve <function_calls>...</function_calls> gibi düz metin araç çağrısı XML yük blokları kaldırılır; düzgün kapanmayan kesilmiş yükler dahil
  • [Tool Call: ...], [Tool Result ...] ve [Historical context ...] gibi indirgenmiş araç çağrısı/sonucu iskeleleri kaldırılır
  • <|assistant|>, diğer ASCII <|...|> token’ları ve tam genişlikli <｜...｜> varyantları gibi sızmış model kontrol token’ları kaldırılır
  • <invoke ...> / </minimax:tool_call> gibi hatalı MiniMax araç çağrısı XML’i kaldırılır
• kimlik bilgisi/token benzeri metin, döndürülmeden önce redakte edilir
• uzun metin blokları kısaltılır
• çok büyük geçmişlerde daha eski satırlar düşürülebilir veya aşırı büyük bir satır [sessions_history omitted: message too large] ile değiştirilebilir
• araç; truncated, droppedMessages, contentTruncated, contentRedacted ve bytes gibi özet bayraklar bildirir

Her iki araç da bir oturum anahtarını (örneğin "main") veya önceki bir liste çağrısından gelen bir oturum kimliğini kabul eder. Tam bayt düzeyinde transkripte ihtiyacınız varsa, sessions_history çıktısını ham döküm gibi ele almak yerine diskteki transkript dosyasını inceleyin.

​

Oturumlar arası mesaj gönderme

sessions_send, başka bir oturuma mesaj teslim eder ve isteğe bağlı olarak yanıtı bekler:

• Gönder ve unut: kuyruğa ekleyip hemen dönmek için timeoutSeconds: 0 ayarlayın.
• Yanıtı bekle: bir zaman aşımı ayarlayın ve yanıtı satır içi alın.

Hedef yanıt verdikten sonra OpenClaw, agent’ların mesajları sırayla değiştirdiği bir reply-back loop çalıştırabilir (en fazla 5 tur). Hedef agent erken durdurmak için REPLY_SKIP yanıtı verebilir.

​

Durum ve orkestrasyon yardımcıları

session_status, geçerli veya görünür başka bir oturum için hafif bir /status eşdeğeri araçtır. Kullanımı, zamanı, model/çalışma zamanı durumunu ve varsa bağlı arka plan görevi bağlamını bildirir. /status gibi, en son transkript kullanım girdisinden seyrek token/önbellek sayaçlarını doldurabilir ve model=default bir oturum başına geçersiz kılmayı temizler. sessions_yield, beklediğiniz takip olayının bir sonraki mesaj olabilmesi için geçerli turu kasıtlı olarak bitirir. Tamamlama sonuçlarının yoklama döngüleri oluşturmadan bir sonraki mesaj olarak gelmesini istediğinizde, alt ajan başlattıktan sonra bunu kullanın. subagents, zaten başlatılmış OpenClaw alt ajanları için kontrol düzlemi yardımcısıdır. Şunları destekler:

• etkin/son çalıştırmaları incelemek için action: "list"
• çalışan bir alt sürece takip yönlendirmesi göndermek için action: "steer"
• tek bir alt süreci veya all değerini durdurmak için action: "kill"

​

Alt ajan başlatma

sessions_spawn, bir arka plan görevi için yalıtılmış bir oturum oluşturur. Her zaman engellemesizdir — runId ve childSessionKey ile hemen döner. Temel seçenekler:

• harici harness agent’ları için runtime: "subagent" (varsayılan) veya "acp".
• alt oturum için model ve thinking geçersiz kılmaları.
• başlatmayı bir sohbet iş parçacığına bağlamak için thread: true (Discord, Slack vb.).
• alt süreçte sandbox zorlamak için sandbox: "require".

Varsayılan yaprak alt ajanlar oturum araçları almaz. maxSpawnDepth >= 2 olduğunda, derinlik-1 orkestratör alt ajanlar ayrıca kendi çocuklarını yönetebilmeleri için sessions_spawn, subagents, sessions_list ve sessions_history alır. Yaprak çalıştırmalar yine de özyineli orkestrasyon araçları almaz. Tamamlandıktan sonra bir duyuru adımı sonucu istekte bulunanın kanalına gönderir. Tamamlama teslimi, varsa bağlı iş parçacığı/konu yönlendirmesini korur ve tamamlama kökeni yalnızca bir kanalı tanımlıyorsa bile OpenClaw, doğrudan teslim için istekte bulunan oturumun depolanmış yolunu (lastChannel / lastTo) yeniden kullanabilir. ACP’ye özgü davranış için bkz. ACP Agents.

​

Görünürlük

Oturum araçları, agent’ın ne görebileceğini sınırlamak için kapsamlandırılır: Varsayılan tree değeridir. Sandbox içindeki oturumlar, yapılandırmadan bağımsız olarak tree ile sınırlandırılır.

​

Daha fazla bilgi

• Session Management — yönlendirme, yaşam döngüsü, bakım
• ACP Agents — harici harness başlatma
• Multi-agent — çoklu agent mimarisi
• Gateway Configuration — oturum aracı yapılandırma ayarları