सत्र टूल्स

OpenClaw एजेंटों को सत्रों के बीच काम करने, स्थिति का निरीक्षण करने और उप-एजेंटों का समन्वय करने के लिए टूल देता है।

उपलब्ध टूल

ये टूल अब भी सक्रिय टूल प्रोफ़ाइल और अनुमति/निषेध नीति के अधीन हैं। tools.profile: "coding" में पूरा सत्र समन्वय सेट शामिल है। tools.profile: "messaging" में सत्र स्व-सेवा, खोज, पुनःस्मरण, अंतर-सत्र संदेश-प्रेषण, बाहरी-वार्तालाप टूल और पूर्ण आरंभ जीवनचक्र (sessions_spawn, sessions_yield, और subagents) शामिल हैं। केवल UI वाले कार्य-सुझाव टूल spawn_task और dismiss_task कोडिंग-प्रोफ़ाइल टूल बने रहते हैं।

समूह, प्रदाता, सैंडबॉक्स और प्रति-एजेंट नीतियाँ प्रोफ़ाइल चरण के बाद भी उन टूल को हटा सकती हैं। प्रभावी टूल सूची का निरीक्षण करने के लिए प्रभावित सत्र से /tools का उपयोग करें।

सत्र सूचीबद्ध करना और पढ़ना

sessions_list केंद्रित खोज पंक्तियाँ लौटाता है: सत्र कुंजी, एजेंट, प्रकार, चैनल, लेबल/शीर्षक/पूर्वावलोकन फ़ील्ड, मूल और बाल संबंध, अंतिम अपडेट, संग्रह/पिन स्थिति, स्थिति संस्करण, मॉडल, संदर्भ/कुल टोकन गणना, रन स्थिति और यह कि अंतिम रन निरस्त हुआ था या नहीं। kinds (सरणी; स्वीकृत मान: main, group, cron, hook, node, other), सटीक label, सटीक agentId, search टेक्स्ट या नवीनता (activeMinutes) के आधार पर फ़िल्टर करें। डिफ़ॉल्ट रूप से सक्रिय सत्र लौटाए जाते हैं; इसके बजाय संग्रहीत सत्रों का निरीक्षण करने के लिए archived: true दें। जब आपको मेलबॉक्स-शैली वर्गीकरण चाहिए, तो includeDerivedTitles, includeLastMessage या messageLimit (अधिकतम 20) निर्धारित करें: दृश्यता-दायरे वाला व्युत्पन्न शीर्षक, अंतिम संदेश का पूर्वावलोकन अंश या प्रत्येक पंक्ति पर सीमित हालिया संदेश। डिलीवरी रूटिंग, आंतरिक सत्र ID, प्रति-रन समय/सेटिंग, लागत अनुमान और प्रतिलेख पथ जानबूझकर छोड़े गए हैं; उन स्वामी-विशिष्ट विवरणों के लिए session_status, वार्तालाप टूल और sessions_history का उपयोग करें। व्युत्पन्न शीर्षक और पूर्वावलोकन केवल उन सत्रों के लिए बनाए जाते हैं जिन्हें कॉलर पहले से कॉन्फ़िगर की गई सत्र टूल दृश्यता नीति के अंतर्गत देख सकता है, इसलिए असंबंधित सत्र छिपे रहते हैं। दृश्यता प्रतिबंधित होने पर, sessions_list वैकल्पिक visibility मेटाडेटा लौटाता है, जो प्रभावी मोड और यह चेतावनी दिखाता है कि परिणाम दायरे तक सीमित हो सकते हैं।

sessions_history किसी विशिष्ट सत्र का वार्तालाप प्रतिलेख प्राप्त करता है। डिफ़ॉल्ट रूप से टूल परिणाम शामिल नहीं होते; उन्हें देखने के लिए includeTools: true दें। नवीनतम सीमित अंतिम भाग के लिए limit का उपयोग करें। जब आपको पृष्ठांकन मेटाडेटा चाहिए, तो offset: 0 दें, फिर कच्ची प्रतिलेख फ़ाइलें पढ़े बिना पुराने OpenClaw प्रतिलेख खंडों में पीछे की ओर पृष्ठ बदलने के लिए लौटाए गए nextOffset मान दें। स्पष्ट ऑफ़सेट पृष्ठ बाहरी CLI फ़ॉलबैक आयातों को मर्ज नहीं करते; जब आपको वह मर्ज किया हुआ प्रदर्शन इतिहास चाहिए, तो डिफ़ॉल्ट नवीनतम-अंतिम-भाग दृश्य (कोई offset नहीं) उपयोग करें।

