नेटिव Codex प्लगइन

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

आधार Codex हार्नेस के काम करने के बाद इस पेज का उपयोग करें।

आवश्यकताएँ

• एजेंट रनटाइम मूल Codex हार्नेस होना चाहिए।
• plugins.entries.codex.enabled true है।
• plugins.entries.codex.config.codexPlugins.enabled true है।
• लक्षित Codex app-server अपेक्षित मार्केटप्लेस, Plugin और ऐप इन्वेंटरी देख सकता हो।
• माइग्रेशन केवल उन openai-curated Plugins का समर्थन करता है जिन्हें उसने स्रोत Codex होम में स्रोत से इंस्टॉल किए हुए पाया है।
• मैन्युअल रूप से कॉन्फ़िगर किए गए workspace-directory Plugins के लिए ऐसा 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

माइग्रेशन पात्र Plugins के लिए स्पष्ट codexPlugins प्रविष्टियाँ लिखता है और चयनित Plugins के लिए 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 आईडी, विवरण आईडी या ऐप-तत्परता प्रमाण नहीं होता, तब OpenClaw ऐप्स को छिपा कर रखता है। यदि Codex स्पष्ट वर्कस्पेस plugin/list अनुरोध अस्वीकार करता है, तो OpenClaw प्रत्येक सक्षम वर्कस्पेस Plugin के लिए marketplace_missing रिपोर्ट करता है और स्वतंत्र रूप से खोजे गए किसी भी क्यूरेटेड Plugin को उपलब्ध रखता है।

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

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

/codex plugins उसी चैट से कॉन्फ़िगर किए गए मूल Codex Plugins की जाँच करता है या उन्हें बदलता है, जहाँ आप 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 Plugins इंस्टॉल नहीं करते। इन्हें केवल स्वामी या operator.admin स्कोप वाला Gateway क्लाइंट चला सकता है।

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

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

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

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

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

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

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

V1 समर्थन सीमा

• केवल स्रोत Codex app-server इन्वेंटरी में पहले से इंस्टॉल किए गए openai-curated Plugins ही माइग्रेशन के पात्र हैं।
• रनटाइम उन app-server बिल्ड पर स्पष्ट workspace-directory प्रविष्टियों का भी समर्थन करता है जिनका plugin/list, marketplaceKinds लागू करता है और पथ-रहित वर्कस्पेस सारांशों के लिए remotePluginId लौटाता है। इन प्रविष्टियों में उनका सटीक मार्केटप्लेस-योग्य summary.id उपयोग होना चाहिए और वे पहले से इंस्टॉल, सक्षम तथा ऐप-पहुँच योग्य होनी चाहिए। अस्वीकृत वर्कस्पेस सूची अनुरोध मौजूदा प्रति-Plugin marketplace_missing निदान उत्पन्न करता है; अनुपस्थित मार्केटप्लेस, Plugin, विवरण या ऐप प्रमाण कोई वर्कस्पेस ऐप प्रदर्शित नहीं करता। डिफ़ॉल्ट सूची अनुरोध से क्यूरेटेड इन्वेंटरी उपयोग योग्य रहती है।
• ऐप-समर्थित स्रोत Plugins को माइग्रेशन-समय सदस्यता गेट पार करना होगा। --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 विवरण से सटीक ऐप आईडी, ज्ञात 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 अनुमोदन अनुरोधों को Codex अनुमोदन प्रतिक्रिया लौटाने से पहले OpenClaw Plugin अनुमोदनों में बदलता है।
• "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