Alt ajanlar

Alt ajanlar, mevcut bir ajan çalıştırmasından başlatılan arka plan ajan çalıştırmalarıdır. Her biri kendi oturumunda (agent:<agentId>:subagent:<uuid>) çalışır ve tamamlandığında sonucunu istekte bulunan sohbet kanalına duyurur. Her alt ajan çalıştırması bir arka plan görevi olarak izlenir.

Hedefler:

• Araştırmaları, uzun görevleri ve yavaş araç çalışmalarını ana çalıştırmayı engellemeden paralelleştirmek.
• Alt ajanları varsayılan olarak yalıtılmış tutmak (oturum ayrımı, isteğe bağlı korumalı alan).
• Araç yüzeyinin hatalı kullanımını zorlaştırmak: alt ajanlar varsayılan olarak oturum veya mesaj araçlarına sahip değildir.
• Orkestratör kalıpları için yapılandırılabilir iç içe geçme derinliğini desteklemek.

Eğik çizgi komutu

/subagents, geçerli oturumdaki alt ajan çalıştırmalarını inceler:

/subagents list/subagents log <id|#> [limit] [tools]/subagents info <id|#>

/subagents info, çalıştırma meta verilerini (durum, zaman damgaları, oturum kimliği, transkript yolu, temizlik) gösterir. /subagents log, bir çalıştırmanın son sohbet turlarını yazdırır; araç çağrısı/sonuç mesajlarını dahil etmek için tools token'ını ekleyin (varsayılan olarak dahil edilmez). Bir ajan turu içinden sınırlandırılmış, güvenlik filtresinden geçirilmiş bir geri çağırma görünümü için sessions_history kullanın veya ham tam transkript için diskteki transkript yolunu inceleyin.

Control UI'da, yakın zamanda alt çalıştırmaları olan üst oturumların genişletilebilir bir kenar çubuğu satırı vardır. İç içe satırlar alt öğenin durumunu ve çalışma süresini gösterir; bunlardan biri seçildiğinde üst öğe hiyerarşisi korunarak ilgili alt öğenin sohbeti açılır.

İş parçacığı bağlama denetimleri

Bu komutlar kalıcı iş parçacığı bağlamalarını destekleyen kanallarda çalışır. Aşağıdaki İş parçacığını destekleyen kanallar bölümüne bakın.

/focus <subagent-label|session-key|session-id|session-label>/unfocus/agents/session idle <duration|off>/session max-age <duration|off>

Başlatma davranışı

Ajanlar, sessions_spawn aracıyla arka plan alt ajanlarını başlatır. Tamamlanmalar, dahili üst oturum olayları olarak döner; kullanıcıya yönelik bir güncellemenin gerekip gerekmediğine üst/istekte bulunan ajan karar verir.

Bağlam modları

Çağıran açıkça geçerli transkripti çatallamayı istemediği sürece yerel alt ajanlar yalıtılmış olarak başlar.

fork öğesini ölçülü kullanın. Bağlama duyarlı yetkilendirme içindir; net bir görev istemi yazmanın yerine geçmez.

Araç: sessions_spawn

Global subagent hattında deliver: false ile bir alt ajan çalıştırması başlatır, ardından bir duyuru adımı çalıştırır ve duyuru yanıtını istekte bulunan sohbet kanalına gönderir.

Kullanılabilirlik, çağıranın etkin araç politikasına bağlıdır. Yerleşik coding profili sessions_spawn içerir; messaging ve minimal içermez. full her araca izin verir. Daha dar bir profilde olup yine de iş devretmesi gereken ajanlar için tools.alsoAllow: ["sessions_spawn", "sessions_yield", "subagents"] ekleyin veya tools.profile: "coding" kullanın. Kanal/grup, sağlayıcı, korumalı alan ve ajan başına izin/verme politikaları, profil aşamasından sonra da aracı kaldırabilir. Etkin araç listesini doğrulamak için aynı oturumdan /tools kullanın.

Varsayılanlar:

