Plugins Codex الأصلية

يتيح دعم Plugins الأصلية في Codex لوكيل OpenClaw في وضع Codex استخدام إمكانات التطبيقات وPlugins الخاصة بخادم تطبيق Codex داخل سلسلة Codex نفسها التي تتعامل مع دورة OpenClaw.

لا يترجم OpenClaw Plugins الخاصة بـ Codex إلى أدوات OpenClaw ديناميكية اصطناعية باسم codex_plugin_*. تبقى استدعاءات Plugins داخل نسخة Codex الأصلية، ويتولى خادم تطبيق Codex تنفيذ MCP المدعوم بالتطبيقات.

استخدم هذه الصفحة بعد أن يكون مشغل Codex الأساسي عاملا.

المتطلبات

• يجب أن يكون وقت تشغيل وكيل OpenClaw المحدد هو مشغل Codex الأصلي.
• يجب أن تكون plugins.entries.codex.enabled بقيمة true.
• يجب أن تكون plugins.entries.codex.config.codexPlugins.enabled بقيمة true.
• يدعم V1 فقط Plugins من openai-curated التي لاحظت الهجرة أنها مثبتة من المصدر في موطن Codex المصدر.
• يجب أن يكون خادم تطبيق Codex الهدف قادرا على رؤية marketplace وPlugin ومخزون التطبيقات المتوقع.

لا يؤثر codexPlugins في تشغيلات OpenClaw أو تشغيلات موفر OpenAI العادية أو روابط محادثات ACP أو المشغلات الأخرى، لأن تلك المسارات لا تنشئ سلاسل خادم تطبيق Codex بإعداد apps أصلي.

تأتي إمكانية الوصول إلى Codex من جهة OpenAI وتوفر التطبيقات وضوابط تطبيقات/Plugins مساحة العمل من حساب Codex المسجل دخوله. للاطلاع على حساب OpenAI ونموذج الإدارة، راجع استخدام Codex مع خطة ChatGPT الخاصة بك.

البدء السريع

عاين الهجرة من موطن Codex المصدر:

openclaw migrate codex --dry-run

استخدم التحقق الصارم من تطبيقات المصدر عندما تريد أن تتحقق الهجرة من إمكانية الوصول إلى تطبيقات المصدر قبل التخطيط لتفعيل Plugins الأصلية:

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

طبق الهجرة عندما تبدو الخطة صحيحة:

openclaw migrate apply codex --yes

تكتب الهجرة إدخالات codexPlugins صريحة للـ Plugins المؤهلة وتستدعي plugin/install في خادم تطبيق Codex للـ Plugins المحددة. يبدو الإعداد المرحل النموذجي كما يلي:

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

بعد تغيير codexPlugins، تلتقط محادثات Codex الجديدة مجموعة التطبيقات المحدثة تلقائيا. استخدم /new أو /reset لتحديث المحادثة الحالية. لا يلزم إعادة تشغيل Gateway لتغييرات تمكين Plugin أو تعطيله.

إدارة Plugins من الدردشة

استخدم /codex plugins عندما تريد فحص Plugins الأصلية في Codex أو تغيير إعدادها من الدردشة نفسها التي تشغل فيها مشغل Codex:

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

/codex plugins هو اسم مستعار لـ /codex plugins list. يعرض خرج القائمة مفاتيح Plugins المضبوطة، وحالة التشغيل/الإيقاف، واسم Plugin في Codex، وmarketplace من plugins.entries.codex.config.codexPlugins.plugins.

يكتب enable وdisable فقط في إعداد OpenClaw عند ~/.openclaw/openclaw.json؛ ولا يحرران ~/.codex/config.toml أو يثبتان Plugins جديدة في Codex. يمكن للمالك فقط أو عميل Gateway لديه نطاق operator.admin تغيير حالة Plugin.

يؤدي تمكين Plugin مضبوط أيضا إلى تشغيل مفتاح codexPlugins.enabled العام. إذا كُتب Plugin معطلا لأن الهجرة أعادت auth_required، فأعد تفويض التطبيق في Codex قبل تمكينه في OpenClaw.

كيف يعمل إعداد Plugins الأصلي

