---
read_when:
    - تريد أن يستخدم وكلاء OpenClaw في وضع Codex إضافات Codex الأصلية.
    - أنت تقوم بترحيل Plugins Codex المنسقة من openai والمثبتة من المصدر
    - أنت تعالج مشكلات codexPlugins أو جرد التطبيقات أو الإجراءات التدميرية أو تشخيصات تطبيقات Plugin
summary: تهيئة Plugins Codex الأصلية التي تم ترحيلها لوكلاء OpenClaw في وضع Codex
title: Plugins Codex الأصلية
x-i18n:
    generated_at: "2026-07-02T00:58:13Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 11a883137ba89936cf564a45b22c9e76097af669e2ef6c70c8c710bb2b79d3c0
    source_path: plugins/codex-native-plugins.md
    workflow: 16
---

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

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

استخدم هذه الصفحة بعد أن يكون [مشغل Codex](/ar/plugins/codex-harness) الأساسي عاملا.

## المتطلبات

- يجب أن يكون وقت تشغيل وكيل 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 الخاصة بك](https://help.openai.com/en/articles/11369540-using-codex-with-your-chatgpt-plan).

## البدء السريع

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

```bash
openclaw migrate codex --dry-run
```

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

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

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

```bash
openclaw migrate apply codex --yes
```

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

```json5
{
  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:

```text
/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](/ar/plugins/codex-harness)
- [مرجع حزمة تشغيل Codex](/ar/plugins/codex-harness-reference)
- [وقت تشغيل حزمة تشغيل Codex](/ar/plugins/codex-harness-runtime)
- [مرجع التكوين](/ar/gateway/configuration-reference#codex-harness-plugin-config)
- [ترحيل CLI](/ar/cli/migrate)