• Model: agents.defaults.subagents.model (veya ajan başına agents.list[].subagents.model) ayarlamadığınız sürece yerel alt ajanlar çağıranın modelini devralır. ACP çalışma zamanı başlatmaları, yapılandırılmış alt ajan modeli varsa aynı modeli kullanır; aksi hâlde ACP koşumu kendi varsayılanını korur. Açık bir sessions_spawn.model yine önceliklidir.
• Düşünme: agents.defaults.subagents.thinking (veya ajan başına agents.list[].subagents.thinking) ayarlamadığınız sürece yerel alt ajanlar çağıranın ayarını devralır. ACP çalışma zamanı başlatmaları da seçilen model için agents.defaults.models["provider/model"].params.thinking uygular. Açık bir sessions_spawn.thinking yine önceliklidir.
• Çalıştırma zaman aşımı: OpenClaw, ayarlanmışsa agents.defaults.subagents.runTimeoutSeconds kullanır; aksi hâlde 0 değerine geri döner (zaman aşımı yoktur). sessions_spawn, çağrı başına zaman aşımı geçersiz kılmalarını kabul etmez.
• Görev teslimi: yerel alt ajanlar, devredilen görevi ilk görünür [Subagent Task] mesajlarında alır. Alt ajan sistem istemi, görevin gizli bir kopyasını değil, çalışma zamanı kurallarını ve yönlendirme bağlamını taşır.

Kabul edilen yerel alt ajan başlatmaları, araç sonucunda çözümlenmiş alt öğe modelinin meta verilerini içerir: resolvedModel uygulanan model başvurusunu, resolvedProvider ise başvuruda varsa sağlayıcı önekini içerir.

Yetkilendirme istemi modu

agents.defaults.subagents.delegationMode yalnızca istem yönlendirmesini denetler; araç politikasını değiştirmez veya yetkilendirmeyi zorunlu kılmaz.

• suggest (varsayılan): daha büyük veya yavaş işler için alt ajan kullanmaya yönelik standart istem yönlendirmesini korur.
• prefer: ana ajana yanıt vermeye devam etmesini ve doğrudan yanıttan daha kapsamlı her işi sessions_spawn aracılığıyla devretmesini söyler.

Ajan başına geçersiz kılma: agents.list[].subagents.delegationMode.

{  agents: {    defaults: {      subagents: {        delegationMode: "prefer",        maxConcurrent: 4,      },    },    list: [      {        id: "coordinator",        subagents: { delegationMode: "prefer" },      },    ],  },}

Araç parametreleri

Görev adları ve hedefleme

taskName, oturum anahtarı değil, orkestrasyon için modele yönelik bir tanıtıcıdır. Bir koordinatörün daha sonra ilgili alt öğeyi incelemesi gerekebilecek durumlarda review_subagents, linux_validation veya docs_update gibi kararlı alt öğe adları için kullanın.

Hedef çözümleme, tam taskName eşleşmelerini ve belirsiz olmayan önekleri kabul eder. Eşleştirme, numaralı /subagents hedeflerinin kullandığı aynı etkin/yakın tarihli hedef penceresiyle sınırlıdır; dolayısıyla eski, tamamlanmış bir alt öğe, yeniden kullanılan bir tanıtıcıyı belirsiz hâle getirmez. İki etkin veya yakın tarihli alt öğe aynı taskName değerini paylaşıyorsa hedef belirsizdir; bunun yerine liste dizinini, oturum anahtarını veya çalıştırma kimliğini kullanın.

Ayrılmış last ve all hedefleri, zaten denetim anlamları taşıdıklarından geçerli taskName değerleri değildir.

Araç: sessions_yield

Geçerli model dönüşünü sonlandırır ve başta alt aracı tamamlanma olayları olmak üzere çalışma zamanı olaylarının bir sonraki ileti olarak gelmesini bekler. İstekte bulunan, bu tamamlanma olayları gelmeden nihai yanıt üretemiyorsa gerekli alt çalışma oluşturulduktan sonra bunu kullanın.

