हार्नेस वह कार्यान्वयन है जो एजेंट रनटाइम उपलब्ध कराता है (कोड
शब्द)। उदाहरण के लिए, बंडल किया गया 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 रनटाइम चुनता है:
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 का उपयोग करते हैं।
निर्णय वृक्ष:
- Codex बाइंड/नियंत्रण/थ्रेड/फिर से शुरू करना/निर्देशित करना/बंद करना -> बंडल किया गया
codexPlugin सक्षम होने पर नेटिव/codexकमांड सतह। - एम्बेडेड रनटाइम के रूप में Codex या सामान्य सदस्यता-समर्थित Codex एजेंट अनुभव ->
openai/<model>। - OpenAI मॉडल के लिए स्पष्ट रूप से चुना गया OpenClaw -> मॉडल रेफ़ को
openai/<model>के रूप में रखें और प्रोवाइडर/मॉडल रनटाइम नीति कोagentRuntime.id: "openclaw"पर सेट करें। चयनितopenaiOAuth प्रोफ़ाइल को आंतरिक रूप से OpenClaw के Codex-प्रमाणीकरण ट्रांसपोर्ट के माध्यम से रूट किया जाता है। - कॉन्फ़िगरेशन में लेगेसी Codex मॉडल रेफ़ ->
openclaw doctor --fixसेopenai/<model>में सुधारें; जहाँ पुराने मॉडल रेफ़ से इसका संकेत मिलता था, वहाँ doctor प्रोवाइडर/मॉडल-स्कोप्डagentRuntime.id: "codex"जोड़कर Codex प्रमाणीकरण रूट बनाए रखता है। लेगेसीcodex-cli/*मॉडल रेफ़ उसीopenai/<model>Codex ऐप-सर्वर रूट में सुधारे जाते हैं; OpenClaw अब बंडल किया गया Codex CLI बैकएंड नहीं रखता। - ACP, acpx या Codex ACP अडैप्टर स्पष्ट रूप से अनुरोधित ->
runtime: "acp"औरagentId: "codex"। - Claude Code, Gemini CLI, OpenCode, Cursor, Droid या कोई अन्य बाहरी हार्नेस -> ACP/acpx, नेटिव सब-एजेंट रनटाइम नहीं।
OpenAI-परिवार प्रीफ़िक्स विभाजन के लिए OpenAI और
मॉडल प्रोवाइडर देखें। Codex रनटाइम समर्थन
अनुबंध के लिए Codex हार्नेस रनटाइम देखें।
रनटाइम स्वामित्व
अलग-अलग रनटाइम लूप के अलग-अलग हिस्सों के स्वामी होते हैं:
डिज़ाइन नियम: यदि OpenClaw सतह का स्वामी है, तो वह सामान्य Plugin हुक
व्यवहार प्रदान कर सकता है। यदि नेटिव रनटाइम सतह का स्वामी है, तो OpenClaw को रनटाइम
इवेंट या नेटिव हुक चाहिए। यदि नेटिव रनटाइम कैनोनिकल थ्रेड स्थिति का स्वामी है,
तो OpenClaw असमर्थित आंतरिक हिस्सों को पुनर्लिखने के बजाय संदर्भ को मिरर और प्रक्षेपित करता है।
रनटाइम चयन
OpenClaw प्रोवाइडर और मॉडल समाधान के बाद इस क्रम में एक एम्बेडेड रनटाइम निर्धारित करता है:- मॉडल-स्कोप्ड रनटाइम नीति को प्राथमिकता मिलती है। यह कॉन्फ़िगर की गई प्रोवाइडर
मॉडल प्रविष्टि या
agents.defaults.models["provider/model"].agentRuntime/agents.entries.*.models["provider/model"].agentRuntimeमें रहती है।agents.defaults.models["vllm/*"].agentRuntimeजैसा प्रोवाइडर वाइल्डकार्ड सटीक मॉडल नीति के बाद लागू होता है, ताकि डायनेमिक रूप से खोजे गए प्रोवाइडर मॉडल सटीक प्रति-मॉडल अपवादों को ओवरराइड किए बिना एक रनटाइम साझा कर सकें। - प्रोवाइडर-स्कोप्ड रनटाइम नीति:
models.providers.<provider>.agentRuntime। autoमोड: पंजीकृत Plugin रनटाइम समर्थित प्रोवाइडर/मॉडल युग्मों पर दावा कर सकते हैं।- यदि
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 स्वरूप:
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 के माध्यम से प्रत्येक मॉडल या प्रदाता के लिए ऑप्ट-इन करें:
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 जैसा चैनल लेबल वह स्थान है जहाँ बातचीत हो रही है।