उप-एजेंट

• मुख्य रन को ब्लॉक किए बिना “शोध / लंबा कार्य / धीमा टूल” काम को समानांतर करना।
• उप-एजेंट को डिफ़ॉल्ट रूप से अलग रखना (सत्र पृथक्करण + वैकल्पिक सैंडबॉक्सिंग)।
• टूल सतह को दुरुपयोग के लिए कठिन रखना: उप-एजेंट को डिफ़ॉल्ट रूप से सत्र टूल नहीं मिलते।
• ऑर्केस्ट्रेटर पैटर्न के लिए कॉन्फ़िगर योग्य नेस्टिंग गहराई का समर्थन करना।

​

स्लैश कमांड

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

​

थ्रेड बाइंडिंग नियंत्रण

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

​

स्पॉन व्यवहार

​

संदर्भ मोड

​

टूल: sessions_spawn

• मॉडल: नेटिव उप-एजेंट कॉलर से विरासत में लेते हैं, जब तक आप agents.defaults.subagents.model (या प्रति-एजेंट agents.list[].subagents.model) सेट नहीं करते। ACP रनटाइम स्पॉन मौजूद होने पर वही कॉन्फ़िगर किया गया उप-एजेंट मॉडल उपयोग करते हैं; अन्यथा ACP हार्नेस अपना डिफ़ॉल्ट रखता है। स्पष्ट sessions_spawn.model फिर भी जीतता है।
• Thinking: नेटिव उप-एजेंट कॉलर से विरासत में लेते हैं, जब तक आप agents.defaults.subagents.thinking (या प्रति-एजेंट agents.list[].subagents.thinking) सेट नहीं करते। ACP रनटाइम स्पॉन चयनित मॉडल के लिए agents.defaults.models["provider/model"].params.thinking भी लागू करते हैं। स्पष्ट sessions_spawn.thinking फिर भी जीतता है।
• रन टाइमआउट: सेट होने पर OpenClaw agents.defaults.subagents.runTimeoutSeconds का उपयोग करता है; अन्यथा यह 0 (कोई टाइमआउट नहीं) पर वापस जाता है। sessions_spawn प्रति-कॉल टाइमआउट ओवरराइड स्वीकार नहीं करता।
• कार्य डिलीवरी: नेटिव उप-एजेंट को उनका डेलीगेट किया गया कार्य उनके पहले दृश्य [Subagent Task] संदेश में मिलता है। उप-एजेंट system प्रॉम्प्ट रनटाइम नियम और रूटिंग संदर्भ रखता है, कार्य की छिपी हुई डुप्लिकेट प्रति नहीं।

​

डेलीगेशन प्रॉम्प्ट मोड

• suggest (डिफ़ॉल्ट): बड़े या धीमे काम के लिए उप-एजेंट उपयोग करने का मानक प्रॉम्प्ट संकेत रखें।
• prefer: मुख्य एजेंट को प्रतिक्रियाशील रहने और सीधे उत्तर से अधिक विस्तृत किसी भी चीज़ को sessions_spawn के माध्यम से डेलीगेट करने को कहें।

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

​

टूल पैरामीटर

​

Task names और targeting

​

Tool: sessions_yield

​

Tool: subagents

​

Thread-bound sessions

​

Thread supporting channels

​

Quick flow

​

Manual controls

​

Config switches

• Global default: session.threadBindings.enabled, session.threadBindings.idleHours, session.threadBindings.maxAgeHours.
• Channel override और spawn auto-bind keys adapter-specific हैं। ऊपर Thread supporting channels देखें।

​

Allowlist

​

Discovery

​

Auto-archive

• Sub-agent sessions agents.defaults.subagents.archiveAfterMinutes (default 60) के बाद automatically archived हो जाते हैं।
• Archive sessions.delete का उपयोग करता है और transcript को *.deleted.<timestamp> (same folder) में rename करता है।
• cleanup: "delete" announce के तुरंत बाद archives करता है (फिर भी rename के जरिए transcript रखता है)।
• Auto-archive best-effort है; gateway restart होने पर pending timers खो जाते हैं।
• Configured run timeouts auto-archive नहीं करते; वे केवल run को रोकते हैं। Session auto-archive तक रहता है।
• Auto-archive depth-1 और depth-2 sessions पर समान रूप से लागू होता है।
• Browser cleanup archive cleanup से अलग है: tracked browser tabs/processes run finishes होने पर best-effort close किए जाते हैं, भले ही transcript/session record रखा गया हो।

