الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
المتطلبات

  • يجب أن يكون وقت تشغيل وكيل OpenClaw المحدد هو بيئة تشغيل Codex الأصلية.
  • يجب أن تكون plugins.entries.codex.enabled بقيمة true.
  • يجب أن تكون plugins.entries.codex.config.codexPlugins.enabled بقيمة true.
  • يدعم V1 فقط إضافات openai-curated التي رصدها الترحيل على أنها مثبتة من المصدر في منزل Codex المصدر.
  • يجب أن يكون خادم تطبيقات Codex الهدف قادرا على رؤية السوق والـ Plugin ومخزون التطبيقات المتوقع.
لا يؤثر codexPlugins في عمليات تشغيل PI، أو عمليات تشغيل مزود OpenAI العادية، أو ارتباطات محادثات ACP، أو بيئات التشغيل الأخرى لأن هذه المسارات لا تنشئ سلاسل خادم تطبيقات Codex بتكوين apps أصلي.

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

عاين الترحيل من منزل Codex المصدر: 
openclaw migrate codex --dry-run
طبّق الترحيل عندما تبدو الخطة صحيحة: 
openclaw migrate apply codex --yes
يكتب الترحيل إدخالات codexPlugins صريحة للإضافات المؤهلة ويستدعي plugin/install في خادم تطبيقات Codex للإضافات المحددة. يبدو التكوين المرحّل النموذجي كما يلي: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: false,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}
بعد تغيير codexPlugins، استخدم /new أو /reset أو أعد تشغيل Gateway حتى تبدأ جلسات بيئة تشغيل Codex المستقبلية بمجموعة التطبيقات المحدّثة.

​
كيف يعمل إعداد Plugin الأصلي

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

​
حدود دعم V1

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

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

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

​
تكوين تطبيقات السلسلة

يحقن OpenClaw رقعة config.apps مقيّدة لسلسلة Codex: يكون _default معطلا وتُفعّل فقط التطبيقات المملوكة لإضافات مرحّلة ومفعّلة. يضبط OpenClaw قيمة destructive_enabled على مستوى التطبيق من سياسة allow_destructive_actions العامة أو الخاصة بكل Plugin الفعالة، ويترك Codex يفرض بيانات تعريف الأدوات التدميرية من تعليقات أدوات التطبيق الأصلية لديه. يُعطّل تكوين تطبيق _default باستخدام open_world_enabled: false. تصدر تطبيقات Plugin المفعّلة مع open_world_enabled: true؛ لا يكشف OpenClaw مقبضا منفصلا لسياسة العالم المفتوح الخاصة بالـ Plugin ولا يحتفظ بقوائم رفض لأسماء الأدوات التدميرية لكل Plugin. يكون وضع موافقة الأدوات مطلوبا افتراضيا لتطبيقات Plugin لأن OpenClaw لا يملك واجهة تفاعل لاستدعاء التطبيق في مسار السلسلة نفسه هذا.

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

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

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

auth_required: ثبّت الترحيل Plugin، لكن أحد تطبيقاته ما زال يحتاج إلى المصادقة. يُكتب إدخال Plugin الصريح معطلا إلى أن تعيد التفويض وتفعّله. marketplace_missing أو plugin_missing: لا يستطيع خادم تطبيقات Codex الهدف رؤية سوق أو Plugin openai-curated المتوقع. أعد تشغيل الترحيل مقابل وقت التشغيل الهدف أو افحص حالة Plugin في خادم تطبيقات Codex. app_inventory_missing أو app_inventory_stale: جاءت جاهزية التطبيق من ذاكرة تخزين مؤقت فارغة أو قديمة. يحدّد OpenClaw موعد تحديث غير متزامن ويستبعد تطبيقات Plugin إلى أن تُعرف الملكية والجاهزية. app_ownership_ambiguous: لم يطابق مخزون التطبيقات إلا باسم العرض، لذلك لا يُكشف التطبيق لسلسلة Codex. تغيّر التكوين لكن الوكيل لا يستطيع رؤية Plugin: استخدم /new أو /reset أو أعد تشغيل Gateway. تحتفظ ارتباطات سلاسل Codex الحالية بتكوين التطبيقات الذي بدأت به إلى أن ينشئ OpenClaw جلسة بيئة تشغيل جديدة أو يستبدل ارتباطا قديما. تم رفض الإجراء التدميري: تحقق من قيم allow_destructive_actions العامة والخاصة بكل Plugin. حتى عندما تكون السياسة true، تظل مخططات الاستدعاء غير الآمنة وهوية Plugin الغامضة تفشل بشكل مغلق.

​
ذو صلة