sessions_yield, bekleme temel işlemidir. Yalnızca alt öğenin tamamlandığını algılamak için bunu subagents, sessions_list, sessions_history, kabuk sleep veya süreç yoklaması üzerindeki yoklama döngüleriyle değiştirmeyin.

sessions_yield aracını yalnızca oturumun etkin araç listesinde bulunduğunda kullanın. Bazı asgari veya özel araç profilleri sessions_spawn ve subagents araçlarını sunarken sessions_yield aracını sunmayabilir; bu durumda, yalnızca tamamlanmayı beklemek için bir yoklama döngüsü uydurmayın.

Etkin alt öğeler bulunduğunda OpenClaw, istekte bulunanın mevcut alt oturumları, çalıştırma kimliklerini, durumları, etiketleri, görevleri ve taskName diğer adlarını yoklama yapmadan görebilmesi için normal dönüşlere çalışma zamanında oluşturulan kompakt bir Active Subagents istem bloğu ekler. Bu bloktaki görev ve etiket alanları talimat olarak değil, veri olarak tırnak içine alınır; çünkü kullanıcı/model tarafından sağlanan oluşturma bağımsız değişkenlerinden gelebilirler.

Araç: subagents

İstekte bulunan oturumun sahip olduğu oluşturulmuş alt aracı çalıştırmalarını listeler. Kapsamı geçerli istekte bulunanla sınırlıdır; bir alt öğe yalnızca kendi denetimindeki alt öğeleri görebilir.

İsteğe bağlı durum ve hata ayıklama için subagents kullanın. Tamamlanma olaylarını beklemek için sessions_yield kullanın.

İletişim dizisine bağlı oturumlar

Bir kanal için iletişim dizisi bağlamaları etkinleştirildiğinde, bir alt aracı iletişim dizisine bağlı kalabilir; böylece bu iletişim dizisindeki sonraki kullanıcı iletileri aynı alt aracı oturumuna yönlendirilmeye devam eder.

İletişim dizisini destekleyen kanallar

Bir kanal, konuşma bağlama bağdaştırıcısı kaydettiğinde kalıcı, iletişim dizisine bağlı alt aracı oturumlarını (sessions_spawn ile thread: true) destekler. Bu desteği içeren paketlenmiş kanallar: Discord, iMessage, Matrix ve Telegram. Discord ve Matrix varsayılan olarak bir alt iletişim dizisi oluşturur; Telegram ve iMessage varsayılan olarak geçerli konuşmayı bağlar. Etkinleştirme, zaman aşımları ve spawnSessions için kanal başına threadBindings yapılandırma anahtarlarını kullanın.

Hızlı akış

El ile denetimler

Yapılandırma anahtarları

• Genel varsayılan: session.threadBindings.enabled, session.threadBindings.idleHours, session.threadBindings.maxAgeHours.
• Kanal geçersiz kılma ve oluşturma sırasında otomatik bağlama anahtarları bağdaştırıcıya özeldir. Yukarıdaki İletişim dizisini destekleyen kanallar bölümüne bakın.

Geçerli bağdaştırıcı ayrıntıları için Yapılandırma başvurusu ve Eğik çizgi komutları bölümlerine bakın.

İzin verilenler listesi

İstekte bulunan oturum korumalı alandaysa sessions_spawn, korumalı alan olmadan çalışacak hedefleri reddeder.

Keşif

sessions_spawn için şu anda hangi aracı kimliklerine izin verildiğini görmek üzere agents_list kullanın. Yanıt, çağıranların OpenClaw, Codex uygulama sunucusu ve yapılandırılmış diğer yerel çalışma zamanlarını ayırt edebilmesi için listelenen her aracının etkin modelini ve gömülü çalışma zamanı meta verilerini içerir.

allowAgents girdileri, agents.list[] içindeki yapılandırılmış aracı kimliklerini göstermelidir. ["*"], yapılandırılmış herhangi bir hedef aracıya ve istekte bulunana izin verir. Bir aracı yapılandırması silinmesine rağmen kimliği allowAgents içinde kalırsa sessions_spawn bu kimliği reddeder ve agents_list bunu atlar. Eski izin verilenler listesi girdilerini temizlemek için openclaw doctor --fix çalıştırın veya hedefin varsayılanları devralırken oluşturulabilir kalması gerekiyorsa asgari bir agents.list[] girdisi ekleyin.