लौटाया गया दृश्य जानबूझकर सीमित और सुरक्षा-फ़िल्टर किया गया है:

• सहायक टेक्स्ट को पुनःस्मरण से पहले सामान्यीकृत किया जाता है:
  • विचार टैग हटा दिए जाते हैं
  • <relevant-memories> / <relevant_memories> स्कैफ़ोल्डिंग ब्लॉक हटा दिए जाते हैं
  • <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, और <function_calls>...</function_calls> जैसे सादे-टेक्स्ट टूल-कॉल XML पेलोड ब्लॉक हटा दिए जाते हैं, जिनमें वे काटे गए पेलोड भी शामिल हैं जो कभी ठीक से बंद नहीं होते
  • [Tool Call: ...], [Tool Result ...], और [Historical context ...] जैसी अवनत टूल-कॉल/परिणाम स्कैफ़ोल्डिंग हटा दी जाती है
  • <|assistant|>, अन्य ASCII <|...|> टोकन और पूर्ण-चौड़ाई वाले <｜...｜> रूपों जैसे लीक हुए मॉडल नियंत्रण टोकन हटा दिए जाते हैं
  • <invoke ...> / </minimax:tool_call> जैसे विकृत MiniMax टूल-कॉल XML हटा दिए जाते हैं
• क्रेडेंशियल/टोकन-जैसे टेक्स्ट को लौटाने से पहले संपादित किया जाता है
• लंबे टेक्स्ट ब्लॉक काट दिए जाते हैं
• बहुत बड़े इतिहास पुरानी पंक्तियाँ हटा सकते हैं या अत्यधिक बड़ी पंक्ति को [sessions_history omitted: message too large] से बदल सकते हैं
• टूल truncated, droppedMessages, contentTruncated, contentRedacted, bytes और पृष्ठांकन मेटाडेटा जैसे सारांश फ़्लैग रिपोर्ट करता है

लौटाई गई सत्र कुंजी (जैसे "main") का उपयोग sessions_history, sessions_send, और session_status के साथ करें। वे लक्ष्य टूल किसी ज्ञात सत्र ID को भी हल कर सकते हैं, लेकिन sessions_list आंतरिक ID उजागर नहीं करता।

यदि आपको सटीक कच्चा प्रतिलेख चाहिए, तो sessions_history को बिना फ़िल्टर वाला डंप मानने के बजाय दायरे वाली SQLite प्रतिलेख पंक्तियों का निरीक्षण करें।

दृश्यमान उपयोगकर्ता और सहायक प्रतिलेख टेक्स्ट में सटीक पूर्ण-पाठ पुनःस्मरण के लिए sessions_search का उपयोग करें। इसके परिणामों में अनुवर्ती sessions_history कॉल के लिए एक sessionKey शामिल होता है; दृश्यता फ़िल्टरिंग, अंश संपादन और आउटपुट सीमाएँ इतिहास सीमा से मेल खाती हैं।

सत्र सेटिंग और समूहों का प्रबंधन

स्वामी-नियंत्रित sessions टूल दो सीमित स्व-सेवा सतहें उपलब्ध कराता है:

• action: "patch" डिफ़ॉल्ट रूप से वर्तमान सत्र को बदलता है, या sessionKey द्वारा चुने गए किसी अन्य दृश्यमान सत्र को। यह लेबल, साइडबार आइकन, पिन/संग्रह स्थिति, मॉडल और विचार स्तर निर्धारित कर सकता है। यह रीसेट, हटाने या संक्षिप्त करने की क्रियाएँ उपलब्ध नहीं कराता।
• group_list, group_set, group_rename, और group_delete वैश्विक क्रमबद्ध सत्र-समूह कैटलॉग प्रबंधित करते हैं। group_set किसी एक प्रविष्टि में संशोधन करने के बजाय क्रमबद्ध नाम सूची को बदल देता है।