للتكامل ثلاث حالات منفصلة:

• مثبت: لدى Codex حزمة Plugin المحلية في وقت تشغيل خادم التطبيق الهدف.
• ممكّن: إعداد OpenClaw مستعد لإتاحة Plugin لدورات مشغل Codex.
• قابل للوصول: يؤكد خادم تطبيق Codex أن إدخالات تطبيقات Plugin متاحة للحساب النشط ويمكن ربطها بهوية Plugin المرحلة.

الهجرة هي خطوة التثبيت/الأهلية الدائمة. أثناء التخطيط، يقرأ OpenClaw تفاصيل plugin/read في Codex المصدر ويتحقق من أن استجابة حساب خادم تطبيق Codex المصدر هي حساب اشتراك ChatGPT. تتخطى استجابات الحساب غير ChatGPT أو المفقودة Plugins المدعومة بالتطبيقات مع codex_subscription_required. افتراضيا، لا تستدعي الهجرة app/list من المصدر؛ وتُخطط Plugins المصدر المدعومة بالتطبيقات التي تجتاز بوابة الحساب دون التحقق من إمكانية الوصول إلى تطبيقات المصدر، وتتخطى أعطال نقل بحث الحساب مع codex_account_unavailable. مع --verify-plugin-apps، تأخذ الهجرة لقطة جديدة من app/list المصدر وتتطلب أن يكون كل تطبيق مملوك موجودا وممكنا وقابلا للوصول قبل التخطيط للتفعيل الأصلي. في ذلك الوضع، تمر أعطال نقل بحث الحساب إلى بوابة مخزون التطبيقات المصدرية. مخزون تطبيقات وقت التشغيل هو فحص إمكانية الوصول في الجلسة الهدف بعد الهجرة. ثم يحسب إعداد جلسة مشغل Codex إعداد تطبيقات سلسلة مقيدا لتطبيقات Plugins الممكنة والقابلة للوصول.

يُحسب إعداد تطبيقات السلسلة عندما ينشئ OpenClaw جلسة مشغل Codex أو يستبدل ربط سلسلة Codex قديما. لا يُعاد حسابه في كل دورة، لذلك يؤثر /codex plugins enable و/codex plugins disable في محادثات Codex الجديدة. استخدم /new أو /reset عندما يجب أن تلتقط المحادثة الحالية مجموعة التطبيقات المحدثة.

حدود دعم V1

نطاق V1 ضيق عمدا:

• فقط Plugins من openai-curated التي كانت مثبتة بالفعل في مخزون خادم تطبيق Codex المصدر تكون مؤهلة للهجرة.
• يجب أن تجتاز Plugins المصدر المدعومة بالتطبيقات بوابة الاشتراك وقت الهجرة. يضيف --verify-plugin-apps بوابة مخزون تطبيقات المصدر. الحسابات المحكومة بالاشتراك، وفي وضع التحقق، التطبيقات المصدرية غير القابلة للوصول أو المعطلة أو المفقودة أو أعطال تحديث مخزون تطبيقات المصدر، تُبلغ كعناصر يدوية متخطاة بدلا من إدخالات إعداد ممكّنة. تُتخطى تفاصيل Plugin غير القابلة للقراءة قبل بوابة مخزون تطبيقات المصدر.
• تكتب الهجرة هويات Plugin صريحة مع marketplaceName و pluginName؛ ولا تكتب مسارات ذاكرة التخزين المؤقت المحلية marketplacePath.
• codexPlugins.enabled هو مفتاح التمكين العام.
• لا يوجد حرف بدل plugins["*"] ولا مفتاح إعداد يمنح صلاحية تثبيت عشوائية.
• تُحفظ marketplaces غير المدعومة، وحزم Plugins المخزنة مؤقتا، والخطافات، وملفات إعداد Codex في تقرير الهجرة للمراجعة اليدوية.

مخزون التطبيقات والملكية

يقرأ OpenClaw مخزون تطبيقات Codex عبر app/list في خادم التطبيق، ويخزنه مؤقتا لمدة ساعة واحدة، ويحدث الإدخالات القديمة أو المفقودة بشكل غير متزامن. ذاكرة التخزين المؤقت في الذاكرة فقط؛ تؤدي إعادة تشغيل CLI أو Gateway إلى إسقاطها، ويعيد OpenClaw بناءها من قراءة app/list التالية.

