नेटिव Codex plugins

मूल Codex Plugin समर्थन, Codex-मोड OpenClaw एजेंट को उसी Codex थ्रेड के भीतर Codex app-server की अपनी ऐप और Plugin क्षमताओं का उपयोग करने देता है जो OpenClaw टर्न को संभालता है। Plugin कॉल मूल Codex ट्रांसक्रिप्ट में बने रहते हैं; ऐप-समर्थित MCP निष्पादन का स्वामित्व Codex app-server के पास होता है। OpenClaw Codex Plugin को कृत्रिम codex_plugin_* OpenClaw डायनेमिक टूल में परिवर्तित नहीं करता।

इस पेज का उपयोग तब करें, जब मूल Codex हार्नेस काम कर रहा हो।

आवश्यकताएँ

• एजेंट रनटाइम मूल Codex हार्नेस होना चाहिए।
• plugins.entries.codex.enabled true है।
• plugins.entries.codex.config.codexPlugins.enabled true है।
• लक्षित Codex app-server अपेक्षित मार्केटप्लेस, Plugin और ऐप इन्वेंटरी देख सकता हो।
• माइग्रेशन केवल उन openai-curated Plugin का समर्थन करता है जिन्हें उसने स्रोत Codex होम में स्रोत से इंस्टॉल किया हुआ पाया हो।
• मैन्युअल रूप से कॉन्फ़िगर किए गए workspace-directory Plugin के लिए ऐसा Codex app-server आवश्यक है जिसका plugin/list, marketplaceKinds स्वीकार करता हो और जिसके पथ-रहित वर्कस्पेस सारांशों में remotePluginId शामिल हो। Plugin पहले से इंस्टॉल और सक्षम होना चाहिए तथा उसके स्वामित्व वाले ऐप app/list में सुलभ होने चाहिए।

codexPlugins का OpenClaw-प्रदाता रन, ACP वार्तालाप बाइंडिंग या अन्य हार्नेस पर कोई प्रभाव नहीं पड़ता, क्योंकि वे पथ मूल apps कॉन्फ़िगरेशन वाले Codex app-server थ्रेड कभी नहीं बनाते।

OpenAI-पक्ष का Codex खाता, ऐप उपलब्धता और वर्कस्पेस ऐप/Plugin नियंत्रण साइन-इन किए गए Codex खाते से आते हैं। OpenAI खाते और एडमिन मॉडल के लिए अपने ChatGPT प्लान के साथ Codex का उपयोग देखें।

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

स्रोत Codex होम से माइग्रेशन का पूर्वावलोकन करें:

openclaw migrate codex --dry-run

माइग्रेशन से स्रोत app/list को कॉल कराने और मूल सक्रियण की योजना बनाने से पहले प्रत्येक स्वामित्व वाले ऐप का मौजूद, सक्षम और सुलभ होना आवश्यक बनाने के लिए --verify-plugin-apps जोड़ें:

openclaw migrate codex --dry-run --verify-plugin-apps

योजना सही दिखने पर माइग्रेशन लागू करें:

openclaw migrate apply codex --yes

माइग्रेशन पात्र Plugin के लिए स्पष्ट codexPlugins प्रविष्टियाँ लिखता है और चुने गए Plugin के लिए Codex app-server plugin/install को कॉल करता है। माइग्रेट किया गया कॉन्फ़िगरेशन ऐसा दिखाई देता है:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_destructive_actions: true,            plugins: {              "google-calendar": {                enabled: true,                marketplaceName: "openai-curated",                pluginName: "google-calendar",              },            },          },        },      },    },  },}

माइग्रेशन openai-curated तक सीमित रहता है। किसी मौजूदा workspace-directory Plugin का उपयोग करने के लिए, plugin/list द्वारा लौटाया गया सटीक मार्केटप्लेस-योग्य summary.id मैन्युअल रूप से जोड़ें। उदाहरण के लिए, यदि Codex example-plugin@workspace-directory लौटाता है, तो उसके प्रदर्शन नाम के बजाय उस पूर्ण मान को कॉन्फ़िगर करें:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            plugins: {              "example-plugin": {                enabled: true,                marketplaceName: "workspace-directory",                pluginName: "example-plugin@workspace-directory",              },            },          },        },      },    },  },}