एजेंट द्वारा चुना गया मॉडल संशोधन तब तक प्रत्यावर्तनीय रहता है, जब तक उस चयन पर एक रन सफलतापूर्वक पूरा नहीं हो जाता। यदि प्रमाणीकरण, बिलिंग या मॉडल-नहीं-मिला विफलता के कारण चुना गया मॉडल निश्चित रूप से अनुपयोगी है, तो OpenClaw पिछला मॉडल पुनर्स्थापित करता है और एक दृश्यमान सिस्टम नोट लिखता है। अस्थायी दर-सीमा, अतिभार, टाइमआउट, नेटवर्क और सर्वर विफलताएँ चयन को पूर्ववत नहीं करतीं।

सत्र बनाम वार्तालाप

एक सत्र स्थानीय मॉडल संदर्भ है। एक वार्तालाप कोई सटीक बाहरी पता है, जैसे एक सहकर्मी, चैनल या थ्रेड। दोनों जुड़े हुए हैं, लेकिन परस्पर विनिमेय नहीं हैं: प्रत्यक्ष संदेश अलग-अलग वार्तालाप पते बनाए रखते हुए एक main सत्र साझा कर सकते हैं।

conversations_list सक्रिय एजेंट के लिए अपारदर्शी conversationRef मान लौटाता है। स्पष्ट channel दिए जाने पर, Gateway उस चैनल की स्थानीय डायरेक्टरी से भी पते रीफ़्रेश करता है, जैसे अनुमोदित Reef सहकर्मी; वर्तमान परिणाम पृष्ठ से बाहर किसी विशिष्ट सहकर्मी को खोजने के लिए query का उपयोग करें। खोज मॉडल-संदर्भ सत्र बनाए बिना पते को कैटलॉग में दर्ज करती है; सहायक सत्र केवल तभी बनाया जाता है जब डिलीवरी या इनबाउंड संदर्भ को इसकी आवश्यकता होती है। वार्तालाप खोज और डिलीवरी केवल स्वामी के लिए हैं, क्योंकि वे Gateway के चैनल क्रेडेंशियल का उपयोग करती हैं। भेजकर भूल जाने वाली डिलीवरी के लिए conversations_send का उपयोग करें। जब दूरस्थ उत्तर वर्तमान मॉडल चरण से संबंधित हो, तो conversations_turn का उपयोग करें: Gateway एक ट्रांसपोर्ट संदेश ID आरक्षित करता है, ट्रांसपोर्ट I/O से पहले डिलीवरी संचालन और कतार अभिप्राय को स्थायी करता है, और दूसरा स्थानीय एजेंट चरण शुरू करने के बजाय टूल से सहसंबद्ध उत्तर लौटाता है। डिलीवरी संचालन मॉडल प्रतिलेखों के बाहर रहते हैं; कैप्चर किया गया उत्तर केवल सहायक आर्टिफ़ैक्ट के रूप में रखा जाता है, जबकि टूल परिणाम मॉडल संदर्भ का स्वामी होता है। यदि कतार में डालने के बाद Gateway पुनः आरंभ होता है, तो डिलीवरी पुनर्प्राप्त हो सकती है, लेकिन बाद का उत्तर सामान्य इनबाउंड प्रेषण का अनुसरण करता है क्योंकि प्रक्रिया-स्थानीय प्रतीक्षक समाप्त हो चुका होता है। अनपेक्षित इनबाउंड संदेश हमेशा सामान्य चैनल प्रेषण पथ से आगे बढ़ते हैं।

जब आपके पास पहले से स्पष्ट कच्चा चैनल लक्ष्य हो या चैनल-विशिष्ट क्रिया की आवश्यकता हो, तो साझा message टूल का उपयोग करें। वार्तालाप संदर्भ सक्रिय एजेंट के दायरे में होते हैं और उन्हें सत्र कुंजियों से बनाने के बजाय conversations_list के माध्यम से प्राप्त किया जाना चाहिए।

Code Mode में, वार्तालाप टूल अपने सटीक Gateway आउटपुट अनुबंधों का पुनः उपयोग करते हैं। एक exec सेल पते सूचीबद्ध कर सकता है, लौटाया गया conversationRef चुन सकता है और conversations_send या conversations_turn कॉल कर सकता है; सामान्य टूल नीति और अनुमोदन नेस्टेड कॉल पर अब भी लागू होते हैं।