تستخدم الهجرة ووقت التشغيل مفاتيح ذاكرة تخزين مؤقت منفصلة:

• يستخدم تحقق هجرة المصدر موطن Codex المصدر وخيارات بدء خادم تطبيق المصدر. يعمل هذا فقط عند ضبط --verify-plugin-apps، ويفرض عبورا جديدا لـ app/list المصدر لتشغيل التخطيط ذلك.
• يستخدم إعداد وقت التشغيل الهدف هوية خادم تطبيق Codex لوكيل الهدف عندما يبني إعداد تطبيقات سلسلة Codex. يبطل تفعيل Plugin مفتاح ذاكرة التخزين المؤقت الهدف ثم يفرض تحديثه بعد plugin/install.

لا يُعرض تطبيق Plugin إلا عندما يستطيع OpenClaw ربطه مرة أخرى بـ Plugin المرحل عبر ملكية مستقرة:

• معرف التطبيق الدقيق من تفاصيل Plugin
• اسم خادم MCP معروف
• بيانات وصفية مستقرة فريدة

تُستبعد الملكية المعتمدة على اسم العرض فقط أو الغامضة حتى يثبت تحديث المخزون التالي الملكية.

إعداد تطبيقات السلسلة

يحقن OpenClaw تصحيح config.apps مقيدا لسلسلة Codex: يُعطل _default ولا تُمكّن إلا التطبيقات المملوكة لـ Plugins مرحلة وممكنة.

يضبط OpenClaw destructive_enabled على مستوى التطبيق من السياسة العامة الفعالة أو سياسة allow_destructive_actions الخاصة بكل Plugin، ويترك لـ Codex فرض بيانات تعريف الأدوات التدميرية من تعليقات أدوات التطبيقات الأصلية. تضبط true و "auto" و"ask" القيمة destructive_enabled: true؛ وتضبط false القيمة false. يُعطل إعداد التطبيق _default مع open_world_enabled: false. تُصدر تطبيقات Plugins الممكنة مع open_world_enabled: true؛ ولا يعرض OpenClaw زر سياسة open-world منفصلا لكل Plugin ولا يحتفظ بقوائم رفض أسماء أدوات تدميرية لكل Plugin.

وضع الموافقة على الأدوات تلقائي افتراضيا لتطبيقات Plugins بحيث يمكن لأدوات القراءة غير التدميرية العمل دون واجهة موافقة في السلسلة نفسها. تبقى الأدوات التدميرية محكومة بسياسة destructive_enabled لكل تطبيق.

سياسة الإجراءات التدميرية

تُسمح استدعاءات Plugins التدميرية افتراضيا لـ Plugins Codex المرحلة، بينما تبقى المخططات غير الآمنة والملكية الغامضة مغلقة فشليا:

• القيمة الافتراضية لـ allow_destructive_actions العامة هي true.
• تتجاوز allow_destructive_actions لكل Plugin السياسة العامة لذلك Plugin.
• عندما تكون السياسة false، يعيد OpenClaw رفضا حتميا.
• عندما تكون السياسة true، يقبل OpenClaw تلقائيا فقط المخططات الآمنة التي يستطيع ربطها باستجابة موافقة، مثل حقل موافقة منطقي.
• عندما تكون السياسة "auto"، يعرض OpenClaw إجراءات Plugins التدميرية لـ Codex لكنه يحول استدعاءات موافقة MCP المثبتة الملكية إلى موافقات Plugin في OpenClaw قبل إعادة استجابة موافقة Codex.
• عندما تكون السياسة "ask"، يستخدم OpenClaw بوابة الكتابة/التدمير نفسها في Codex كما في "auto"، ويمسح تجاوزات الموافقة الدائمة لكل أداة في Codex الخاصة بالتطبيق قبل بدء السلسلة، ولا يقدم إلا موافقة أو رفضا لمرة واحدة كي لا تتمكن الموافقات الدائمة من كتم مطالبات إجراءات الكتابة اللاحقة.
• لكل تطبيق مقبول يستخدم "ask"، يختار OpenClaw مراجع الموافقات البشرية في Codex لذلك التطبيق حتى يرسل Codex استدعاءات الموافقة إلى OpenClaw. تحتفظ التطبيقات الأخرى والموافقات غير التطبيقية في السلسلة بمراجعها وسياستها المضبوطين.
• تؤدي هوية Plugin المفقودة أو الملكية الغامضة أو معرف دورة مفقود أو معرف دورة خاطئ أو مخطط استدعاء غير آمن إلى الرفض بدلا من المطالبة.