OpenClaw किसी workspace-directory Plugin के लिए plugin/install को कॉल नहीं करता या प्रमाणीकरण शुरू नहीं करता। OpenClaw नीति जोड़ने या सक्षम करने से पहले उसे Codex में इंस्टॉल, सक्षम और प्रमाणीकृत करें। जब प्रतिक्रिया सटीक मार्केटप्लेस, Plugin ID, विवरण ID या ऐप-तत्परता प्रमाण छोड़ देती है, तब OpenClaw ऐप छिपाकर रखता है। यदि Codex स्पष्ट वर्कस्पेस plugin/list अनुरोध अस्वीकार करता है, तो OpenClaw प्रत्येक सक्षम वर्कस्पेस Plugin के लिए marketplace_missing रिपोर्ट करता है और स्वतंत्र रूप से खोजे गए किसी भी क्यूरेटेड Plugin को उपलब्ध रखता है।

codexPlugins में परिवर्तन के बाद, नए Codex वार्तालाप अपडेट किया गया ऐप सेट अपने आप अपना लेते हैं। वर्तमान वार्तालाप रीफ़्रेश करने के लिए /new या /reset चलाएँ। Plugin सक्षम/अक्षम करने के परिवर्तनों के लिए Gateway को पुनः आरंभ करना आवश्यक नहीं है।

चैट से Plugin प्रबंधित करें

/codex plugins उसी चैट से कॉन्फ़िगर किए गए मूल Codex Plugin की जाँच या उनमें परिवर्तन करता है जहाँ आप Codex हार्नेस संचालित करते हैं:

/codex plugins/codex plugins list/codex plugins disable google-calendar/codex plugins enable google-calendar

/codex plugins, /codex plugins list का उपनाम है। सूची प्रत्येक कॉन्फ़िगर किए गए Plugin की कुंजी, चालू/बंद स्थिति, Codex Plugin नाम और plugins.entries.codex.config.codexPlugins.plugins से प्राप्त मार्केटप्लेस दिखाती है।

enable/disable केवल ~/.openclaw/openclaw.json में लिखते हैं; वे कभी भी ~/.codex/config.toml को संपादित या नए Codex Plugin इंस्टॉल नहीं करते। केवल स्वामी या operator.admin स्कोप वाला Gateway क्लाइंट उन्हें चला सकता है।

किसी कॉन्फ़िगर किए गए Plugin को सक्षम करने से वैश्विक codexPlugins.enabled स्विच भी चालू हो जाता है। यदि कोई क्यूरेटेड Plugin अक्षम लिखा गया था क्योंकि माइग्रेशन ने auth_required लौटाया था, तो उसे OpenClaw में सक्षम करने से पहले ऐप को Codex में फिर से अधिकृत करें। किसी workspace-directory प्रविष्टि के लिए, उसे यहाँ सक्षम करने से केवल OpenClaw नीति बदलती है; Plugin और ऐप पहले से Codex में सक्रिय होने चाहिए।

मूल Plugin सेटअप कैसे काम करता है

एकीकरण तीन स्थितियों को ट्रैक करता है:

openai-curated Plugin के लिए, माइग्रेशन स्थायी इंस्टॉल/पात्रता चरण है:

• योजना बनाते समय, OpenClaw स्रोत Codex plugin/read विवरण पढ़ता है और जाँचता है कि स्रोत Codex app-server खाता ChatGPT सदस्यता खाता है। गैर-ChatGPT या अनुपस्थित खाता प्रतिक्रिया होने पर ऐप-समर्थित Plugin को codex_subscription_required के साथ छोड़ दिया जाता है।
• डिफ़ॉल्ट रूप से, माइग्रेशन स्रोत app/list कॉल छोड़ देता है: खाता जाँच पार करने वाले ऐप-समर्थित स्रोत Plugin की योजना स्रोत ऐप सुलभता सत्यापन के बिना बनाई जाती है, और खाता-लुकअप परिवहन विफलताओं के कारण उन्हें codex_account_unavailable के साथ छोड़ दिया जाता है।
• --verify-plugin-apps के साथ, माइग्रेशन नया स्रोत app/list स्नैपशॉट लेता है और मूल सक्रियण की योजना बनाने से पहले प्रत्येक स्वामित्व वाले ऐप का मौजूद, सक्षम और सुलभ होना आवश्यक बनाता है। तब खाता-लुकअप परिवहन विफलताएँ सीधे छोड़ दिए जाने के बजाय स्रोत ऐप-इन्वेंटरी जाँच तक आगे बढ़ती हैं।