​

Nested sub-agents

{
  agents: {
    defaults: {
      subagents: {
        maxSpawnDepth: 2, // allow sub-agents to spawn children (default: 1)
        maxChildrenPerAgent: 5, // max active children per agent session (default: 5)
        maxConcurrent: 8, // global concurrency lane cap (default: 8)
        runTimeoutSeconds: 900, // default timeout for sessions_spawn (0 = no timeout)
        announceTimeoutMs: 120000, // per-call gateway announce timeout
      },
    },
  },
}

​

Depth levels

​

Announce chain

1. गहराई-2 कार्यकर्ता समाप्त होता है → अपने पैरेंट (गहराई-1 संयोजक) को घोषणा करता है।
2. गहराई-1 संयोजक घोषणा प्राप्त करता है, परिणामों को संश्लेषित करता है, समाप्त होता है → मुख्य को घोषणा करता है।
3. मुख्य एजेंट घोषणा प्राप्त करता है और उपयोगकर्ता को वितरित करता है।

​

गहराई के अनुसार टूल नीति

• भूमिका और नियंत्रण दायरा स्पॉन समय पर सेशन मेटाडेटा में लिखे जाते हैं। इससे फ्लैट या बहाल सेशन कुंजियां गलती से संयोजक विशेषाधिकार फिर से प्राप्त नहीं करतीं।
• गहराई 1 (संयोजक, जब maxSpawnDepth >= 2): sessions_spawn, subagents, sessions_list, sessions_history प्राप्त करता है ताकि यह बच्चों को स्पॉन कर सके और उनकी स्थिति जांच सके। अन्य सेशन/सिस्टम टूल अस्वीकृत रहते हैं।
• गहराई 1 (लीफ, जब maxSpawnDepth == 1): कोई सेशन टूल नहीं (वर्तमान डिफ़ॉल्ट व्यवहार)।
• गहराई 2 (लीफ कार्यकर्ता): कोई सेशन टूल नहीं — sessions_spawn गहराई 2 पर हमेशा अस्वीकृत होता है। आगे बच्चे स्पॉन नहीं कर सकता।

​

प्रति-एजेंट स्पॉन सीमा

​

कैस्केड स्टॉप

• मुख्य चैट में /stop सभी गहराई-1 एजेंटों को रोकता है और उनके गहराई-2 बच्चों तक कैस्केड करता है।

​

प्रमाणीकरण

• उप-एजेंट सेशन कुंजी agent:<agentId>:subagent:<uuid> है।
• auth स्टोर उस एजेंट के agentDir से लोड होता है।
• मुख्य एजेंट की auth प्रोफ़ाइलें fallback के रूप में मर्ज की जाती हैं; टकराव पर एजेंट प्रोफ़ाइलें मुख्य प्रोफ़ाइलों को ओवरराइड करती हैं।

​

घोषणा

• घोषणा चरण उप-एजेंट सेशन के अंदर चलता है (अनुरोधकर्ता सेशन में नहीं)।
• अगर उप-एजेंट ठीक ANNOUNCE_SKIP जवाब देता है, तो कुछ भी पोस्ट नहीं होता।
• अगर नवीनतम असिस्टेंट टेक्स्ट सटीक मौन टोकन NO_REPLY / no_reply है, तो घोषणा आउटपुट दबा दिया जाता है, भले ही पहले दृश्य प्रगति मौजूद रही हो।

• शीर्ष-स्तरीय अनुरोधकर्ता सेशन बाहरी डिलीवरी (deliver=true) के साथ अनुवर्ती agent कॉल का उपयोग करते हैं।
• नेस्टेड अनुरोधकर्ता उप-एजेंट सेशन आंतरिक अनुवर्ती इंजेक्शन (deliver=false) प्राप्त करते हैं ताकि संयोजक चाइल्ड परिणामों को सेशन के अंदर संश्लेषित कर सके।
• अगर कोई नेस्टेड अनुरोधकर्ता उप-एजेंट सेशन चला गया है, तो उपलब्ध होने पर OpenClaw उस सेशन के अनुरोधकर्ता पर fallback करता है।