استكشاف الأخطاء وإصلاحها

auth_required: ثبتت الهجرة Plugin، لكن أحد تطبيقاته لا يزال يحتاج إلى مصادقة. يُكتب إدخال Plugin الصريح معطلا حتى تعيد التفويض وتمكنه.

app_inaccessible أو app_disabled أو app_missing: لم تثبت الهجرة Plugin لأن مخزون تطبيقات Codex المصدر لم يعرض كل التطبيقات المملوكة كموجودة وممكنة وقابلة للوصول أثناء ضبط --verify-plugin-apps. أعد تفويض التطبيق أو تمكينه في Codex، ثم أعد تشغيل الهجرة مع --verify-plugin-apps.

app_inventory_unavailable: لم تثبت الهجرة Plugin لأن التحقق الصارم من تطبيقات المصدر طُلب وفشل تحديث مخزون تطبيقات Codex المصدر. أصلح وصول خادم تطبيق Codex المصدر أو أعد المحاولة دون --verify-plugin-apps إذا كنت تقبل الخطة الأسرع المحكومة بالحساب.

codex_subscription_required: لم تثبت الهجرة Plugin المدعوم بالتطبيقات لأن حساب خادم تطبيق Codex المصدر لم يكن مسجلا دخوله بحساب اشتراك ChatGPT. سجل الدخول إلى تطبيق Codex بمصادقة اشتراك، ثم أعد تشغيل الهجرة.

codex_account_unavailable: لم تثبت الهجرة Plugin المدعوم بالتطبيقات لأنه تعذرت قراءة حساب خادم تطبيق Codex المصدر. أصلح مصادقة خادم تطبيق Codex المصدر أو أعد التشغيل مع --verify-plugin-apps إذا كنت تريد أن يقرر مخزون تطبيقات المصدر الأهلية عند فشل بحث الحساب.

marketplace_missing أو plugin_missing: لا يستطيع خادم تطبيق Codex الهدف رؤية marketplace أو Plugin المتوقعين من openai-curated. أعد تشغيل الهجرة مقابل وقت التشغيل الهدف أو افحص حالة Plugin في خادم تطبيق Codex.

app_inventory_missing أو app_inventory_stale: جاءت جاهزية التطبيق من ذاكرة تخزين مؤقت فارغة أو قديمة. يجدول OpenClaw تحديثا غير متزامن ويستبعد تطبيقات Plugin حتى تُعرف الملكية والجاهزية.

app_ownership_ambiguous: لم يطابق مخزون التطبيقات إلا باسم العرض، لذلك لا يُعرض التطبيق لسلسلة Codex.

تغيّر التكوين لكن الوكيل لا يرى Plugin: استخدم /codex plugins list لتأكيد الحالة المكوّنة، ثم استخدم /new أو /reset. تحتفظ ارتباطات سلاسل Codex الحالية بتكوين التطبيق الذي بدأت به إلى أن ينشئ OpenClaw جلسة حزمة تشغيل جديدة أو يستبدل ارتباطًا قديمًا.

يتم رفض الإجراء التدميري: تحقّق من قيم allow_destructive_actions العامة والخاصة بكل Plugin. حتى عندما تكون السياسة مفعّلة، أو "auto"، أو "ask"، تظل مخططات الاستدعاء غير الآمنة وهوية Plugin الغامضة تفشل بإغلاق آمن.

ذو صلة

• حزمة تشغيل Codex
• مرجع حزمة تشغيل Codex
• وقت تشغيل حزمة تشغيل Codex
• مرجع التكوين
• ترحيل CLI