Otomatik arşivleme

• Alt aracı oturumları agents.defaults.subagents.archiveAfterMinutes sonrasında otomatik olarak arşivlenir (varsayılan 60).
• Arşiv, sessions.delete kullanır ve dökümü *.deleted.<timestamp> olarak yeniden adlandırır (aynı klasör).
• cleanup: "delete", duyurudan hemen sonra arşivler (dökümü yeniden adlandırarak saklamaya devam eder).
• Otomatik arşivleme en iyi çaba esasına dayanır; Gateway yeniden başlatılırsa bekleyen zamanlayıcılar kaybolur.
• Yapılandırılmış çalıştırma zaman aşımları otomatik arşivleme yapmaz; yalnızca çalıştırmayı durdurur. Oturum, otomatik arşivlemeye kadar kalır.
• Otomatik arşivleme, derinlik 1 ve derinlik 2 oturumlarına eşit şekilde uygulanır.
• Tarayıcı temizliği, arşiv temizliğinden ayrıdır: döküm/oturum kaydı saklansa bile çalıştırma tamamlandığında izlenen tarayıcı sekmeleri/süreçleri en iyi çaba esasına göre kapatılır.

İç içe alt aracılar

Varsayılan olarak alt aracılar kendi alt aracılarını oluşturamaz (maxSpawnDepth: 1). Tek düzey iç içe geçmeyi etkinleştirmek için maxSpawnDepth: 2 ayarını kullanın — orkestratör kalıbı: ana → orkestratör alt aracısı → çalışan alt-alt aracılar.