​

घोषणा संदर्भ

​

आँकड़ों की पंक्ति

• Runtime (जैसे runtime 5m12s)।
• टोकन उपयोग (input/output/total)।
• मॉडल मूल्य निर्धारण कॉन्फ़िगर होने पर अनुमानित लागत (models.providers.*.models[].cost)।
• sessionKey, sessionId, और transcript path ताकि मुख्य एजेंट sessions_history के माध्यम से history ला सके या डिस्क पर फ़ाइल inspect कर सके।

​

sessions_history को प्राथमिकता क्यों दें

• असिस्टेंट recall पहले सामान्यीकृत किया जाता है: thinking tags हटाए जाते हैं; <relevant-memories> / <relevant_memories> scaffolding हटाई जाती है; plain-text tool-call XML payload blocks (<tool_call>, <function_call>, <tool_calls>, <function_calls>) हटाए जाते हैं, उन truncated payloads सहित जो साफ़ तौर पर कभी बंद नहीं होते; downgraded tool-call/result scaffolding और historical-context markers हटाए जाते हैं; leaked model control tokens (<|assistant|>, अन्य ASCII <|...|>, full-width <｜...｜>) हटाए जाते हैं; malformed MiniMax tool-call XML हटाया जाता है।
• Credential/token-जैसा टेक्स्ट redact किया जाता है।
• लंबे blocks truncate किए जा सकते हैं।
• बहुत बड़े histories पुराने rows drop कर सकते हैं या oversized row को [sessions_history omitted: message too large] से बदल सकते हैं।
• पुराने transcript windows में पीछे की ओर page करने के लिए मौजूद होने पर nextOffset का उपयोग करें।
• Raw on-disk transcript inspection fallback है जब आपको पूर्ण byte-for-byte transcript चाहिए।

​

टूल नीति

• sessions_list
• sessions_history
• sessions_send
• sessions_spawn
• message

​

config के माध्यम से override

{
  agents: {
    defaults: {
      subagents: {
        maxConcurrent: 1,
      },
    },
  },
  tools: {
    subagents: {
      tools: {
        // deny wins
        deny: ["gateway", "cron"],
        // if allow is set, it becomes allow-only (deny still wins)
        // allow: ["read", "exec", "process"]
      },
    },
  },
}

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

​

Concurrency

• Lane name: subagent
• Concurrency: agents.defaults.subagents.maxConcurrent (डिफ़ॉल्ट 8)

​

Liveness और recovery

​

रोकना

• अनुरोधकर्ता चैट में /stop भेजने से अनुरोधकर्ता सेशन abort होता है और उससे spawned किसी भी सक्रिय sub-agent runs को रोकता है, nested बच्चों तक cascade करते हुए।

​

सीमाएं

• उप-एजेंट घोषणा best-effort है। अगर gateway restart होता है, तो लंबित “announce back” कार्य खो जाता है।
• उप-एजेंट अभी भी वही gateway process resources साझा करते हैं; maxConcurrent को safety valve मानें।
• sessions_spawn हमेशा non-blocking है: यह तुरंत { status: "accepted", runId, childSessionKey } लौटाता है।
• उप-एजेंट संदर्भ केवल AGENTS.md और TOOLS.md inject करता है (कोई SOUL.md, IDENTITY.md, USER.md, MEMORY.md, HEARTBEAT.md, या BOOTSTRAP.md नहीं)। Codex-native subagents समान boundary का पालन करते हैं: TOOLS.md inherited Codex thread instructions में रहता है, जबकि parent-only persona, identity, और user files turn-scoped collaboration instructions के रूप में inject किए जाते हैं ताकि बच्चे उन्हें clone न करें।
• अधिकतम nesting depth 5 है (maxSpawnDepth range: 1–5)। अधिकांश use cases के लिए depth 2 recommended है।
• maxChildrenPerAgent प्रति session active children cap करता है (डिफ़ॉल्ट 5, range 1–20)।

​

संबंधित

• ACP एजेंट
• एजेंट send
• Background tasks
• Multi-agent sandbox tools