अंतर-सत्र संदेश भेजना

sessions_send उसी Gateway पर दूसरा सत्र चलाता है और वैकल्पिक रूप से प्रतिक्रिया की प्रतीक्षा करता है। इसका sessionKey, label या agentId स्थानीय मॉडल संदर्भ चुनता है, बाहरी गंतव्य नहीं। परिणामी उत्तर अब भी स्थापित अनुरोधकर्ता या लक्ष्य डिलीवरी संदर्भ के माध्यम से घोषित किया जा सकता है; मौजूदा व्यवहार अपरिवर्तित है। सटीक बाहरी डिलीवरी के लिए, वार्तालाप टूल या स्पष्ट चैनल और लक्ष्य के साथ message का उपयोग करें।

• भेजकर भूल जाएँ: कतार में डालकर तुरंत लौटने के लिए timeoutSeconds: 0 निर्धारित करें।
• उत्तर की प्रतीक्षा करें: टाइमआउट निर्धारित करें और प्रतिक्रिया इनलाइन प्राप्त करें।

थ्रेड-दायरे वाले चैट सत्र, जैसे :thread:<id> पर समाप्त होने वाली कुंजियाँ, मान्य sessions_send लक्ष्य नहीं हैं। अंतर-एजेंट समन्वय के लिए मूल चैनल सत्र कुंजी का उपयोग करें, ताकि टूल द्वारा रूट किए गए संदेश किसी सक्रिय मानव-दृश्य थ्रेड के भीतर दिखाई न दें।

संदेशों और A2A अनुवर्ती उत्तरों को प्राप्तकर्ता प्रॉम्प्ट ([Inter-session message ... isUser=false]) और प्रतिलेख उद्गम में अंतर-सत्र डेटा के रूप में चिह्नित किया जाता है। प्राप्तकर्ता एजेंट को उन्हें टूल द्वारा रूट किया गया डेटा मानना चाहिए, न कि सीधे अंतिम उपयोगकर्ता द्वारा लिखा गया निर्देश।

लक्ष्य के उत्तर देने के बाद, OpenClaw एक प्रति-उत्तर लूप चला सकता है, जिसमें एजेंट अंतर्निहित सीमा तक बारी-बारी से संदेश भेजते हैं। लक्ष्य एजेंट जल्दी रोकने के लिए REPLY_SKIP उत्तर दे सकता है।

प्रेषक को लक्ष्य की स्थिति-परिवर्तन निगरानीकर्ता के रूप में भी पंजीकृत करने के लिए watch: true दें: जब बाद में कोई अन्य कर्ता लक्ष्य को सीधा मानव संदेश भेजता है या उसका लक्ष्य बदलता है, तो प्रेषक को session_status changesSince की ओर संकेत करने वाली सिस्टम सूचना मिलती है। पंजीकरण सफल प्रेषण के बाद होता है, उस सत्र को लक्षित करता है जिसने वास्तव में संदेश प्राप्त किया था और उसके वर्तमान स्थिति संस्करण से शुरू होता है, इसलिए केवल बाद के परिवर्तन सूचनाएँ उत्पन्न करते हैं। पंजीकरण सफल होने पर परिणाम watched: true रिपोर्ट करता है। सत्र स्थिति जागरूकता देखें।

स्थिति और समन्वय सहायक

session_status वर्तमान या किसी अन्य दृश्यमान सत्र के लिए हल्का /status-समकक्ष टूल है। यह उपयोग, समय, मॉडल/रनटाइम स्थिति और मौजूद होने पर संबद्ध पृष्ठभूमि-कार्य संदर्भ की रिपोर्ट करता है। /status की तरह, यह नवीनतम प्रतिलेख उपयोग प्रविष्टि से विरल टोकन/कैश काउंटर भर सकता है, और model=default प्रति-सत्र ओवरराइड साफ़ करता है। कॉलर के वर्तमान सत्र के लिए sessionKey="current" का उपयोग करें; openclaw-tui जैसे दृश्यमान क्लाइंट लेबल सत्र कुंजियाँ नहीं हैं।