workspace-directory Plugin के लिए, सेटअप OpenClaw के बाहर होता है। OpenClaw उस मार्केटप्लेस को केवल तभी क्वेरी करता है जब कम-से-कम एक सक्षम वर्कस्पेस प्रविष्टि कॉन्फ़िगर की गई हो, प्रत्येक Plugin को सटीक summary.id द्वारा हल करता है और मौजूदा plugin/read स्वामित्व तथा app/list तत्परता जाँच का पुनः उपयोग करता है। इंस्टॉल न किया गया, अक्षम, अगम्य या अप्रमाणीकृत Plugin कोई ऐप उजागर नहीं करता; OpenClaw इंस्टॉलेशन या प्रमाणीकरण का प्रयास नहीं करता।

रनटाइम ऐप इन्वेंटरी, माइग्रेट किए गए क्यूरेटेड Plugin और मैन्युअल रूप से कॉन्फ़िगर किए गए वर्कस्पेस Plugin—दोनों के लिए लक्षित-सत्र सुलभता जाँच है। Codex हार्नेस सत्र सेटअप सक्षम और सुलभ Plugin ऐप से प्रतिबंधात्मक थ्रेड ऐप कॉन्फ़िगरेशन की गणना करता है; इसकी गणना हर टर्न पर दोबारा नहीं होती, इसलिए /codex plugins enable/disable केवल नए Codex वार्तालापों को प्रभावित करते हैं। वर्तमान वार्तालाप में परिवर्तन अपनाने के लिए /new या /reset का उपयोग करें।

V1 समर्थन सीमा

• केवल स्रोत Codex app-server इन्वेंटरी में पहले से इंस्टॉल किए गए openai-curated Plugin माइग्रेशन के पात्र हैं।
• रनटाइम उन app-server बिल्ड पर स्पष्ट workspace-directory प्रविष्टियों का भी समर्थन करता है जिनका plugin/list, marketplaceKinds लागू करता है और पथ-रहित वर्कस्पेस सारांशों के लिए remotePluginId लौटाता है। इन प्रविष्टियों को अपने सटीक मार्केटप्लेस-योग्य summary.id का उपयोग करना चाहिए और पहले से इंस्टॉल, सक्षम तथा ऐप-सुलभ होना चाहिए। अस्वीकृत वर्कस्पेस सूची अनुरोध मौजूदा प्रति-Plugin marketplace_missing निदान उत्पन्न करता है; अनुपस्थित मार्केटप्लेस, Plugin, विवरण या ऐप प्रमाण कोई वर्कस्पेस ऐप उजागर नहीं करता। डिफ़ॉल्ट सूची अनुरोध से प्राप्त क्यूरेटेड इन्वेंटरी उपयोग योग्य रहती है।
• ऐप-समर्थित स्रोत Plugin को माइग्रेशन-समय सदस्यता जाँच पार करनी होगी। --verify-plugin-apps स्रोत ऐप-इन्वेंटरी जाँच जोड़ता है। सदस्यता जाँच से रोके गए खाते और सत्यापन मोड में अगम्य/अक्षम/अनुपस्थित स्रोत ऐप या ऐप-इन्वेंटरी रीफ़्रेश विफलताएँ, सक्षम कॉन्फ़िगरेशन प्रविष्टियों के बजाय छोड़े गए मैन्युअल आइटम के रूप में रिपोर्ट की जाती हैं। अपठनीय Plugin विवरण ऐप-इन्वेंटरी जाँच से पहले छोड़ दिए जाते हैं।
• माइग्रेशन स्पष्ट Plugin पहचानें (marketplaceName और pluginName) लिखता है; यह स्थानीय marketplacePath कैश पथ नहीं लिखता।
• codexPlugins.enabled एकमात्र वैश्विक सक्षमता स्विच है; कोई plugins["*"] वाइल्डकार्ड या कॉन्फ़िगरेशन कुंजी नहीं है जो मनमाना इंस्टॉल प्राधिकार प्रदान करे।
• गैर-क्यूरेटेड मार्केटप्लेस, कैश किए गए Plugin बंडल, हुक और Codex कॉन्फ़िगरेशन फ़ाइलें मैन्युअल समीक्षा के लिए माइग्रेशन रिपोर्ट में संरक्षित रहती हैं, स्वतः सक्रिय नहीं की जातीं। रनटाइम मैन्युअल रूप से कॉन्फ़िगर की गई workspace-directory प्रविष्टियाँ स्वीकार करता है; अन्य मार्केटप्लेस असमर्थित रहते हैं।

