CLI बैकएंड्स

OpenClaw, API प्रदाताओं के बंद होने, दर-सीमित होने या गलत व्यवहार करने पर, केवल-पाठ फ़ॉलबैक के रूप में स्थानीय AI CLI चला सकता है। इसे जानबूझकर सतर्क रखा गया है:

• OpenClaw टूल सीधे इंजेक्ट नहीं किए जाते, लेकिन bundleMcp: true वाला बैकएंड लूपबैक MCP ब्रिज के माध्यम से Gateway टूल प्राप्त कर सकता है।
• इसका समर्थन करने वाले CLI के लिए JSONL स्ट्रीमिंग।
• सेशन समर्थित हैं, इसलिए बाद के टर्न सुसंगत बने रहते हैं।
• यदि CLI इमेज पथ स्वीकार करता है, तो इमेज आगे भेजी जाती हैं।

इसे प्राथमिक पथ के रूप में नहीं, बल्कि "हमेशा काम करने वाली" पाठ प्रतिक्रियाओं के लिए सुरक्षा उपाय के रूप में उपयोग करें। ACP सेशन नियंत्रण, बैकग्राउंड कार्यों, थ्रेड/वार्तालाप बाइंडिंग और स्थायी बाहरी कोडिंग सेशन वाले पूर्ण हार्नेस रनटाइम के लिए इसके बजाय ACP एजेंट का उपयोग करें; CLI बैकएंड ACP नहीं हैं।

त्वरित शुरुआत

बंडल किया गया Anthropic Plugin एक डिफ़ॉल्ट claude-cli बैकएंड पंजीकृत करता है, इसलिए Claude Code इंस्टॉल और उसमें लॉग इन होने के अतिरिक्त किसी कॉन्फ़िगरेशन के बिना यह काम करता है:

openclaw agent --agent main --message "hi" --model claude-cli/claude-sonnet-4-6

जब कोई स्पष्ट एजेंट सूची कॉन्फ़िगर नहीं होती, तब main डिफ़ॉल्ट एजेंट आईडी होती है; अन्यथा इसे अपनी एजेंट आईडी से बदलें।

Gateway सेवा के PATH पर CLI उपलब्ध होना चाहिए। यदि किसी परिनियोजन को गैर-मानक निष्पादन योग्य पथ या आर्ग्युमेंट की आवश्यकता है, तो लॉन्च प्रक्रिया को openclaw.json में रखने के बजाय उस अडैप्टर को CLI बैकएंड Plugin में पंजीकृत करें।

जब मॉडल चयन या मॉडल-स्कोप वाला agentRuntime.id उसके बैकएंड को संदर्भित करता है, तब OpenClaw स्वामित्व वाला बंडल किया गया Plugin स्वतः लोड करता है।

फ़ॉलबैक के रूप में इसका उपयोग

CLI बैकएंड को अपनी फ़ॉलबैक सूची में जोड़ें, ताकि यह केवल प्राथमिक मॉडल के विफल होने पर चले:

{  agents: {    defaults: {      model: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["claude-cli/claude-sonnet-4-6"],      },      models: {        "anthropic/claude-opus-4-6": { alias: "Opus" },        "claude-cli/claude-sonnet-4-6": {},      },    },  },}

प्राथमिक प्रदाता के विफल होने पर (प्रमाणीकरण, दर सीमाएँ, टाइमआउट) कॉन्फ़िगर किए गए फ़ॉलबैक पात्र बने रहते हैं, भले ही वे agents.defaults.modelPolicy.allow में न हों। CLI बैकएंड मॉडल को उस नीति में केवल तभी जोड़ें, जब उपयोगकर्ताओं को उसे /model, सेशन ओवरराइड या --model के माध्यम से सीधे चुनने में भी सक्षम होना चाहिए। agents.defaults.models केवल प्रति-मॉडल उपनामों, पैरामीटर और मेटाडेटा का स्वामी है।

कॉन्फ़िगरेशन

उपयोगकर्ता मॉडल और रनटाइम नीति के माध्यम से पंजीकृत बैकएंड चुनते हैं। मॉडल संदर्भ को कैनॉनिकल रखें और प्रति मॉडल CLI रनटाइम चुनें:

{  agents: {    defaults: {      model: "anthropic/claude-opus-5",      models: {        "anthropic/claude-opus-5": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

क्रेडेंशियल OpenClaw प्रमाणीकरण प्रोफ़ाइल या स्वामित्व वाले Plugin के कॉन्फ़िगरेशन में रहते हैं। कमांड, argv, परिवेश, पार्सिंग, सेशन, इमेज और वॉचडॉग प्रक्रियाएँ api.registerCliBackend(...) के साथ पंजीकृत Plugin कोड होती हैं।

यह कैसे काम करता है

1. प्रदाता उपसर्ग (claude-cli/...) के आधार पर बैकएंड चुनता है।
2. समान OpenClaw प्रॉम्प्ट और कार्यक्षेत्र संदर्भ का उपयोग करके सिस्टम प्रॉम्प्ट बनाता है।
3. सेशन आईडी (यदि समर्थित हो) के साथ CLI निष्पादित करता है, ताकि इतिहास सुसंगत रहे। बंडल किया गया claude-cli बैकएंड प्रत्येक OpenClaw सेशन के लिए Claude stdio प्रक्रिया को सक्रिय रखता है और बाद के टर्न stream-json stdin पर भेजता है।
4. आउटपुट (JSON या सादा पाठ) को पार्स करके अंतिम पाठ लौटाता है।
5. प्रत्येक बैकएंड के लिए सेशन आईडी स्थायी रखता है, ताकि बाद के टर्न उसी CLI सेशन का पुनः उपयोग करें।

टाइमआउट और लंबे समय तक चलने वाला कार्य

CLI बैकएंड की दो स्वतंत्र सीमाएँ होती हैं:

• agents.defaults.timeoutSeconds पूरे एजेंट टर्न को सीमित करता है। सामान्य Gateway टर्न 48-घंटे की डिफ़ॉल्ट सीमा प्राप्त करते हैं; 0 टर्न बजट को असीमित बनाता है। 600 जैसा संग्रहित ओवरराइड उस डिफ़ॉल्ट को बदल देता है।
• CLI का नो-आउटपुट वॉचडॉग मौन बने रहने वाली उप-प्रक्रिया को रोक देता है। प्रत्येक बैकएंड Plugin अलग-अलग नए/फिर से शुरू किए गए प्रोफ़ाइल का स्वामी होता है, और समग्र टर्न बजट असीमित होने पर भी वॉचडॉग सक्रिय रहता है।

48-घंटे के डिफ़ॉल्ट पर लौटने के लिए छोटा समग्र-टाइमआउट ओवरराइड हटाएँ, या 12 घंटे जैसा स्पष्ट बजट सेट करें:

# 48-घंटे के डिफ़ॉल्ट पर लौटें:openclaw config unset agents.defaults.timeoutSeconds # या स्पष्ट 12-घंटे की सीमा चुनें:openclaw config set agents.defaults.timeoutSeconds 43200

CLI के भीतर शुरू किया गया बैकग्राउंड कार्य अभी भी उसी CLI उप-प्रक्रिया का हिस्सा होता है। यदि मूल टर्न अपनी समग्र सीमा तक पहुँच जाता है, तो OpenClaw उप-प्रक्रिया और उसके CLI-आंतरिक बैकग्राउंड कार्यों को एक साथ रोक देता है। लंबे समय तक टिकाऊ कार्य के लिए अलग किया गया OpenClaw उप-एजेंट या ACP एजेंट उपयोग करें; अलग किए गए उप-एजेंट के लिए डिफ़ॉल्ट रूप से कोई रन टाइमआउट नहीं होता।

openclaw agent कमांड की अपनी अनुरोध समय-सीमा भी होती है। उसका 600-सेकंड का फ़ॉलबैक डिफ़ॉल्ट उस कमांड आह्वान पर लागू होता है, सामान्य Gateway टर्न पर नहीं; openclaw agent देखें।

Claude CLI की विशिष्टताएँ

बंडल किया गया claude-cli बैकएंड Claude Code के मूल स्किल रिज़ॉल्वर को प्राथमिकता देता है। जब वर्तमान स्किल स्नैपशॉट में भौतिक पथ वाला कम-से-कम एक चयनित स्किल होता है, तब OpenClaw --plugin-dir के माध्यम से एक अस्थायी Claude Code Plugin भेजता है और जोड़े गए सिस्टम प्रॉम्प्ट से डुप्लिकेट OpenClaw स्किल कैटलॉग हटा देता है। भौतिक रूप से उपलब्ध Plugin स्किल न होने पर OpenClaw प्रॉम्प्ट कैटलॉग को फ़ॉलबैक के रूप में बनाए रखता है। स्किल परिवेश/API कुंजी ओवरराइड अभी भी रन के लिए चाइल्ड प्रक्रिया के परिवेश पर लागू होते हैं।

Claude CLI का अपना गैर-इंटरैक्टिव अनुमति मोड है; OpenClaw Claude-विशिष्ट कॉन्फ़िगरेशन जोड़ने के बजाय उसे मौजूदा exec नीति से मैप करता है। OpenClaw द्वारा प्रबंधित Claude लाइव सेशन के लिए प्रभावी exec नीति निर्णायक होती है: YOLO (tools.exec.mode: "full") सामान्यतः Claude को --permission-mode bypassPermissions के साथ लॉन्च करता है, जबकि प्रतिबंधात्मक नीति उसे --permission-mode default के साथ लॉन्च करती है। रूट द्वारा चलाए जाने वाले Gateway भी default उपयोग करते हैं, क्योंकि Claude Code रूट के लिए बायपास मोड अस्वीकार करता है। प्रति-एजेंट agents.entries.*.tools.exec सेटिंग उस एजेंट के लिए वैश्विक tools.exec को ओवरराइड करती है। Anthropic Plugin प्रभावी नीति और होस्ट प्रतिबंध से मेल कराने के लिए Claude के अनुमति फ़्लैग को सामान्यीकृत करता है।

प्रतिबंधात्मक नीति के अंतर्गत Claude अपने किसी मूल या एक्सटेंशन टूल (अपने Bash, WebFetch या Claude in Chrome ब्राउज़र टूल) का उपयोग करने से पहले stdio के माध्यम से OpenClaw से पूछता है। जब प्रभावी exec पूछताछ सेटिंग on-miss या always होती है, तब OpenClaw प्रत्येक अनुरोध को इंटरैक्टिव स्वीकृति के रूप में सेशन के चैनल पर भेजता है: Allow once केवल एक कॉल की अनुमति देता है, Allow always शेष लाइव Claude सेशन के लिए उस टूल नाम की अनुमति देता है (केवल मेमोरी में, कभी स्थायी रूप से संग्रहित नहीं), और Deny, टाइमआउट या अनुपलब्ध स्वीकृति मार्ग—सभी कॉल को अस्वीकार कर देते हैं। कभी प्रॉम्प्ट न करने वाली नीतियाँ अपना पुराना व्यवहार बनाए रखती हैं: security: "deny" प्रत्येक अनुरोध अस्वीकार करता है, और पूर्ण सुरक्षा से कम (exec मोड allowlist) वाला ask off बिना पूछे अस्वीकार कर देता है।

Claude ब्राउज़र टूल और 1Password साइन-इन

Claude Code, Claude in Chrome extension के माध्यम से Chrome ब्राउज़र चला सकता है, जिसमें Claude के लिए 1Password क्रेडेंशियल ऑटोफ़िल शामिल है। बंडल किया गया बैकएंड इसे सक्षम नहीं करता; ऐसा CLI बैकएंड Plugin पंजीकृत करें, जो claude-stream-json-डायलेक्ट बैकएंड के लॉन्च आर्ग्युमेंट में --chrome जोड़ता हो। OpenClaw सामान्य रन पर कॉन्फ़िगर किए गए --chrome को बनाए रखता है और साइड प्रश्नों जैसी प्रतिबंधित टूल नीति वाले रन पर हमेशा --no-chrome बाध्य करता है। Chrome विंडो, एक्सटेंशन और 1Password के सभी स्वीकृति प्रॉम्प्ट Gateway होस्ट पर रहते हैं, इसलिए क्रेडेंशियल उपयोग को स्वीकृत करने के लिए किसी व्यक्ति का उस मशीन पर उपस्थित होना आवश्यक है।

बैकएंड OpenClaw /think स्तरों को Claude Code के मूल --effort फ़्लैग से भी मैप करता है: minimal/low -> low, medium -> medium, और high/xhigh/max सीधे आगे भेजे जाते हैं। इससे समर्थित Fable 5 प्रयास स्तर, सदस्यता-समर्थित Claude CLI और API-कुंजी मार्गों के लिए समान बने रहते हैं। adaptive कॉन्फ़िगर किए गए --effort फ़्लैग हटाता है और कोई प्रतिस्थापन नहीं देता, इसलिए Claude Code अपने परिवेश, सेटिंग और मॉडल डिफ़ॉल्ट से प्रभावी प्रयास निर्धारित करता है। अन्य CLI बैकएंड के लिए उनके स्वामित्व वाले Plugin को समतुल्य argv मैपर घोषित करना होगा, तभी /think उत्पन्न किए गए CLI को प्रभावित करेगा।

OpenClaw द्वारा claude-cli उपयोग किए जाने से पहले, उसी होस्ट पर Claude Code में लॉग इन होना आवश्यक है:

claude auth loginclaude auth status --textopenclaw models auth login --provider anthropic --method cli --set-default

Docker इंस्टॉल में Claude Code को केवल होस्ट पर नहीं, बल्कि स्थायी कंटेनर होम के भीतर इंस्टॉल और लॉग इन करना आवश्यक है; Docker में Claude CLI बैकएंड देखें।

Gateway सेवा को PATH पर claude रिज़ॉल्व करना आवश्यक है। गैर-मानक पथ के लिए, एक छोटा रैपर बैकएंड Plugin पंजीकृत करें।

सेशन

• यदि CLI सेशन का समर्थन करता है, तो {sessionId} प्लेसहोल्डर (उदाहरण के लिए ["--session-id", "{sessionId}"]) के साथ sessionArgs सेट करें।
• यदि CLI अलग फ़्लैग वाले रिज़्यूम उपकमांड का उपयोग करता है, तो resumeArgs सेट करें (रिज़्यूम करते समय args को बदलता है) और गैर-JSON रिज़्यूम के लिए वैकल्पिक रूप से resumeOutput सेट करें।
• sessionMode:
  • always: हमेशा सेशन आईडी भेजें (यदि कोई संग्रहित न हो तो नई UUID)।
  • existing: केवल तभी सेशन आईडी भेजें, जब कोई पहले से संग्रहित हो।
  • none: कभी सेशन आईडी न भेजें।
• claude-cli डिफ़ॉल्ट रूप से liveSession: "claude-stdio", output: "jsonl" और input: "stdin" का उपयोग करता है, इसलिए बाद के टर्न लाइव Claude प्रक्रिया के सक्रिय रहने तक उसका पुनः उपयोग करते हैं, इसमें ट्रांसपोर्ट फ़ील्ड छोड़ने वाले कस्टम कॉन्फ़िगरेशन भी शामिल हैं। यदि Gateway पुनः शुरू होता है या निष्क्रिय प्रक्रिया बंद हो जाती है, तो OpenClaw संग्रहित Claude सेशन आईडी से फिर शुरू करता है। रिज़्यूम करने से पहले संग्रहित सेशन आईडी को पठनीय प्रोजेक्ट ट्रांस्क्रिप्ट के विरुद्ध सत्यापित किया जाता है; ट्रांस्क्रिप्ट न मिलने पर --resume के अंतर्गत चुपचाप नया सेशन शुरू करने के बजाय बाइंडिंग साफ़ कर दी जाती है (reason=transcript-missing के रूप में लॉग किया जाता है)।
• Claude लाइव सेशन सीमित JSONL आउटपुट सुरक्षा बनाए रखते हैं: प्रत्येक टर्न में 8 MiB और 20,000 अपरिष्कृत JSONL पंक्तियाँ।
• संग्रहित CLI सेशन प्रदाता-स्वामित्व वाली निरंतरता हैं। स्वचालित रीसेट डिफ़ॉल्ट रूप से अक्षम है; /reset और स्पष्ट दैनिक या निष्क्रिय session.reset नीतियाँ अब भी उन्हें समाप्त करती हैं।
• नए CLI सेशन सामान्यतः केवल OpenClaw के Compaction सारांश और Compaction के बाद के शेष भाग से दोबारा सीड होते हैं। Compaction से पहले अमान्य हुए छोटे सेशन पुनर्प्राप्त करने के लिए बैकएंड reseedFromRawTranscriptWhenUncompacted: true के साथ इसे चुन सकता है। अपरिष्कृत ट्रांस्क्रिप्ट का पुनः सीड सीमित रहता है और केवल सुरक्षित अमान्यताओं तक सीमित होता है, जैसे अनुपलब्ध CLI ट्रांस्क्रिप्ट, अनाथ टूल-उपयोग शेष भाग, संदेश-नीति/सिस्टम-प्रॉम्प्ट/cwd/MCP परिवर्तन या सेशन-समाप्ति पुनः प्रयास; प्रमाणीकरण प्रोफ़ाइल या क्रेडेंशियल-युग परिवर्तन कभी अपरिष्कृत ट्रांस्क्रिप्ट इतिहास को दोबारा सीड नहीं करते।

सीरियलाइज़ेशन: serialize: true समान-लेन रन का क्रम बनाए रखता है (अधिकांश CLI एक प्रदाता लेन पर क्रमिक रूप से चलते हैं)। चयनित प्रमाणीकरण पहचान बदलने पर OpenClaw संग्रहित CLI सेशन का पुनः उपयोग भी बंद कर देता है, जिसमें बदली हुई प्रमाणीकरण प्रोफ़ाइल आईडी, स्थिर API कुंजी, स्थिर टोकन या CLI द्वारा उपलब्ध कराई गई OAuth खाता पहचान शामिल है; केवल OAuth एक्सेस/रिफ़्रेश टोकन का रोटेशन सेशन को समाप्त नहीं करता। यदि CLI के पास स्थिर OAuth खाता आईडी नहीं है, तो OpenClaw उस CLI को अपनी रिज़्यूम अनुमतियाँ स्वयं लागू करने देता है।

claude-cli सेशन से फ़ॉलबैक प्रस्तावना

जब कोई claude-cli प्रयास agents.defaults.model.fallbacks में किसी गैर-CLI उम्मीदवार पर फ़ेलओवर करता है, तो OpenClaw अगले प्रयास को Claude Code की स्थानीय JSONL ट्रांसक्रिप्ट से प्राप्त संदर्भ प्रस्तावना के साथ आरंभ करता है (~/.claude/projects/ के अंतर्गत, प्रत्येक कार्यस्थान के अनुसार कुंजीबद्ध)। इस आरंभिक संदर्भ के बिना फ़ॉलबैक प्रदाता बिना संदर्भ के शुरू होता है, क्योंकि claude-cli रन के लिए OpenClaw की अपनी सत्र ट्रांसक्रिप्ट खाली होती है।

• प्रस्तावना नवीनतम /compact सारांश या compact_boundary मार्कर को प्राथमिकता देती है, फिर वर्ण बजट तक सीमा के बाद के सबसे हालिया संवाद जोड़ती है। सीमा से पहले के संवाद हटा दिए जाते हैं, क्योंकि सारांश पहले ही उनका प्रतिनिधित्व करता है।
• प्रॉम्प्ट बजट को सटीक बनाए रखने के लिए टूल ब्लॉक को संक्षिप्त (tool call: name) और (tool result: …) संकेतों में समेकित किया जाता है; अत्यधिक बड़ा सारांश छोटा करके (truncated) लेबल किया जाता है।
• समान-प्रदाता claude-cli से claude-cli फ़ॉलबैक Claude के अपने --resume पर निर्भर करते हैं और प्रस्तावना को छोड़ देते हैं।
• आरंभिक संदर्भ मौजूदा Claude सत्र-फ़ाइल पथ सत्यापन का पुनः उपयोग करता है, इसलिए मनमाने पथ पढ़े नहीं जा सकते।

इमेज

Plugin लेखक imageArg के साथ इमेज-पथ समर्थन घोषित करते हैं:

imageArg: "--image",imageMode: "repeat"

OpenClaw base64 इमेज को अस्थायी फ़ाइलों में लिखता है। यदि imageArg सेट है, तो वे पथ CLI तर्कों के रूप में पास किए जाते हैं; यदि नहीं, तो OpenClaw फ़ाइल पथों को प्रॉम्प्ट में जोड़ता है (पथ इंजेक्शन), जो उन CLI के लिए काम करता है जो साधारण पथों से स्थानीय फ़ाइलें स्वतः लोड करते हैं।

इनपुट और आउटपुट

• output: "text" (डिफ़ॉल्ट) stdout को अंतिम प्रतिक्रिया मानता है।
• output: "json" JSON को पार्स करके टेक्स्ट और सत्र आईडी निकालने का प्रयास करता है।
• output: "jsonl" JSONL स्ट्रीम को पार्स करता है और उपलब्ध होने पर अंतिम एजेंट संदेश तथा सत्र पहचानकर्ता निकालता है।
• Gemini CLI JSON आउटपुट के लिए, जब usage अनुपलब्ध या खाली हो, तो OpenClaw उत्तर टेक्स्ट को response से और उपयोग को stats से पढ़ता है। बंडल किया गया Gemini CLI अडैप्टर stream-json का उपयोग करता है।

इनपुट मोड:

• input: "arg" (डिफ़ॉल्ट) प्रॉम्प्ट को अंतिम CLI तर्क के रूप में पास करता है।
• input: "stdin" प्रॉम्प्ट को stdin के माध्यम से भेजता है।
• यदि प्रॉम्प्ट बहुत लंबा है और maxPromptArgChars सेट है, तो इसके बजाय stdin का उपयोग किया जाता है।

Plugin-स्वामित्व वाले डिफ़ॉल्ट

CLI बैकएंड डिफ़ॉल्ट Plugin सतह का हिस्सा हैं:

• Plugins उन्हें api.registerCliBackend(...) के साथ पंजीकृत करते हैं।
• बैकएंड id मॉडल संदर्भों में प्रदाता उपसर्ग बन जाता है।
• कमांड, argv, परिवेश, पार्सर, सत्र और वॉचडॉग व्यवहार Plugin कोड में रहता है।
• बैकएंड-विशिष्ट सामान्यीकरण वैकल्पिक normalizeConfig हुक के माध्यम से Plugin के स्वामित्व में रहता है।

Anthropic claude-cli का और Google google-gemini-cli का स्वामी है। OpenAI Codex एजेंट रन openai/* के माध्यम से Codex ऐप-सर्वर हार्नेस का उपयोग करते हैं; OpenClaw अब बंडल किए गए codex-cli बैकएंड को पंजीकृत नहीं करता।

बंडल किया गया Anthropic Plugin claude-cli के लिए पंजीकरण करता है:

बंडल किया गया Google Plugin google-gemini-cli के लिए पंजीकरण करता है:

पूर्वापेक्षा: स्थानीय Gemini CLI इंस्टॉल होना चाहिए और PATH पर gemini के रूप में उपलब्ध होना चाहिए (brew install gemini-cli या npm install -g @google/gemini-cli)।

Gemini CLI आउटपुट संबंधी टिप्पणियाँ:

• डिफ़ॉल्ट stream-json पार्सर सहायक message इवेंट, टूल इवेंट, अंतिम result उपयोग और घातक Gemini त्रुटि इवेंट पढ़ता है।
• जब usage अनुपलब्ध या खाली हो, तो उपयोग stats पर फ़ॉलबैक करता है; stats.cached को OpenClaw cacheRead में सामान्यीकृत किया जाता है, और यदि stats.input अनुपलब्ध है, तो इनपुट टोकन stats.input_tokens - stats.cached से निकाले जाते हैं।

टेक्स्ट रूपांतरण ओवरले

जिन Plugins को छोटे प्रॉम्प्ट/संदेश संगतता शिम की आवश्यकता होती है, वे प्रदाता या CLI बैकएंड को बदले बिना द्विदिश टेक्स्ट रूपांतरण घोषित कर सकते हैं:

api.registerTextTransforms({  input: [{ from: /red basket/g, to: "blue basket" }],  output: [{ from: /blue basket/g, to: "red basket" }],});

input CLI को पास किए गए सिस्टम प्रॉम्प्ट और उपयोगकर्ता प्रॉम्प्ट को पुनर्लिखता है। output OpenClaw द्वारा अपने नियंत्रण मार्कर और चैनल डिलीवरी संभालने से पहले स्ट्रीम किए गए सहायक टेक्स्ट और पार्स किए गए अंतिम टेक्स्ट को पुनर्लिखता है; प्रदाता-समर्थित मॉडल कॉल के लिए यह स्ट्रीम सुधार के बाद और टूल निष्पादन से पहले संरचित टूल-कॉल तर्कों के भीतर स्ट्रिंग मानों को भी पुनर्स्थापित करता है। अपरिष्कृत प्रदाता JSON खंड अपरिवर्तित रहते हैं; उपभोक्ताओं को संरचित आंशिक, समाप्ति या परिणाम पेलोड का उपयोग करना चाहिए।

प्रदाता-विशिष्ट JSONL इवेंट उत्सर्जित करने वाले CLI के लिए, उस बैकएंड के कॉन्फ़िगरेशन पर jsonlDialect सेट करें: Claude Code-संगत स्ट्रीम के लिए claude-stream-json, Gemini CLI stream-json इवेंट के लिए gemini-stream-json।

नेटिव Compaction स्वामित्व

कुछ CLI बैकएंड ऐसा एजेंट चलाते हैं जो अपनी ट्रांसक्रिप्ट को स्वयं संकुचित करता है, इसलिए OpenClaw को उनके विरुद्ध अपना सुरक्षा सारांशकर्ता नहीं चलाना चाहिए—ऐसा करने से बैकएंड के अपने Compaction में टकराव होता है और संवाद पूरी तरह विफल हो सकता है।

claude-cli का कोई हार्नेस एंडपॉइंट नहीं है (Claude Code आंतरिक रूप से संकुचित करता है), इसलिए यह ownsNativeCompaction: true घोषित करता है और OpenClaw का Compaction पथ सत्र प्रविष्टि को अपरिवर्तित लौटाता है। OpenClaw रन के प्रभावी संदर्भ बजट को Claude Code के दस्तावेज़ीकृत CLAUDE_CODE_AUTO_COMPACT_WINDOW के माध्यम से पास करता है, जिससे नेटिव स्वचालित Compaction कॉन्फ़िगर की गई Anthropic contextTokens सीमाओं के अनुरूप रहता है। इसके बजाय Codex जैसे नेटिव-हार्नेस सत्र अपने हार्नेस Compaction एंडपॉइंट पर रूट होते रहते हैं।

api.registerCliBackend({ id: "my-cli", ownsNativeCompaction: true /* ... */ });

ownsNativeCompaction केवल ऐसे बैकएंड के लिए घोषित करें जो वास्तव में Compaction का स्वामी हो: उसे संदर्भ विंडो के आसपास अपनी ट्रांसक्रिप्ट को विश्वसनीय रूप से सीमित करना और फिर से शुरू किए जा सकने वाला सत्र (जैसे --resume / --session-id) बनाए रखना आवश्यक है, अन्यथा स्थगित सत्र बजट से अधिक रह सकता है।

बंडल MCP ओवरले

CLI बैकएंड को OpenClaw टूल कॉल सीधे प्राप्त नहीं होते, लेकिन कोई बैकएंड bundleMcp: true के साथ जनरेट किए गए MCP कॉन्फ़िगरेशन ओवरले को चुन सकता है। वर्तमान बंडल व्यवहार:

• claude-cli: जनरेट की गई कठोर MCP कॉन्फ़िगरेशन फ़ाइल।
• google-gemini-cli: जनरेट की गई Gemini सिस्टम सेटिंग फ़ाइल।

बंडल MCP सक्षम होने पर, OpenClaw:

• एक लूपबैक HTTP MCP सर्वर प्रारंभ करता है, जो CLI प्रक्रिया को Gateway टूल उपलब्ध कराता है और केवल वर्तमान निष्पादन प्रयास के लिए सक्रिय प्रति-रन संदर्भ अनुदान (OPENCLAW_MCP_TOKEN) से प्रमाणीकृत होता है;
• चाइल्ड-प्रोसेस हेडर पर भरोसा करने के बजाय, टूल एक्सेस को Gateway द्वारा चयनित सत्र, खाते और चैनल संदर्भ से बाँधता है;
• वर्तमान कार्यस्थान के लिए सक्षम बंडल-MCP सर्वर लोड करता है और उन्हें किसी भी मौजूदा बैकएंड MCP कॉन्फ़िगरेशन/सेटिंग आकार के साथ मर्ज करता है;
• स्वामी Plugin से प्राप्त बैकएंड-स्वामित्व वाले एकीकरण मोड का उपयोग करके लॉन्च कॉन्फ़िगरेशन को पुनर्लिखता है।

cron जॉब जैसे प्रतिबंधित रन, जिनमें toolsAllow होता है, के लिए बैकएंड के स्वामित्व वाला सटीक अनुवाद आवश्यक है। बंडल किया गया claude-cli बैकएंड Claude के मूल टूल और उपयोगकर्ता, प्रोजेक्ट तथा स्थानीय अनुकूलनों को अक्षम करता है, जिनमें हुक, plugins, एजेंट, skills और CLAUDE.md शामिल हैं। इसके बाद यह अनुदान-स्कोप वाले MCP सर्वर के माध्यम से प्रत्येक अनुमत OpenClaw टूल उपलब्ध कराता है। इससे फ़ाइल सिस्टम, प्रोसेस, exec, अनुमोदन और सैंडबॉक्स नीति OpenClaw के भीतर रहती है और Claude के मूल टूल या अनुकूलन प्रोसेस को अधिक अधिकार नहीं मिलते। यही MCP सूची Claude के जनरेट किए गए कॉन्फ़िगरेशन में और Gateway द्वारा टूल सूचीकरण तथा निष्पादन के समय फिर से लागू की जाती है। अनुदान जारी करने से पहले, कोर ऐसे बैकएंड अनुवादों को अस्वीकार करता है जो मूल अनुमति-सूची से बाहर की किसी MCP अनुमति का नाम देते हैं। सटीक अनुवाद के बिना बैकएंड अब भी सुरक्षित रूप से विफल होते हैं।

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

सत्र-स्कोप वाले बंडल MCP रनटाइम को एक सत्र के भीतर पुनः उपयोग के लिए कैश किया जाता है, फिर 10 मिनट तक निष्क्रिय रहने के बाद हटा दिया जाता है। प्रमाणीकरण जाँच, स्लग जनरेशन और Active Memory रिकॉल जैसे एकबारगी एम्बेडेड रन, रन समाप्त होने पर क्लीनअप का अनुरोध करते हैं, ताकि stdio चाइल्ड और Streamable HTTP/SSE स्ट्रीम रन के बाद भी सक्रिय न रहें।

claude-cli के लिए, चयनित या क्रमबद्ध संगत OpenClaw OAuth/टोकन प्रोफ़ाइल उस Claude चाइल्ड को अग्रेषित की जाती है। इससे उस टर्न के लिए प्रति-एजेंट प्रोफ़ाइल प्रामाणिक स्रोत बनती हैं, जबकि कोई संगत प्रोफ़ाइल मौजूद न होने पर Claude का मूल होस्ट लॉगिन बरकरार रहता है।

पुनः सीड किए गए इतिहास की सीमा

जब किसी नई CLI सत्र को पूर्व OpenClaw ट्रांसक्रिप्ट से सीड किया जाता है (उदाहरण के लिए session_expired पुनः प्रयास के बाद), तो रेंडर किए गए <conversation_history> ब्लॉक को सीमित किया जाता है, ताकि पुनः सीड प्रॉम्प्ट अनियंत्रित रूप से बड़े न हों। डिफ़ॉल्ट सीमा 12,288 वर्ण (लगभग 3,000 टोकन) है।

इसके बजाय Claude CLI बैकएंड इस सीमा को समाधान किए गए Claude कॉन्टेक्स्ट विंडो के अनुसार स्केल करते हैं: बड़े कॉन्टेक्स्ट विंडो को पूर्व इतिहास का बड़ा अंश मिलता है, जो एक निश्चित अधिकतम सीमा तक होता है; अन्य CLI बैकएंड सावधानीपूर्ण डिफ़ॉल्ट बनाए रखते हैं। यह सीमा केवल पुनः सीड प्रॉम्प्ट के पूर्व-इतिहास ब्लॉक को नियंत्रित करती है।

सीमाएँ

• OpenClaw, CLI बैकएंड प्रोटोकॉल में टूल कॉल प्रविष्ट नहीं करता। बैकएंड को Gateway टूल केवल तभी दिखाई देते हैं, जब वे bundleMcp: true का विकल्प चुनते हैं।
• स्ट्रीमिंग बैकएंड-विशिष्ट है: कुछ बैकएंड JSONL स्ट्रीम करते हैं, जबकि अन्य बाहर निकलने तक बफ़र करते हैं।
• संरचित आउटपुट CLI के अपने JSON फ़ॉर्मैट पर निर्भर करते हैं।

समस्या निवारण

संबंधित

• Gateway रनबुक
• स्थानीय मॉडल