जब रूट मेटाडेटा उपलब्ध होता है, तो session_status में एक दृश्यमान Route context JSON ब्लॉक और उससे मेल खाने वाले संरचित details फ़ील्ड भी शामिल होते हैं। ये फ़ील्ड सेशन कुंजी को उस रूट से अलग स्पष्ट करते हैं जो वर्तमान में लाइव रन को संभाल रहा है:

• origin वह स्थान है जहाँ सेशन बनाया गया था, या जब पुरानी स्थिति में संग्रहीत उद्गम मेटाडेटा नहीं होता, तब डिलीवरी योग्य सेशन-कुंजी प्रीफ़िक्स से अनुमानित प्रदाता।
• active वर्तमान लाइव-रन रूट है। इसे केवल अभी संभाले जा रहे लाइव या वर्तमान सेशन के लिए रिपोर्ट किया जाता है।
• deliveryContext सेशन पर संग्रहीत स्थायी डिलीवरी रूट है, जिसे OpenClaw बाद की डिलीवरी के लिए फिर से उपयोग कर सकता है, भले ही सक्रिय सतह अलग हो।

सेशन स्थिति में बदलाव

OpenClaw महत्वपूर्ण सेशन स्थिति परिवर्तनों (निगरानी किए जा रहे सेशन को सीधे मानव संदेश, चाइल्ड-रन परिणाम, लक्ष्य परिवर्तन, Compaction) का एक टिकाऊ सिग्नल लॉग रखता है। sessions_list पंक्तियाँ और session_status सेशन के stateVersion को उजागर करते हैं, और session_status उस संस्करण के बाद के टाइप किए गए इवेंट लौटाने के लिए changesSince: <version> स्वीकार करता है, साथ ही जब अनुरोधित संस्करण संरक्षित इतिहास से पहले का हो, तब सटीक historyGap संकेत देता है। वॉचर—स्पॉन पैरेंट स्वचालित रूप से, sessions_send watch: true स्पष्ट रूप से—जब कोई अन्य पक्ष निगरानी किए जा रहे सेशन को बदलता है, तब एक समेकित अप्रचलित-स्थिति सूचना प्राप्त करते हैं।

स्थिति-परिवर्तन इवेंट दोहराए गए सेशन/एजेंट ID छोड़ देते हैं और केवल मॉडल के लिए उपयोगी पेलोड फ़ील्ड (outcome, channel, या turns) उजागर करते हैं। इवेंट सारांश और पक्ष/रन पहचानकर्ता मिलान के लिए उपलब्ध रहते हैं।

पूरा मॉडल—इवेंट प्रकार, वॉचर पंजीकरण, स्पैम-रोधी सूचना प्रोटोकॉल, मिलान प्रवाह और वर्तमान सीमाएँ—जानने के लिए सेशन स्थिति जागरूकता देखें।

sessions_yield जानबूझकर वर्तमान टर्न समाप्त करता है, ताकि अगला संदेश वह फ़ॉलो-अप इवेंट हो सके जिसकी आप प्रतीक्षा कर रहे हैं। सब-एजेंट स्पॉन करने के बाद इसका उपयोग तब करें, जब आप चाहते हों कि पोल लूप बनाने के बजाय पूर्णता परिणाम अगले संदेश के रूप में आएँ।

subagents मूल सब-एजेंट रन और साझा पृष्ठभूमि-कार्य लेजर का सेशन-ट्री दृश्य है। action: "list" सक्रिय/हालिया सब-एजेंट के साथ स्कोप किए गए ACP, CLI/मीडिया और Cron कार्य रिपोर्ट करता है। action: "cancel" लौटाया गया taskId स्वीकार करता है और केवल कॉलर के नियंत्रित सेशन ट्री के भीतर का काम रोक सकता है; लीफ़ सब-एजेंट किसी अन्य सेशन का कार्य रद्द नहीं कर सकते।

सब-एजेंट स्पॉन करना