ऐप इन्वेंटरी और स्वामित्व

OpenClaw app-server app/list के माध्यम से Codex ऐप इन्वेंटरी पढ़ता है, उसे एक घंटे के लिए मेमोरी में कैश करता है और पुरानी या अनुपस्थित प्रविष्टियों को अतुल्यकालिक रूप से रीफ़्रेश करता है। कैश प्रक्रिया-स्थानीय है; CLI या Gateway को पुनः आरंभ करने से वह हट जाता है और OpenClaw अगले app/list पठन से उसे फिर बनाता है।

माइग्रेशन और रनटाइम अलग-अलग कैश कुंजियों का उपयोग करते हैं:

• स्रोत माइग्रेशन सत्यापन स्रोत Codex होम और प्रारंभ विकल्पों का उपयोग करता है। यह केवल --verify-plugin-apps के साथ चलता है और उस योजना रन के लिए नया स्रोत app/list ट्रैवर्सल बाध्य करता है।
• लक्षित रनटाइम सेटअप, थ्रेड ऐप कॉन्फ़िगरेशन बनाते समय लक्षित एजेंट की Codex app-server पहचान का उपयोग करता है। क्यूरेटेड Plugin सक्रियण उस लक्षित कैश कुंजी को अमान्य करता है, फिर plugin/install के बाद उसे बलपूर्वक रीफ़्रेश करता है। workspace-directory सेटअप इस सक्रियण पथ को कभी नहीं चलाता।

कोई Plugin ऐप केवल तभी उजागर होता है जब OpenClaw स्थिर स्वामित्व के माध्यम से उसे कॉन्फ़िगर किए गए Plugin से वापस मैप कर सके: Plugin विवरण से सटीक ऐप ID, ज्ञात MCP सर्वर नाम या अद्वितीय स्थिर मेटाडेटा। केवल प्रदर्शन-नाम वाला या अस्पष्ट स्वामित्व तब तक बाहर रखा जाता है, जब तक अगला इन्वेंटरी रीफ़्रेश स्वामित्व प्रमाणित न कर दे।

कनेक्ट किए गए खाता ऐप

स्वामी द्वारा संचालित एजेंट, मेल खाने वाले Plugin पैकेज की आवश्यकता के बिना अपने Codex खाते से पहले से जुड़े प्रत्येक ऐप को चुन सकते हैं:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          codexPlugins: {            enabled: true,            allow_all_plugins: true,            allow_destructive_actions: "auto",          },        },      },    },  },}

नया मूल Codex थ्रेड स्थापित होने पर allow_all_plugins: true एक पूर्ण app/list स्नैपशॉट लेता है और केवल उस खाते के लिए सुलभ चिह्नित ऐप को स्वीकार करता है। यह ऐप को वैश्विक रूप से इंस्टॉल, प्रमाणीकृत या सक्षम नहीं करता। मौजूदा थ्रेड अपना स्थायी ऐप सेट बनाए रखते हैं; नए जुड़े या निरस्त ऐप अपनाने के लिए /new, /reset का उपयोग करें या Gateway को पुनः आरंभ करें।