{  agents: {    defaults: {      subagents: {        maxSpawnDepth: 2, // alt aracıların alt öğeler oluşturmasına izin ver (varsayılan: 1, aralık 1-5)        maxChildrenPerAgent: 5, // aracı oturumu başına en fazla etkin alt öğe (varsayılan: 5, aralık 1-20)        maxConcurrent: 8, // genel eşzamanlılık şeridi üst sınırı (varsayılan: 8)        runTimeoutSeconds: 900, // sessions_spawn için varsayılan zaman aşımı (0 = zaman aşımı yok)        announceTimeoutMs: 120000, // çağrı başına Gateway duyuru zaman aşımı      },    },  },}

Derinlik düzeyleri

Duyuru zinciri

Sonuçlar zincir boyunca yukarı doğru akar:

1. Derinlik 2 çalışanı tamamlanır → üst öğesine (derinlik 1 orkestratörü) duyurur.
2. Derinlik 1 orkestratörü duyuruyu alır, sonuçları sentezler ve tamamlanır → ana ajana duyurur.
3. Ana ajan duyuruyu alır ve kullanıcıya iletir.

Her düzey yalnızca doğrudan alt öğelerinden gelen duyuruları görür.

Derinliğe göre araç politikası

• Rol ve denetim kapsamı, başlatma sırasında oturum meta verilerine yazılır. Bu, düzleştirilmiş veya geri yüklenmiş oturum anahtarlarının yanlışlıkla orkestratör ayrıcalıklarını yeniden kazanmasını önler.
• Derinlik 1 (orkestratör, maxSpawnDepth >= 2 olduğunda): alt öğeleri başlatabilmesi ve durumlarını inceleyebilmesi için sessions_spawn, subagents, sessions_list, sessions_history araçlarını alır. Diğer oturum/sistem araçları reddedilmeye devam eder.
• Derinlik 1 (uç, maxSpawnDepth == 1 olduğunda): oturum aracı yoktur (mevcut varsayılan davranış).
• Derinlik 2 (uç çalışan): oturum aracı yoktur — sessions_spawn, derinlik 2'de her zaman reddedilir. Başka alt öğeler başlatamaz.

Ajan başına başlatma sınırı

Her ajan oturumu (herhangi bir derinlikte) aynı anda en fazla maxChildrenPerAgent (varsayılan 5) etkin alt öğeye sahip olabilir. Bu, tek bir orkestratörden denetimsiz yayılmayı önler.

Kademeli durdurma

Bir derinlik 1 orkestratörünün durdurulması, tüm derinlik 2 alt öğelerini otomatik olarak durdurur:

• Ana sohbetteki /stop, tüm derinlik 1 ajanlarını durdurur ve durdurmayı onların derinlik 2 alt öğelerine yayar.

Kimlik doğrulama

Alt ajan kimlik doğrulaması, oturum türüne göre değil ajan kimliğine göre çözümlenir:

• Alt ajan oturum anahtarı agent:<agentId>:subagent:<uuid> şeklindedir.
• Kimlik doğrulama deposu, bu ajanın agentDir konumundan yüklenir.
• Ana ajanın kimlik doğrulama profilleri geri dönüş olarak birleştirilir; çakışmalarda ajan profilleri ana profilleri geçersiz kılar.

Birleştirme eklemelidir; dolayısıyla ana profiller her zaman geri dönüş olarak kullanılabilir. Ajan başına tamamen yalıtılmış kimlik doğrulama henüz desteklenmemektedir.

Duyuru

Alt ajanlar bir duyuru adımıyla geri bildirimde bulunur:

• Duyuru adımı, istekte bulunan oturumda değil alt ajan oturumunda çalışır.
• Alt ajan tam olarak ANNOUNCE_SKIP yanıtını verirse hiçbir şey gönderilmez.
• En son asistan metni tam olarak NO_REPLY / no_reply sessiz belirteciyse, daha önce görünür ilerleme bulunmuş olsa bile duyuru çıktısı engellenir.

Teslimat, istekte bulunanın derinliğine bağlıdır:

• Üst düzey istekte bulunan oturumlar, harici teslimatla (deliver=true) bir takip agent çağrısı kullanır.
• İç içe istekte bulunan alt ajan oturumları, orkestratörün alt öğe sonuçlarını oturum içinde sentezleyebilmesi için dahili bir takip eklemesi (deliver=false) alır.
• İç içe istekte bulunan alt ajan oturumu artık mevcut değilse OpenClaw, kullanılabilir olduğunda o oturumun istekte bulunanına geri döner.

Üst düzey istekte bulunan oturumlar için tamamlanma modu doğrudan teslimatı, önce bağlı konuşma/konu rotasını ve kanca geçersiz kılmasını çözümler, ardından eksik kanal-hedef alanlarını istekte bulunan oturumun depolanmış rotasından doldurur. Bu, tamamlanma kaynağı yalnızca kanalı tanımlasa bile tamamlanmaları doğru sohbette/konuda tutar.

İç içe tamamlanma bulguları oluşturulurken alt öğe tamamlanma toplaması, mevcut istekte bulunan çalışmasıyla sınırlandırılır; böylece önceki çalışmalara ait eski alt öğe çıktılarının mevcut duyuruya sızması önlenir. Duyuru yanıtları, kanal bağdaştırıcılarında mevcut olduğunda ileti dizisi/konu yönlendirmesini korur.

Duyuru bağlamı

Duyuru bağlamı, kararlı bir dahili olay bloğuna normalleştirilir:

Terminalde başarısız olan çalışmalar, yakalanan yanıt metnini yeniden oynatmadan başarısızlık durumunu bildirir. Araç/araç sonucu çıktısı, alt öğe sonuç metnine yükseltilmez.

İstatistik satırı

Duyuru yükleri, sarmalanmış olsalar bile sonda bir istatistik satırı içerir:

• Çalışma süresi (ör. runtime 5m12s).
• Belirteç kullanımı (girdi/çıktı/toplam).
• Model fiyatlandırması yapılandırıldığında tahmini maliyet (models.providers.*.models[].cost).
• Ana ajanın sessions_history aracılığıyla geçmişi alabilmesi veya diskteki dosyayı inceleyebilmesi için sessionKey, sessionId ve döküm yolu.

Dahili meta veriler yalnızca orkestrasyon içindir; kullanıcıya yönelik yanıtlar normal asistan üslubuyla yeniden yazılmalıdır.

Neden sessions_history tercih edilmeli?

sessions_history, bir ajan turu içinden alt öğenin dökümünü okumak için daha güvenli orkestrasyon yoludur:

• Genel amaçlı günlük redaksiyonu devre dışı olsa bile kimlik bilgisi/belirteç benzeri metinleri karartır.
• Uzun metin bloklarını kısaltır (blok başına 4000 karakter) ve düşünme imzalarını, muhakeme yeniden oynatma yüklerini ve satır içi görüntü verilerini kaldırır.
• 80 KB yanıt sınırı uygular; aşırı büyük satırlar [sessions_history omitted: message too large] ile değiştirilir.
• Eski döküm pencerelerinde geriye doğru sayfalamak için mevcut olduğunda nextOffset kullanın.
• sessions_history, muhakeme etiketlerini, <relevant-memories> iskelesini veya araç çağrısı XML'ini ileti metninden kaldırmaz — yalnızca karartılmış ve boyutu sınırlandırılmış şekilde, ham döküm biçimine yakın yapılandırılmış içerik blokları döndürür. /subagents log, yapılandırılmış bloklar yerine düz sohbet satırları oluşturduğu için daha kapsamlı düz yazı temizleyicisini uygular (muhakeme etiketlerini, bellek iskelesini ve araç çağrısı XML'ini kaldırır).
• Bayt bayt tam döküme ihtiyaç duyduğunuzda ham disk üzerindeki dökümü incelemek geri dönüş seçeneğidir.

Araç politikası

Alt ajanlar önce üst veya hedef ajanla aynı profil ve araç politikası işlem hattını kullanır. Bundan sonra OpenClaw, alt ajan kısıtlama katmanını uygular.

Alt ajanlar; derinlik veya rolden bağımsız olarak gateway, agents_list, session_status ve cron araçlarını her zaman kaybeder (sistem düzeyinde/etkileşimli araçlar veya ana ajanın koordine etmesi gereken araçlar). Uç alt ajanlar (varsayılan derinlik 1 davranışı ve derinlik 2'de her zaman) ayrıca subagents, sessions_list, sessions_history ve sessions_spawn araçlarını kaybeder. Alt ajanlar message aracını hiçbir zaman almaz — bu araç, bu ret listesiyle filtrelenmek yerine başlatma sırasında devre dışı bırakılır — ve alt ajanların yalnızca duyuru zinciri üzerinden iletişim kurması için sessions_send reddedilmeye devam eder.

sessions_history burada da sınırlandırılmış, temizlenmiş bir hatırlama görünümü olarak kalır — ham döküm değildir.

maxSpawnDepth >= 2 olduğunda, derinlik 1 orkestratör alt ajanları alt öğelerini yönetebilmeleri için ayrıca sessions_spawn, subagents, sessions_list ve sessions_history araçlarını alır.

Yapılandırmayla geçersiz kılma

{  agents: {    defaults: {      subagents: {        maxConcurrent: 1,      },    },  },  tools: {    subagents: {      tools: {        // ret önceliklidir        deny: ["gateway", "cron"],        // izin ayarlanırsa yalnızca izin verilenler geçerli olur (ret yine önceliklidir)        // allow: ["read", "exec", "process"]      },    },  },}

tools.subagents.tools.allow, yalnızca izin veren son bir filtredir. Önceden çözümlenmiş araç kümesini daraltabilir ancak tools.profile tarafından kaldırılan bir aracı geri ekleyemez. Örneğin tools.profile: "coding", web_search/web_fetch içerir ancak browser aracını içermez. Kodlama profilli alt ajanların tarayıcı otomasyonunu kullanmasını sağlamak için tarayıcıyı profil aşamasında ekleyin:

{  tools: {    profile: "coding",    alsoAllow: ["browser"],  },}

Yalnızca bir ajanın tarayıcı otomasyonu alması gerekiyorsa ajan başına agents.list[].tools.alsoAllow: ["browser"] kullanın.

Eşzamanlılık

Alt ajanlar özel bir işlem içi kuyruk şeridi kullanır:

• Şerit adı: subagent
• Eşzamanlılık: agents.defaults.subagents.maxConcurrent (varsayılan 8)

Canlılık ve kurtarma

OpenClaw, endedAt yokluğunu bir alt ajanın hâlâ canlı olduğuna dair kalıcı kanıt olarak kabul etmez. Eski çalışma penceresinden daha eski olan sonlandırılmamış çalışmalar (2 saat veya yapılandırılmış çalışma zaman aşımı ile kısa bir ek sürenin toplamı; hangisi daha uzunsa) /subagents list içindeki etkin/beklemede sayımlarında, durum özetlerinde, alt öğe tamamlanma geçitlerinde ve oturum başına eşzamanlılık denetimlerinde artık hesaba katılmaz.

Gateway yeniden başlatıldıktan sonra, alt öğe oturumu abortedLastRun: true olarak işaretlenmemişse eski ve sonlandırılmamış geri yüklenmiş çalışmalar budanır. Yeniden başlatma nedeniyle iptal edilen çalışmalar, alt ajan yetim kurtarma akışı için kayıtlı kalır: eski çalışmalar devam ettirilmeden sonlandırılırken yeni alt öğe oturumları, iptal işareti temizlenmeden önce yapay bir devam ettirme iletisi alır.

Otomatik yeniden başlatma kurtarması, alt öğe oturumu başına sınırlandırılmıştır. Aynı alt ajan alt öğesi hızlı yeniden kilitlenme penceresi içinde yetim kurtarma için tekrar tekrar kabul edilirse OpenClaw, bu oturumda kalıcı bir kurtarma mezar taşı tutar ve sonraki yeniden başlatmalarda otomatik olarak devam ettirmeyi durdurur. Görev kaydını uzlaştırmak için openclaw tasks maintenance --apply veya mezar taşı bulunan oturumlardaki eski iptal edilmiş kurtarma işaretlerini temizlemek için openclaw doctor --fix komutunu çalıştırın.

Durdurma

• İstek sahibi sohbette /stop göndermek, istek sahibi oturumu iptal eder ve bu oturumdan oluşturulan tüm etkin alt ajan çalıştırmalarını durdurarak işlemi iç içe alt öğelere yayar.

Sınırlamalar

• Alt ajan duyurusu mümkün olan en iyi çabayla gerçekleştirilir. Gateway yeniden başlatılırsa bekleyen "geri duyur" işi kaybolur.
• Alt ajanlar yine aynı Gateway işlemi kaynaklarını paylaşır; maxConcurrent değerini bir emniyet valfi olarak değerlendirin.
• sessions_spawn her zaman engellemesizdir: { status: "accepted", runId, childSessionKey } değerini hemen döndürür.
• Alt ajan bağlamı yalnızca AGENTS.md ve TOOLS.md öğelerini ekler (SOUL.md, IDENTITY.md, USER.md, MEMORY.md, HEARTBEAT.md veya BOOTSTRAP.md eklenmez). Codex'e özgü alt ajanlar aynı sınırı izler: TOOLS.md devralınan Codex iş parçacığı talimatlarında kalırken, yalnızca üst öğeye ait persona, kimlik ve kullanıcı dosyaları dönüş kapsamlı iş birliği talimatları olarak eklenir; böylece alt öğeler bunları klonlamaz.
• En fazla iç içe yerleştirme derinliği 5'tir (maxSpawnDepth aralığı: 1-5). Çoğu kullanım durumu için 2 derinliği önerilir.
• maxChildrenPerAgent, oturum başına etkin alt öğe sayısını sınırlar (varsayılan 5, aralık 1-20).

İlgili

• Oturum araçları ve durum değişiklikleri
• ACP ajanları
• Ajan gönderimi
• Arka plan görevleri
• Çok ajanlı korumalı alan araçları