एजेंट रनटाइम्स

एक एजेंट रनटाइम एक तैयार मॉडल लूप का स्वामी होता है: यह प्रॉम्प्ट प्राप्त करता है, मॉडल आउटपुट संचालित करता है, नेटिव टूल कॉल संभालता है, और पूर्ण टर्न OpenClaw को लौटाता है।

रनटाइम को प्रोवाइडर समझ लेना आसान है, क्योंकि दोनों मॉडल कॉन्फ़िगरेशन के आसपास दिखाई देते हैं। वे अलग-अलग परतें हैं:

हार्नेस वह कार्यान्वयन है जो एजेंट रनटाइम उपलब्ध कराता है (कोड शब्द)। उदाहरण के लिए, बंडल किया गया Codex हार्नेस codex रनटाइम लागू करता है। सार्वजनिक कॉन्फ़िगरेशन प्रोवाइडर या मॉडल प्रविष्टियों पर agentRuntime.id का उपयोग करता है; पूरे-एजेंट रनटाइम कुंजियाँ लेगेसी हैं और अनदेखी की जाती हैं। openclaw doctor --fix पुराने पूरे-एजेंट रनटाइम पिन हटाता है और जहाँ आवश्यक हो, लेगेसी रनटाइम मॉडल रेफ़ को कैनोनिकल प्रोवाइडर/मॉडल रेफ़ तथा मॉडल-स्कोप्ड रनटाइम नीति में पुनर्लिखता है।

दो रनटाइम परिवार:

• एम्बेडेड हार्नेस OpenClaw के तैयार एजेंट लूप के भीतर चलते हैं: अंतर्निहित openclaw रनटाइम और पंजीकृत Plugin हार्नेस, जैसे codex और copilot।
• CLI बैकएंड मॉडल रेफ़ को कैनोनिकल रखते हुए एक स्थानीय CLI प्रक्रिया चलाते हैं। उदाहरण के लिए, मॉडल-स्कोप्ड agentRuntime.id: "claude-cli" के साथ anthropic/claude-opus-5 का अर्थ है "Anthropic मॉडल चुनें, Claude CLI के माध्यम से निष्पादित करें।" claude-cli कोई एम्बेडेड हार्नेस आईडी नहीं है और इसे AgentHarness चयन को नहीं दिया जाना चाहिए।

copilot हार्नेस GitHub Copilot CLI के लिए एक अलग, वैकल्पिक बाहरी Plugin हार्नेस है; PI, Codex और GitHub Copilot एजेंट रनटाइम के बीच उपयोगकर्ता-सामना निर्णय के लिए GitHub Copilot एजेंट रनटाइम देखें।

Codex सतहें

कई सतहें Codex नाम साझा करती हैं:

ये सतहें जानबूझकर स्वतंत्र हैं। codex Plugin सक्षम करने से नेटिव ऐप-सर्वर सुविधाएँ उपलब्ध होती हैं; openclaw doctor --fix लेगेसी Codex रूट सुधार और पुराने सत्र पिन की सफ़ाई का स्वामी है। किसी एजेंट मॉडल के लिए openai/* चुनने का अब अर्थ है "इसे Codex के माध्यम से चलाएँ", जब तक कि किसी गैर-एजेंट OpenAI API सतह का उपयोग न हो रहा हो।

सामान्य ChatGPT/Codex सदस्यता सेटअप प्रमाणीकरण के लिए Codex OAuth का उपयोग करता है, लेकिन मॉडल रेफ़ को openai/* के रूप में रखता है और codex रनटाइम चुनता है:

{  agents: {    defaults: {      model: "openai/gpt-5.6-sol",    },  },}

इसका अर्थ है कि OpenClaw एक OpenAI मॉडल रेफ़ चुनता है, फिर Codex ऐप-सर्वर रनटाइम से एम्बेडेड एजेंट टर्न चलाने को कहता है। इसका अर्थ "API बिलिंग का उपयोग करना" नहीं है, और इसका अर्थ यह भी नहीं है कि चैनल, मॉडल प्रोवाइडर कैटलॉग या OpenClaw सत्र स्टोर Codex बन जाता है।

जब बंडल किया गया codex Plugin सक्षम हो, तो स्वाभाविक-भाषा Codex नियंत्रण के लिए ACP के बजाय नेटिव /codex कमांड सतह (/codex bind, /codex threads, /codex resume, /codex steer, /codex stop) का उपयोग करें। Codex के लिए ACP केवल तभी उपयोग करें जब उपयोगकर्ता स्पष्ट रूप से ACP/acpx माँगे या ACP अडैप्टर पथ का परीक्षण कर रहा हो। Claude Code, Gemini CLI, OpenCode, Cursor और इसी तरह के बाहरी हार्नेस अब भी ACP का उपयोग करते हैं।

निर्णय वृक्ष:

1. Codex बाइंड/नियंत्रण/थ्रेड/फिर से शुरू करना/निर्देशित करना/बंद करना -> बंडल किया गया codex Plugin सक्षम होने पर नेटिव /codex कमांड सतह।
2. एम्बेडेड रनटाइम के रूप में Codex या सामान्य सदस्यता-समर्थित Codex एजेंट अनुभव -> openai/<model>।
3. OpenAI मॉडल के लिए स्पष्ट रूप से चुना गया OpenClaw -> मॉडल रेफ़ को openai/<model> के रूप में रखें और प्रोवाइडर/मॉडल रनटाइम नीति को agentRuntime.id: "openclaw" पर सेट करें। चयनित openai OAuth प्रोफ़ाइल को आंतरिक रूप से OpenClaw के Codex-प्रमाणीकरण ट्रांसपोर्ट के माध्यम से रूट किया जाता है।
4. कॉन्फ़िगरेशन में लेगेसी Codex मॉडल रेफ़ -> openclaw doctor --fix से openai/<model> में सुधारें; जहाँ पुराने मॉडल रेफ़ से इसका संकेत मिलता था, वहाँ doctor प्रोवाइडर/मॉडल-स्कोप्ड agentRuntime.id: "codex" जोड़कर Codex प्रमाणीकरण रूट बनाए रखता है। लेगेसी codex-cli/* मॉडल रेफ़ उसी openai/<model> Codex ऐप-सर्वर रूट में सुधारे जाते हैं; OpenClaw अब बंडल किया गया Codex CLI बैकएंड नहीं रखता।
5. ACP, acpx या Codex ACP अडैप्टर स्पष्ट रूप से अनुरोधित -> runtime: "acp" और agentId: "codex"।
6. Claude Code, Gemini CLI, OpenCode, Cursor, Droid या कोई अन्य बाहरी हार्नेस -> ACP/acpx, नेटिव सब-एजेंट रनटाइम नहीं।

OpenAI-परिवार प्रीफ़िक्स विभाजन के लिए OpenAI और मॉडल प्रोवाइडर देखें। Codex रनटाइम समर्थन अनुबंध के लिए Codex हार्नेस रनटाइम देखें।

रनटाइम स्वामित्व

अलग-अलग रनटाइम लूप के अलग-अलग हिस्सों के स्वामी होते हैं:

डिज़ाइन नियम: यदि OpenClaw सतह का स्वामी है, तो वह सामान्य Plugin हुक व्यवहार प्रदान कर सकता है। यदि नेटिव रनटाइम सतह का स्वामी है, तो OpenClaw को रनटाइम इवेंट या नेटिव हुक चाहिए। यदि नेटिव रनटाइम कैनोनिकल थ्रेड स्थिति का स्वामी है, तो OpenClaw असमर्थित आंतरिक हिस्सों को पुनर्लिखने के बजाय संदर्भ को मिरर और प्रक्षेपित करता है।

रनटाइम चयन

OpenClaw प्रोवाइडर और मॉडल समाधान के बाद इस क्रम में एक एम्बेडेड रनटाइम निर्धारित करता है:

1. मॉडल-स्कोप्ड रनटाइम नीति को प्राथमिकता मिलती है। यह कॉन्फ़िगर की गई प्रोवाइडर मॉडल प्रविष्टि या agents.defaults.models["provider/model"].agentRuntime / agents.entries.*.models["provider/model"].agentRuntime में रहती है। agents.defaults.models["vllm/*"].agentRuntime जैसा प्रोवाइडर वाइल्डकार्ड सटीक मॉडल नीति के बाद लागू होता है, ताकि डायनेमिक रूप से खोजे गए प्रोवाइडर मॉडल सटीक प्रति-मॉडल अपवादों को ओवरराइड किए बिना एक रनटाइम साझा कर सकें।
2. प्रोवाइडर-स्कोप्ड रनटाइम नीति: models.providers.<provider>.agentRuntime।
3. auto मोड: पंजीकृत Plugin रनटाइम समर्थित प्रोवाइडर/मॉडल युग्मों पर दावा कर सकते हैं।
4. यदि auto मोड में कोई भी टर्न पर दावा नहीं करता, तो OpenClaw संगतता रनटाइम के रूप में openclaw पर वापस जाता है। रन को सख्त होना आवश्यक हो, तो स्पष्ट रनटाइम आईडी का उपयोग करें।

पूरे-सत्र और पूरे-एजेंट रनटाइम पिन अनदेखे किए जाते हैं: OPENCLAW_AGENT_RUNTIME, सत्र agentHarnessId/agentRuntimeOverride स्थिति, agents.defaults.agentRuntime, और agents.entries.*.agentRuntime। पुराने पूरे-एजेंट रनटाइम कॉन्फ़िगरेशन को हटाने और जहाँ आशय संरक्षित किया जा सकता है वहाँ लेगेसी रनटाइम मॉडल रेफ़ को बदलने के लिए openclaw doctor --fix चलाएँ।

स्पष्ट प्रोवाइडर/मॉडल Plugin रनटाइम बंद होकर विफल होते हैं: किसी प्रोवाइडर या मॉडल पर agentRuntime.id: "codex" का अर्थ Codex या स्पष्ट चयन/रनटाइम त्रुटि है—इसे कभी भी चुपचाप OpenClaw पर वापस रूट नहीं किया जाता। केवल auto किसी बेमेल टर्न को OpenClaw पर रूट कर सकता है।

CLI बैकएंड उपनाम एम्बेडेड हार्नेस आईडी से अलग होते हैं। पसंदीदा Claude CLI स्वरूप:

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

claude-cli/claude-opus-4-7 जैसे लेगेसी रेफ़ संगतता के लिए अब भी समर्थित हैं, लेकिन नए कॉन्फ़िगरेशन को प्रोवाइडर/मॉडल कैनोनिकल रखना चाहिए और निष्पादन बैकएंड को प्रोवाइडर/मॉडल रनटाइम नीति में रखना चाहिए।

लेगेसी codex-cli/* रेफ़ अलग हैं: doctor उन्हें openai/* में माइग्रेट करता है ताकि वे Codex CLI बैकएंड संरक्षित करने के बजाय Codex ऐप-सर्वर हार्नेस के माध्यम से चलें।

अधिकांश प्रोवाइडर के लिए auto मोड जानबूझकर रूढ़िवादी है। OpenAI एजेंट मॉडल अपवाद हैं: अनसेट रनटाइम और auto दोनों Codex हार्नेस में निर्धारित होते हैं। स्पष्ट OpenClaw रनटाइम कॉन्फ़िगरेशन openai/* एजेंट टर्न के लिए एक वैकल्पिक संगतता रूट बना रहता है; चयनित openai OAuth प्रोफ़ाइल के साथ युग्मित होने पर, OpenClaw सार्वजनिक मॉडल रेफ़ को openai/* के रूप में रखते हुए उस पथ को आंतरिक रूप से Codex-प्रमाणीकरण ट्रांसपोर्ट के माध्यम से रूट करता है। पुराने OpenAI रनटाइम सत्र पिन को रनटाइम चयन द्वारा अनदेखा किया जाता है और openclaw doctor --fix से साफ़ किया जा सकता है।

यदि openclaw doctor चेतावनी देता है कि codex plugin सक्षम है, जबकि पुराने Codex मॉडल संदर्भ अभी भी कॉन्फ़िगरेशन में मौजूद हैं, तो इसे पुराने रूट की स्थिति मानें और इसे Codex रनटाइम के साथ openai/* में फिर से लिखने के लिए openclaw doctor --fix चलाएँ।

GitHub Copilot एजेंट रनटाइम

बाहरी @openclaw/copilot plugin, GitHub Copilot CLI (@github/copilot-sdk) द्वारा समर्थित, ऑप्ट-इन copilot रनटाइम पंजीकृत करता है। यह मानक सब्सक्रिप्शन github-copilot प्रदाता का दावा करता है और auto द्वारा कभी भी नहीं चुना जाता। agentRuntime.id के माध्यम से प्रत्येक मॉडल या प्रदाता के लिए ऑप्ट-इन करें:

{  agents: {    defaults: {      model: "github-copilot/gpt-5.5",      models: {        "github-copilot/gpt-5.5": {          agentRuntime: { id: "copilot" },        },      },    },  },}

हार्नेस extensions/copilot/doctor-contract-api.ts में अपने प्रदाता, रनटाइम, CLI सत्र कुंजी और प्रमाणीकरण प्रोफ़ाइल उपसर्ग का दावा करता है, जिसे openclaw doctor स्वतः लोड करता है। कॉन्फ़िगरेशन, प्रमाणीकरण, ट्रांस्क्रिप्ट मिररिंग, Compaction, घोषणात्मक डॉक्टर अनुबंध और व्यापक PI बनाम Codex बनाम Copilot SDK निर्णय के लिए, GitHub Copilot एजेंट रनटाइम देखें।

संगतता अनुबंध

जब कोई रनटाइम OpenClaw नहीं होता, तो उसके दस्तावेज़ों में यह बताया जाना चाहिए कि वह किन OpenClaw सतहों का समर्थन करता है:

Codex रनटाइम समर्थन अनुबंध का दस्तावेज़ीकरण Codex हार्नेस रनटाइम में किया गया है।

स्थिति लेबल

स्थिति आउटपुट में Execution और Runtime दोनों लेबल दिखाई दे सकते हैं। उन्हें निदान के रूप में पढ़ें, प्रदाता के नाम के रूप में नहीं:

• openai/gpt-5.6-sol जैसा मॉडल संदर्भ चुना गया प्रदाता/मॉडल है।
• codex जैसी रनटाइम आईडी, टर्न निष्पादित करने वाला लूप है।
• Telegram या Discord जैसा चैनल लेबल वह स्थान है जहाँ बातचीत हो रही है।

यदि किसी रन में कोई अप्रत्याशित रनटाइम दिखाई देता है, तो पहले चुने गए प्रदाता/मॉडल की रनटाइम नीति की जाँच करें। पुराने सत्र रनटाइम पिन अब रूटिंग तय नहीं करते।

संबंधित

• Codex हार्नेस
• Codex हार्नेस रनटाइम
• GitHub Copilot एजेंट रनटाइम
• OpenAI
• एजेंट हार्नेस plugins
• एजेंट लूप
• मॉडल
• स्थिति