खाता ऐप्स वैश्विक codexPlugins.allow_destructive_actions मान को इनहेरिट करते हैं, जो true, false, "auto", या "ask" स्वीकार करता है। स्पष्ट प्रति-Plugin नीति ओवरलैप होने वाली ऐप आईडी के लिए वैश्विक नीति को ओवरराइड करती है। इन्वेंटरी विफलताओं में अप्रतिबंधित डिफ़ॉल्ट पर वापस जाने के बजाय पहुँच बंद रहती है।

थ्रेड ऐप कॉन्फ़िगरेशन

OpenClaw Codex थ्रेड के लिए एक प्रतिबंधात्मक config.apps पैच इंजेक्ट करता है: _default अक्षम रहता है, और केवल सक्षम व कॉन्फ़िगर किए गए Plugins के स्वामित्व वाले ऐप्स या allow_all_plugins द्वारा स्वीकार किए गए पहुँच-योग्य खाता ऐप्स सक्षम रहते हैं।

प्रत्येक ऐप पर destructive_enabled प्रभावी वैश्विक या प्रति-Plugin allow_destructive_actions नीति से आता है; true, "auto", और "ask" सभी destructive_enabled: true सेट करते हैं, और false इसे false सेट करता है। Codex फिर भी अपने मूल ऐप टूल एनोटेशन से विनाशकारी टूल मेटाडेटा लागू करता है। _default, open_world_enabled: false के साथ अक्षम रहता है; सक्षम Plugin ऐप्स को open_world_enabled: true मिलता है। OpenClaw कोई अलग Plugin-स्तरीय ओपन-वर्ल्ड नीति नियंत्रण उपलब्ध नहीं कराता और प्रति-Plugin विनाशकारी टूल-नाम निषेध सूचियाँ नहीं रखता।

स्वीकृत ऐप्स के लिए टूल अनुमोदन मोड डिफ़ॉल्ट रूप से स्वचालित होता है, इसलिए गैर-विनाशकारी रीड टूल उसी थ्रेड में अनुमोदन संकेत के बिना चलते हैं। विनाशकारी टूल प्रत्येक ऐप की destructive_enabled नीति द्वारा नियंत्रित रहते हैं।

विनाशकारी कार्रवाई नीति

कॉन्फ़िगर किए गए Codex Plugins के लिए विनाशकारी Plugin अनुरोध डिफ़ॉल्ट रूप से अनुमत हैं, जबकि असुरक्षित स्कीमा और अस्पष्ट स्वामित्व में पहुँच बंद रहती है:

• वैश्विक allow_destructive_actions का डिफ़ॉल्ट true है।
• प्रति-Plugin allow_destructive_actions उस Plugin के लिए वैश्विक नीति को ओवरराइड करता है।
• false: OpenClaw एक नियतात्मक अस्वीकृति लौटाता है।
• true: OpenClaw केवल उन सुरक्षित स्कीमा को स्वतः स्वीकार करता है जिन्हें वह किसी अनुमोदन प्रतिक्रिया से मैप कर सकता है, जैसे कि बूलियन अनुमोदन फ़ील्ड।
• "auto": OpenClaw विनाशकारी Plugin कार्रवाइयाँ Codex के समक्ष उपलब्ध कराता है, फिर स्वामित्व-प्रमाणित MCP अनुमोदन अनुरोधों को OpenClaw Plugin अनुमोदनों में बदलकर Codex अनुमोदन प्रतिक्रिया लौटाता है।
• "ask": OpenClaw, "auto" के समान Codex लेखन/विनाशकारी नियंत्रण का उपयोग करता है, थ्रेड शुरू होने से पहले ऐप के लिए स्थायी Codex प्रति-टूल अनुमोदन ओवरराइड हटाता है, और केवल एक-बार का अनुमोदन या अस्वीकृति देता है, ताकि स्थायी अनुमोदन बाद की लेखन-कार्रवाई के संकेतों को दबा न सकें। "ask" का उपयोग करने वाले प्रत्येक स्वीकृत ऐप के लिए, OpenClaw उस ऐप हेतु Codex का मानव अनुमोदन समीक्षक चुनता है, ताकि Codex अपने अनुमोदन अनुरोध OpenClaw को भेजे; अन्य ऐप्स और गैर-ऐप थ्रेड अनुमोदन अपने कॉन्फ़िगर किए गए समीक्षक और नीति को बनाए रखते हैं।
• Plugin पहचान अनुपस्थित होने, स्वामित्व अस्पष्ट होने, टर्न आईडी अनुपस्थित या असंगत होने, या अनुरोध स्कीमा असुरक्षित होने पर संकेत देने के बजाय अनुरोध अस्वीकार कर दिया जाता है।

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