sessions_spawn डिफ़ॉल्ट रूप से पृष्ठभूमि कार्य के लिए एक पृथक सेशन बनाता है। यह हमेशा नॉन-ब्लॉकिंग होता है; यह तुरंत एक runId और childSessionKey लौटाता है। मूल सब-एजेंट रन को सौंपा गया कार्य चाइल्ड सेशन के पहले दृश्यमान [Subagent Task] संदेश में मिलता है, जबकि सिस्टम प्रॉम्प्ट में केवल सब-एजेंट रनटाइम नियम और रूटिंग संदर्भ होते हैं।

मुख्य विकल्प:

• runtime: "subagent" (डिफ़ॉल्ट) या बाहरी हार्नेस एजेंट के लिए "acp"।
• चाइल्ड सेशन के लिए model और thinking ओवरराइड।
• स्पॉन को चैट थ्रेड (Discord, Slack आदि) से बाँधने के लिए thread: true।
• चाइल्ड पर सैंडबॉक्सिंग लागू करने के लिए sandbox: "require"।
• जब चाइल्ड को वर्तमान अनुरोधकर्ता ट्रांसक्रिप्ट की आवश्यकता हो, तब मूल सब-एजेंट के लिए context: "fork"; साफ़ चाइल्ड के लिए इसे छोड़ दें या context: "isolated" का उपयोग करें। context: "fork" केवल runtime: "subagent" के साथ मान्य है। जब तक threadBindings.defaultSpawnContext अन्यथा न कहे, थ्रेड-बाउंड मूल सब-एजेंट डिफ़ॉल्ट रूप से context: "fork" का उपयोग करते हैं।
• छिपे हुए सब-एजेंट सेशन के बजाय स्थायी डैशबोर्ड सेशन बनाने के लिए visible: true। दृश्यमान स्पॉन स्पष्ट मॉडल, कार्यशील डायरेक्टरी, समान-एजेंट ट्रांसक्रिप्ट फ़ोर्क और वैकल्पिक प्रबंधित वर्कट्री का समर्थन करते हैं; सटीक संगतता सीमाओं के लिए सब-एजेंट देखें।

डिफ़ॉल्ट लीफ़ सब-एजेंट को सेशन टूल नहीं मिलते। जब maxSpawnDepth >= 2, तब गहराई-1 ऑर्केस्ट्रेटर सब-एजेंट को अतिरिक्त रूप से sessions_spawn, subagents, sessions_list, और sessions_history मिलते हैं, ताकि वे अपने चाइल्ड प्रबंधित कर सकें। लीफ़ रन को फिर भी पुनरावर्ती ऑर्केस्ट्रेशन टूल नहीं मिलते।

पूर्णता के बाद, एक घोषणा चरण परिणाम को अनुरोधकर्ता के चैनल पर पोस्ट करता है। पूर्णता डिलीवरी उपलब्ध होने पर बाउंड थ्रेड/विषय रूटिंग सुरक्षित रखती है, और यदि पूर्णता उद्गम केवल किसी चैनल की पहचान करता है, तब भी OpenClaw सीधी डिलीवरी के लिए अनुरोधकर्ता सेशन के संग्रहीत रूट (lastChannel / lastTo) का फिर से उपयोग कर सकता है।

ACP-विशिष्ट व्यवहार के लिए ACP एजेंट देखें।

दृश्यता

एजेंट क्या देख सकता है, इसे सीमित करने के लिए सेशन टूल स्कोप किए जाते हैं:

डिफ़ॉल्ट tree है। कॉन्फ़िगरेशन की परवाह किए बिना सैंडबॉक्स किए गए सेशन tree तक सीमित रहते हैं। डिफ़ॉल्ट session.dmScope: "main" के साथ, समूह गतिविधि निगरानी किए जा रहे समान-एजेंट समूह सेशन को मुख्य सेशन से पठनीय बनाती है।

आगे पढ़ें

• सेशन प्रबंधन: रूटिंग, जीवनचक्र, रखरखाव
• सब-एजेंट: चाइल्ड-सेशन जीवनचक्र और डिलीवरी
• ACP एजेंट: बाहरी हार्नेस स्पॉनिंग
• मल्टी-एजेंट: मल्टी-एजेंट आर्किटेक्चर
• Gateway कॉन्फ़िगरेशन: सेशन टूल कॉन्फ़िगरेशन नियंत्रण

संबंधित

• सेशन प्रबंधन
• सेशन प्रूनिंग