वर्कस्पेस Plugin इंस्टॉल है लेकिन दिखाई नहीं देता: पुष्टि करें कि वर्कस्पेस plugin/list परिणाम सटीक कॉन्फ़िगर की गई आईडी को इंस्टॉल और सक्षम के रूप में रिपोर्ट करता है, फिर पुष्टि करें कि app/list उसी Codex खाते के लिए प्रत्येक स्वामित्व वाले ऐप को पहुँच-योग्य रिपोर्ट करता है। OpenClaw थ्रेड के लिए किसी पहुँच-योग्य ऐप को तब भी सक्षम कर सकता है, जब खाता इन्वेंटरी वर्तमान में उस ऐप को अक्षम रिपोर्ट करती हो। यदि आपने Gateway द्वारा ऐप इन्वेंटरी कैश किए जाने के बाद वह स्थिति बदली है, तो एक घंटे के कैश रीफ़्रेश की प्रतीक्षा करें या Gateway पुनः आरंभ करें, फिर /new या /reset का उपयोग करें। OpenClaw वर्कस्पेस Plugins की मरम्मत या प्रमाणीकरण नहीं करता। यदि स्पष्ट वर्कस्पेस सूची अनुरोध अस्वीकार होता है, तो प्रत्येक सक्षम वर्कस्पेस प्रविष्टि marketplace_missing रिपोर्ट करती है; असंबंधित क्यूरेट की गई प्रविष्टियाँ फिर भी डिफ़ॉल्ट सूची प्रतिक्रिया से आगे बढ़ती हैं।

plugin_detail_unavailable के लिए, पथ-विहीन वर्कस्पेस सारांश में remotePluginId शामिल होना चाहिए; वह चयनकर्ता या बाद का plugin/read परिणाम अनुपलब्ध होने पर OpenClaw स्वामित्व वाले ऐप्स छिपाए रखता है। plugin_activation_failed के लिए, क्यूरेट किए गए Plugins मार्केटप्लेस, प्रमाणीकरण, या इंस्टॉल के बाद रीफ़्रेश विफलता रिपोर्ट कर सकते हैं। कोई वर्कस्पेस Plugin यह कोड तब रिपोर्ट करता है जब वह पहले से सक्रिय न हो; उसे OpenClaw के बाहर इंस्टॉल, सक्षम और प्रमाणित करें।

कॉन्फ़िगरेशन बदल गया लेकिन एजेंट Plugin नहीं देख सकता: कॉन्फ़िगर की गई स्थिति की पुष्टि करने के लिए /codex plugins list चलाएँ, फिर /new या /reset चलाएँ। मौजूदा Codex थ्रेड बाइंडिंग अपने आरंभिक ऐप कॉन्फ़िगरेशन को तब तक बनाए रखती हैं, जब तक OpenClaw नया हार्नेस सत्र स्थापित नहीं करता या किसी पुराने बाइंडिंग को बदल नहीं देता।

विनाशकारी कार्रवाई अस्वीकार की गई है: वैश्विक और प्रति-Plugin allow_destructive_actions मान जाँचें। true, "auto", या "ask" के साथ भी, असुरक्षित अनुरोध स्कीमा और अस्पष्ट Plugin पहचान में पहुँच बंद रहती है।

संबंधित

• Codex हार्नेस
• Codex हार्नेस संदर्भ
• Codex हार्नेस रनटाइम
• कॉन्फ़िगरेशन संदर्भ
• माइग्रेट CLI