تسخير Codex

يتيح Plugin codex المضمّن لـ OpenClaw تشغيل دورات وكيل OpenAI مضمّنة عبر خادم تطبيق Codex بدلًا من إطار تشغيل OpenClaw المدمج.

استخدم إطار تشغيل Codex عندما تريد أن يتولى Codex جلسة الوكيل منخفضة المستوى: استئناف السلاسل الأصلي، ومتابعة الأدوات الأصلية، وCompaction الأصلي، وتنفيذ خادم التطبيق. لا يزال OpenClaw يتولى قنوات الدردشة، وملفات الجلسات، واختيار النموذج، وأدوات OpenClaw الديناميكية، والموافقات، وتسليم الوسائط، ومرآة النص الظاهر.

يستخدم الإعداد العادي مراجع نماذج OpenAI القياسية مثل openai/gpt-5.5. لا تضبط مراجع Codex GPT القديمة. ضع ترتيب مصادقة وكيل OpenAI تحت auth.order.openai؛ إن معرّفات ملفات تعريف مصادقة Codex القديمة الأقدم ومدخلات ترتيب مصادقة Codex القديمة هي حالة قديمة يصلحها openclaw doctor --fix.

عندما لا يكون أي صندوق عزل لـ OpenClaw نشطًا، يبدأ OpenClaw سلاسل خادم تطبيق Codex مع تمكين وضع الكود الأصلي في Codex مع إبقاء وضع الكود فقط معطلًا افتراضيًا. يبقي ذلك مساحة عمل Codex الأصلية وقدرات الكود متاحة بينما تستمر أدوات OpenClaw الديناميكية عبر جسر خادم التطبيق item/tool/call. تعطل سياسات العزل النشط لـ OpenClaw والأدوات المقيدة وضع الكود الأصلي بالكامل ما لم تشترك في مسار exec-server التجريبي لصندوق العزل.

هذه الميزة الأصلية لـ Codex منفصلة عن وضع الكود في OpenClaw، وهو وقت تشغيل QuickJS-WASI اختياري لتشغيلات OpenClaw العامة مع شكل إدخال exec مختلف.

لفهم التقسيم الأوسع بين النموذج/الموفر/وقت التشغيل، ابدأ بـ أوقات تشغيل الوكلاء. النسخة المختصرة هي: openai/gpt-5.5 هو مرجع النموذج، وcodex هو وقت التشغيل، وتبقى Telegram أو Discord أو Slack أو قناة أخرى سطح الاتصال.

المتطلبات

• OpenClaw مع توفر Plugin codex المضمّن.
• إذا كان إعدادك يستخدم plugins.allow، فأدرج codex.
• خادم تطبيق Codex 0.125.0 أو أحدث. يدير Plugin المضمّن ملفًا ثنائيًا متوافقًا لخادم تطبيق Codex افتراضيًا، لذلك لا تؤثر أوامر codex المحلية على PATH في بدء إطار التشغيل العادي.
• توفر مصادقة Codex عبر openclaw models auth login --provider openai، أو حساب خادم تطبيق في منزل Codex الخاص بالوكيل، أو ملف تعريف مصادقة صريح بمفتاح API لـ Codex.

لأسبقية المصادقة، وعزل البيئة، وأوامر خادم التطبيق المخصصة، واكتشاف النماذج، وجميع حقول الإعداد، راجع مرجع إطار تشغيل Codex.

البدء السريع

يريد معظم المستخدمين الذين يريدون Codex في OpenClaw هذا المسار: تسجيل الدخول باشتراك ChatGPT/Codex، وتمكين Plugin codex المضمّن، واستخدام مرجع نموذج قياسي openai/gpt-*.

سجّل الدخول باستخدام Codex OAuth:

openclaw models auth login --provider openai

فعّل Plugin codex المضمّن واختر نموذج وكيل OpenAI:

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.5",    },  },}

إذا كان إعدادك يستخدم plugins.allow، فأضف codex هناك أيضًا:

{  plugins: {    allow: ["codex"],    entries: {      codex: {        enabled: true,      },    },  },}

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

مشاركة السلاسل مع Codex Desktop وCLI

يحافظ الإعداد الافتراضي appServer.homeScope: "agent" على عزل كل وكيل OpenClaw عن حالة Codex الأصلية للمشغل. للسماح للمالك بأن يطلب من OpenClaw فحص وإدارة السلاسل الأصلية نفسها المعروضة بواسطة Codex Desktop وCodex CLI، اشترك في منزل Codex الخاص بالمستخدم:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            homeScope: "user",          },        },      },    },  },}

وضع منزل المستخدم متاح فقط مع نقل stdio المحلي. يستخدم $CODEX_HOME عند ضبطه و~/.codex بخلاف ذلك، بما في ذلك مصادقة Codex الأصلية لذلك المنزل، وإعداداته، وplugins، ومخزن السلاسل. لا يحقن OpenClaw ملف تعريف مصادقة OpenClaw في خادم التطبيق هذا.

تحصل أدوار المالك على أداة codex_threads. يمكنها سرد السلاسل الأصلية والبحث فيها وقراءتها وتفريعها وإعادة تسميتها وأرشفتها واستعادتها. اطلب من الوكيل تفريع سلسلة عندما تريد متابعتها في OpenClaw؛ يُرفق التفريع بجلسة OpenClaw الحالية ويبقى مرئيًا لعملاء Codex الأصليين الآخرين. تتطلب الأرشفة تأكيدًا صريحًا بأن السلسلة مغلقة في مكان آخر.

لا تستأنف السلسلة نفسها أو تكتب إليها بشكل متزامن من OpenClaw وعميل Codex آخر. ينسق Codex الكتّاب المباشرين داخل عملية خادم تطبيق واحدة، وليس عبر عمليات مستقلة لـ Desktop وCLI وOpenClaw. ينشئ التفريع متابعة منفصلة وهو مسار التعايش الآمن.

الإعداد

إعداد البدء السريع هو الحد الأدنى العملي لإعداد إطار تشغيل Codex. اضبط خيارات إطار تشغيل Codex في إعداد OpenClaw، واستخدم CLI فقط لمصادقة Codex:

استخدم مراجع نماذج openai/gpt-* لأدوار وكلاء OpenAI المدعومة بـ Codex. فضّل auth.order.openai لترتيب الاشتراك أولًا/مفتاح API احتياطيًا. إن معرّفات ملفات تعريف مصادقة Codex القديمة الموجودة وترتيب مصادقة Codex القديم هما حالة قديمة خاصة بالطبيب فقط؛ لا تكتب مراجع Codex GPT قديمة جديدة.

لا تضبط compaction.model أو compaction.provider على الوكلاء المدعومين بـ Codex. ينفذ Codex عملية Compaction عبر حالة سلسلة خادم التطبيق الأصلية الخاصة به، لذلك يتجاهل OpenClaw تجاوزات الملخّص المحلي هذه في وقت التشغيل ويزيلها openclaw doctor --fix عندما يستخدم الوكيل Codex.

يبقى Lossless مدعومًا كمحرك سياق للتجميع، والاستيعاب، والصيانة حول أدوار Codex. اضبطه عبر plugins.slots.contextEngine: "lossless-claw" و plugins.entries.lossless-claw.config.summaryModel، وليس عبر agents.defaults.compaction.provider. يهاجر openclaw doctor --fix الشكل القديم compaction.provider: "lossless-claw" إلى خانة محرك سياق Lossless عندما يكون Codex هو وقت التشغيل النشط، لكن Codex الأصلي لا يزال يتولى Compaction.

يدعم إطار تشغيل خادم تطبيق Codex الأصلي محركات السياق التي تتطلب تجميع ما قبل الموجه. لا توفر خلفيات CLI العامة، بما في ذلك codex-cli، قدرة المضيف تلك.

بالنسبة للوكلاء المدعومين بـ Codex، يبدأ /compact عملية Compaction الأصلية لخادم تطبيق Codex على السلسلة المرتبطة. لا ينتظر OpenClaw الاكتمال، ولا يفرض مهلة OpenClaw، ولا يعيد تشغيل خادم التطبيق المشترك، ولا يعود إلى محرك سياق أو ملخّص OpenAI عام. إذا كان ربط سلسلة Codex الأصلية مفقودًا أو قديمًا، يفشل الأمر بشكل مغلق لكي يرى المشغل حد وقت التشغيل الحقيقي بدلًا من تبديل خلفيات Compaction بصمت.

{  auth: {    order: {      openai: ["openai:user@example.com", "openai:api-key-backup"],    },  },}

في هذا الشكل، لا يزال كلا الملفين الشخصيين يعملان عبر Codex لأدوار وكلاء openai/gpt-*. مفتاح API هو احتياطي مصادقة فقط، وليس طلبًا للتبديل إلى OpenClaw أو OpenAI Responses العادية.

يغطي بقية هذه الصفحة المتغيرات الشائعة التي يجب على المستخدمين الاختيار بينها: شكل النشر، والتوجيه بالفشل المغلق، وسياسة موافقة الحارس، وplugins Codex الأصلية، واستخدام الكمبيوتر. لقوائم الخيارات الكاملة، والقيم الافتراضية، والتعدادات، والاكتشاف، وعزل البيئة، والمهلات، وحقول نقل خادم التطبيق، راجع مرجع إطار تشغيل Codex.

التحقق من وقت تشغيل Codex

استخدم /status في الدردشة التي تتوقع فيها Codex. يعرض دور وكيل OpenAI المدعوم بـ Codex:

Runtime: OpenAI Codex

ثم تحقق من حالة خادم تطبيق Codex:

/codex status/codex models

يبلغ /codex status عن اتصال خادم التطبيق، والحساب، وحدود المعدل، وخوادم MCP، وSkills. يسرد /codex models كتالوج خادم تطبيق Codex المباشر لإطار التشغيل والحساب. إذا كان /status مفاجئًا، فراجع استكشاف الأخطاء وإصلاحها.

التوجيه واختيار النموذج

أبقِ مراجع الموفر وسياسة وقت التشغيل منفصلتين:

• استخدم openai/gpt-* لأدوار وكلاء OpenAI عبر Codex.
• لا تستخدم مراجع Codex GPT القديمة في الإعداد. شغّل openclaw doctor --fix لإصلاح المراجع القديمة ودبابيس مسارات الجلسات القديمة.
• agentRuntime.id: "codex" اختياري لوضع OpenAI التلقائي العادي، لكنه مفيد عندما يجب أن يفشل النشر بشكل مغلق إذا لم يكن Codex متاحًا.
• agentRuntime.id: "openclaw" يجعل موفرًا أو نموذجًا يستخدم وقت تشغيل OpenClaw المضمّن عندما يكون ذلك مقصودًا.
• يتحكم /codex ... في محادثات خادم تطبيق Codex الأصلية من الدردشة.
• ACP/acpx هو مسار إطار تشغيل خارجي منفصل. استخدمه فقط عندما يطلب المستخدم ACP/acpx أو محول إطار تشغيل خارجي.

توجيه الأوامر الشائعة:

يتبع agents.defaults.imageModel تقسيم البادئات نفسه. استخدم openai/gpt-* للمسار العادي عبر OpenAI، واستخدم codex/gpt-* فقط عندما يجب أن يعمل فهم الصور من خلال دورة محدودة في خادم تطبيق Codex. لا تستخدم مراجع Codex GPT القديمة؛ يعيد doctor كتابة تلك البادئة القديمة إلى openai/gpt-*.

أنماط النشر

نشر Codex أساسي

استخدم تهيئة البدء السريع عندما يجب أن تستخدم كل دورات وكيل OpenAI Codex افتراضيا.

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.5",    },  },}

نشر بموفري خدمات مختلطين

يحافظ هذا الشكل على Claude بصفته الوكيل الافتراضي ويضيف وكيلا مسمى لـ Codex:

{  plugins: {    entries: {      codex: {        enabled: true,      },    },  },  agents: {    defaults: {      model: "anthropic/claude-opus-4-6",    },    list: [      {        id: "main",        default: true,        model: "anthropic/claude-opus-4-6",      },      {        id: "codex",        name: "Codex",        model: "openai/gpt-5.5",      },    ],  },}

مع هذه التهيئة، يستخدم الوكيل main مسار موفر الخدمة العادي، ويستخدم الوكيل codex خادم تطبيق Codex.

نشر Codex بإخفاق مغلق

بالنسبة إلى دورات وكيل OpenAI، يتحول openai/gpt-* بالفعل إلى Codex عندما تكون Plugin المجمعة متاحة. أضف سياسة وقت تشغيل صريحة عندما تريد قاعدة مكتوبة للإخفاق المغلق:

{  models: {    providers: {      openai: {        agentRuntime: {          id: "codex",        },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.5",    },  },  plugins: {    entries: {      codex: {        enabled: true,      },    },  },}

عند فرض Codex، يفشل OpenClaw مبكرا إذا كانت Plugin Codex معطلة، أو كان خادم التطبيق قديما جدا، أو تعذر بدء خادم التطبيق.

سياسة خادم التطبيق

افتراضيا، تبدأ Plugin ملف Codex الثنائي المدار من OpenClaw محليا باستخدام نقل stdio. عيّن appServer.command فقط عندما تريد عمدا تشغيل ملف تنفيذي مختلف. استخدم نقل WebSocket فقط عندما يكون خادم التطبيق قيد التشغيل بالفعل في مكان آخر:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            transport: "websocket",            url: "ws://gateway-host:39175",            authToken: "${CODEX_APP_SERVER_TOKEN}",          },        },      },    },  },}

تعتمد جلسات خادم التطبيق المحلية عبر stdio افتراضيا وضع المشغل المحلي الموثوق: approvalPolicy: "never"، وapprovalsReviewer: "user"، و sandbox: "danger-full-access". إذا كانت متطلبات Codex المحلية لا تسمح بوضع YOLO الضمني هذا، يختار OpenClaw أذونات الحراسة المسموح بها بدلا من ذلك. عندما يكون صندوق حماية OpenClaw نشطا للجلسة، يعطل OpenClaw وضع Code Mode الأصلي في Codex، وخوادم MCP الخاصة بالمستخدم، وتنفيذ Plugins المدعوم بالتطبيق لتلك الدورة بدلا من الاعتماد على صندوق الحماية من جهة مضيف Codex. يتاح وصول الصدفة من خلال أدوات OpenClaw الديناميكية المدعومة بصندوق الحماية مثل sandbox_exec و sandbox_process عندما تكون أدوات exec/process العادية متاحة.

استخدم وضع exec الموحد في OpenClaw عندما تريد المراجعة التلقائية الأصلية من Codex قبل الخروج من صندوق الحماية أو منح أذونات إضافية:

{  tools: {    exec: {      mode: "auto",    },  },  plugins: {    entries: {      codex: {        enabled: true,      },    },  },}

بالنسبة إلى جلسات خادم تطبيق Codex، يربط OpenClaw tools.exec.mode: "auto" بموافقات Codex التي يراجعها Guardian، وعادة approvalPolicy: "on-request"، وapprovalsReviewer: "auto_review"، و sandbox: "workspace-write" عندما تسمح المتطلبات المحلية بهذه القيم. في tools.exec.mode: "auto"، لا يحتفظ OpenClaw بتجاوزات Codex القديمة غير الآمنة approvalPolicy: "never" أو sandbox: "danger-full-access"؛ استخدم tools.exec.mode: "full" لوضع Codex مقصود بلا موافقات. لا يزال الإعداد المسبق القديم plugins.entries.codex.config.appServer.mode: "guardian" يعمل، لكن tools.exec.mode: "auto" هو سطح OpenClaw الموحد.

للمقارنة على مستوى الأوضاع مع موافقات exec على المضيف وأذونات ACPX، راجع أوضاع الأذونات.

لكل حقل من حقول خادم التطبيق، وترتيب المصادقة، وعزل البيئة، والاكتشاف، وسلوك المهلة، راجع مرجع حزمة Codex.

الأوامر والتشخيصات

تسجل Plugin المجمعة /codex كأمر شرطة مائلة في أي قناة تدعم أوامر OpenClaw النصية.

يتطلب التنفيذ والتحكم الأصليان مالكا أو عميل Gateway لديه operator.admin. يشمل ذلك ربط السلاسل أو استئنافها، وإرسال الدورات أو إيقافها، وتغيير النموذج أو الوضع السريع أو حالة الأذونات، وإجراء الضغط أو المراجعة، و فصل الارتباط. يحتفظ المرسلون المخولون الآخرون بأوامر الحالة والشرح والحساب والنموذج والسلسلة وخادم MCP وSkills وفحص الارتباط للقراءة فقط.

الصيغ الشائعة:

• يتحقق /codex status من اتصال خادم التطبيق، والنماذج، والحساب، وحدود المعدل، وخوادم MCP، وSkills.
• يعرض /codex models نماذج خادم تطبيق Codex الحية.
• يعرض /codex threads [filter] سلاسل خادم تطبيق Codex الأخيرة.
• يرفق /codex resume <thread-id> جلسة OpenClaw الحالية بسلسلة Codex موجودة.
• يطلب /codex compact من خادم تطبيق Codex ضغط السلسلة المرفقة.
• يبدأ /codex review مراجعة Codex الأصلية للسلسلة المرفقة.
• يطلب /codex diagnostics [note] الإذن قبل إرسال ملاحظات Codex عن السلسلة المرفقة.
• يعرض /codex account حالة الحساب وحدود المعدل.
• يعرض /codex mcp حالة خادم MCP في خادم تطبيق Codex.
• يعرض /codex skills Skills خادم تطبيق Codex.

بالنسبة إلى معظم تقارير الدعم، ابدأ بـ /diagnostics [note] في المحادثة التي حدث فيها الخطأ. ينشئ ذلك تقرير تشخيص Gateway واحدا، وبالنسبة إلى جلسات حزمة Codex، يطلب الموافقة لإرسال حزمة ملاحظات Codex ذات الصلة. راجع تصدير التشخيصات لمعرفة نموذج الخصوصية وسلوك الدردشات الجماعية.

استخدم /codex diagnostics [note] فقط عندما تريد تحديدا رفع ملاحظات Codex للسلسلة المرفقة حاليا من دون حزمة تشخيصات Gateway الكاملة.

فحص سلاسل Codex محليا

غالبا ما تكون أسرع طريقة لفحص تشغيل Codex سيئ هي فتح سلسلة Codex الأصلية مباشرة:

codex resume <thread-id>

احصل على معرف السلسلة من رد /diagnostics المكتمل، أو /codex binding، أو /codex threads [filter].

لمعرفة آليات الرفع وحدود التشخيصات على مستوى وقت التشغيل، راجع وقت تشغيل حزمة Codex.

في المنزل الافتراضي لكل وكيل، يتم اختيار المصادقة بهذا الترتيب:

1. ملفات تعريف مصادقة OpenAI المرتبة للوكيل، ويفضل أن تكون ضمن auth.order.openai. شغّل openclaw doctor --fix لترحيل معرفات ملفات تعريف مصادقة Codex القديمة وترتيب مصادقة Codex القديم.
2. حساب خادم التطبيق الموجود في منزل Codex لذلك الوكيل.
3. بالنسبة إلى عمليات تشغيل خادم التطبيق المحلية عبر stdio فقط، CODEX_API_KEY، ثم OPENAI_API_KEY، عندما لا يكون هناك حساب خادم تطبيق موجود وتظل مصادقة OpenAI مطلوبة.

عندما يرى OpenClaw ملف تعريف مصادقة Codex بنمط اشتراك ChatGPT، يزيل CODEX_API_KEY وOPENAI_API_KEY من عملية Codex الفرعية التي تم إنشاؤها. يحافظ ذلك على إتاحة مفاتيح API على مستوى Gateway للتضمينات أو نماذج OpenAI المباشرة من دون أن تتسبب دورات خادم تطبيق Codex الأصلية في الفوترة عبر API بالخطأ. تستخدم ملفات تعريف مفاتيح API الصريحة لـ Codex واحتياط مفاتيح البيئة المحلية عبر stdio تسجيل دخول خادم التطبيق بدلا من بيئة العملية الفرعية الموروثة. لا تتلقى اتصالات خادم تطبيق WebSocket احتياط مفتاح API من بيئة Gateway؛ استخدم ملف تعريف مصادقة صريحا أو حساب خادم التطبيق البعيد نفسه. عند تهيئة Plugins Codex الأصلية، يثبت OpenClaw تلك Plugins أو يحدّثها عبر خادم التطبيق المتصل قبل إتاحة التطبيقات المملوكة من Plugin لسلسلة Codex. يظل app/list مصدر الحقيقة لمعرفات التطبيقات، وإمكانية الوصول، والبيانات الوصفية، لكن OpenClaw يملك قرار التمكين لكل سلسلة: إذا سمحت السياسة بتطبيق مدرج يمكن الوصول إليه، يرسل OpenClaw thread/start.config.apps[appId].enabled = true حتى عندما يبلّغ app/list حاليا أن ذلك التطبيق معطل. لا يخترع هذا المسار تثبيت تطبيقات لمعرفات غير معروفة؛ لا يفعّل OpenClaw إلا Plugins السوق عبر plugin/install ثم يحدّث المخزون.

إذا وصل ملف تعريف اشتراك إلى حد استخدام Codex، يسجل OpenClaw وقت إعادة التعيين عندما يبلّغ Codex عنه ويحاول ملف تعريف المصادقة المرتب التالي للتشغيل نفسه في Codex. عندما يمر وقت إعادة التعيين، يصبح ملف تعريف الاشتراك مؤهلا مرة أخرى من دون تغيير نموذج openai/gpt-* المحدد أو وقت تشغيل Codex.

بالنسبة إلى عمليات تشغيل خادم التطبيق المحلي عبر stdio، يعيّن OpenClaw قيمة CODEX_HOME إلى دليل خاص بكل وكيل حتى لا تقرأ أو تكتب ملفات إعداد Codex، وملفات المصادقة/الحساب، وذاكرة التخزين المؤقت/البيانات الخاصة بالـ Plugin، وحالة السلاسل الأصلية في ~/.codex الشخصي للمشغّل افتراضياً. يحافظ OpenClaw على قيمة HOME العادية للعملية؛ ولا تزال العمليات الفرعية التي يشغّلها Codex قادرة على العثور على إعدادات ورموز مستخدم المنزل، وقد يكتشف Codex إدخالات $HOME/.agents/skills و$HOME/.agents/plugins/marketplace.json المشتركة. مع appServer.homeScope: "user"، يستخدم OpenClaw بدلاً من ذلك منزل Codex الأصلي للمستخدم وحسابه الحالي من دون حقن ملف مصادقة OpenClaw.

إذا كان النشر يحتاج إلى عزل إضافي للبيئة، فأضف تلك المتغيرات إلى appServer.clearEnv:

{  plugins: {    entries: {      codex: {        enabled: true,        config: {          appServer: {            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],          },        },      },    },  },}

يؤثر appServer.clearEnv فقط في عملية خادم تطبيق Codex الفرعية التي يتم إنشاؤها. يزيل OpenClaw كلاً من CODEX_HOME وHOME من هذه القائمة أثناء تطبيع التشغيل المحلي: يبقى CODEX_HOME موجهاً إلى نطاق الوكيل أو المستخدم المحدد، وتبقى HOME موروثة حتى تتمكن العمليات الفرعية من استخدام حالة مستخدم المنزل العادية.

تستخدم أدوات Codex الديناميكية تحميل searchable افتراضياً. لا يكشف OpenClaw الأدوات الديناميكية التي تكرر عمليات مساحة العمل الأصلية في Codex: read وwrite وedit وapply_patch وexec وprocess وupdate_plan. تكون معظم أدوات تكامل OpenClaw المتبقية، مثل المراسلة، والوسائط، وcron، والمتصفح، والعُقد، وGateway، وheartbeat_respond، متاحة عبر بحث أدوات Codex ضمن مساحة الأسماء openclaw، مما يبقي سياق النموذج الأولي أصغر. يستخدم بحث الويب أداة Codex المستضافة web_search افتراضياً عندما يكون البحث مفعّلاً ولا يكون هناك مزود مُدار محدد. البحث المستضاف الأصلي وأداة OpenClaw الديناميكية المُدارة web_search متنافيان بحيث لا يمكن للبحث المُدار تجاوز قيود النطاقات الأصلية. يستخدم OpenClaw الأداة المُدارة عندما يكون البحث المستضاف غير متاح، أو معطلاً صراحةً، أو مستبدلاً بمزود مُدار محدد. يبقي OpenClaw امتداد Codex المستقل web.run معطلاً لأن حركة مرور خادم التطبيق الإنتاجية ترفض مساحة الأسماء web المعرّفة من المستخدم. يعطّل tools.web.search.enabled: false كلا المسارين، كما تفعل عمليات التشغيل المخصصة لـ LLM فقط التي تكون الأدوات فيها معطلة. يتعامل Codex مع "cached" على أنها تفضيل ويحوّلها إلى وصول خارجي مباشر لعمليات خادم التطبيق غير المقيّدة. يفشل الرجوع التلقائي المُدار بوضع مغلق عند تعيين allowedDomains الأصلية بحيث لا يمكن تجاوز قائمة السماح. تؤدي تغييرات سياسة البحث الفعلية الدائمة إلى تدوير سلسلة Codex المرتبطة قبل الدور التالي. تستخدم القيود العابرة لكل دور سلسلة مؤقتة مقيّدة وتحافظ على الربط الحالي للاستئناف لاحقاً. تبقى ردود المصدر الخاصة بـ sessions_yield وأداة الرسائل فقط مباشرة لأن هذه عقود تحكم في الدور. يبقى sessions_spawn قابلاً للبحث بحيث يظل spawn_agent الأصلي في Codex هو سطح الوكلاء الفرعيين الأساسي في Codex، بينما يظل تفويض OpenClaw أو ACP الصريح متاحاً عبر مساحة أسماء أدوات openclaw الديناميكية. تطلب تعليمات التعاون عبر Heartbeat من Codex البحث عن heartbeat_respond قبل إنهاء دور Heartbeat عندما لا تكون الأداة محمّلة بالفعل.

عيّن codexDynamicToolsLoading: "direct" فقط عند الاتصال بخادم تطبيق Codex مخصص لا يستطيع البحث في الأدوات الديناميكية المؤجلة أو عند تصحيح حمولة الأدوات الكاملة.

حقول Plugin الخاصة بـ Codex المدعومة على المستوى الأعلى:

حقول appServer المدعومة:

appServer.networkProxy صريح لأنه يغيّر عقد صندوق رمل Codex. عند تفعيله، يضبط OpenClaw أيضاً features.network_proxy.enabled و default_permissions في إعداد سلسلة Codex بحيث يستطيع ملف تعريف الأذونات المُولّد بدء شبكة Codex المُدارة. افتراضياً، يولّد OpenClaw اسم ملف تعريف openclaw-network-<fingerprint> مقاوماً للتصادم من متن ملف التعريف؛ استخدم profileName فقط عندما يكون اسم محلي ثابت مطلوباً.

export default {  plugins: {    entries: {      codex: {        config: {          appServer: {            sandbox: "workspace-write",            networkProxy: {              enabled: true,              domains: {                "api.openai.com": "allow",                "blocked.example.com": "deny",              },              unixSockets: {                "/tmp/proxy.sock": "allow",                "/tmp/blocked.sock": "none",              },              allowUpstreamProxy: true,              proxyUrl: "http://127.0.0.1:3128",            },          },        },      },    },  },};

إذا كان تشغيل خادم التطبيق العادي سيكون danger-full-access، فإن تفعيل networkProxy يستخدم وصول نظام ملفات بأسلوب مساحة العمل لملف تعريف الأذونات المُنشأ. إن فرض الشبكة المُدار بواسطة Codex هو شبكة معزولة، لذلك لن يحمي ملف تعريف الوصول الكامل حركة المرور الصادرة. تستخدم إدخالات النطاق allow أو deny؛ وتستخدم إدخالات مقبس Unix قيم Codex وهي allow أو none.

تكون استدعاءات الأدوات الديناميكية المملوكة لـ OpenClaw محدودة بشكل مستقل عن appServer.requestTimeoutMs: تستخدم طلبات Codex ‏item/tool/call مراقب OpenClaw افتراضيًا لمدة 90 ثانية. يمدد أو يقصر وسيط timeoutMs الموجب لكل استدعاء ميزانية تلك الأداة المحددة. تستخدم أداة image_generate agents.defaults.imageGenerationModel.timeoutMs عندما لا يوفر استدعاء الأداة مهلة خاصة به، أو تستخدم افتراضي إنشاء الصور البالغ 120 ثانية بخلاف ذلك. تستخدم أداة فهم الوسائط image tools.media.image.timeoutSeconds أو افتراضي الوسائط البالغ 60 ثانية. بالنسبة لفهم الصور، تنطبق تلك المهلة على الطلب نفسه ولا يتم تقليلها بسبب أعمال التحضير السابقة. تُحد ميزانيات الأدوات الديناميكية عند 600000 ms. عند انتهاء المهلة، يلغي OpenClaw إشارة الأداة حيثما كان ذلك مدعومًا ويعيد استجابة أداة ديناميكية فاشلة إلى Codex كي تتمكن الدورة من المتابعة بدلًا من ترك الجلسة في processing. هذا المراقب هو ميزانية item/tool/call الديناميكية الخارجية؛ وتعمل مهل طلبات الموفرين المحددة داخل ذلك الاستدعاء وتحافظ على دلالات المهلة الخاصة بها.

بعد أن يقبل Codex دورة، وبعد أن يستجيب OpenClaw لطلب خادم تطبيق محدود بالدورة، يتوقع الحزام أن يحرز Codex تقدمًا في الدورة الحالية وأن ينهي في النهاية الدورة الأصلية باستخدام turn/completed. إذا بقي خادم التطبيق صامتًا لمدة appServer.turnCompletionIdleTimeoutMs، يحاول OpenClaw بأفضل جهد مقاطعة دورة Codex، ويسجل مهلة تشخيصية، ويحرر مسار جلسة OpenClaw بحيث لا تُصف رسائل الدردشة اللاحقة خلف دورة أصلية عالقة. تلغي معظم الإشعارات غير النهائية للدورة نفسها ذلك المراقب القصير لأن Codex أثبت أن الدورة لا تزال نشطة. تستخدم عمليات تسليم الأدوات ميزانية خمول أطول بعد الأداة: بعد أن يعيد OpenClaw استجابة item/tool/call، وبعد اكتمال عناصر الأدوات الأصلية مثل commandExecution، وبعد اكتمالات custom_tool_call_output الخام، وبعد تقدم المساعد الخام بعد الأداة، أو اكتمالات الاستدلال الخام، أو تقدم الاستدلال. يستخدم الحارس appServer.postToolRawAssistantCompletionIdleTimeoutMs عند ضبطه ويستخدم افتراضيًا خمس دقائق بخلاف ذلك. وتمدد ميزانية ما بعد الأداة نفسها أيضًا مراقب التقدم لنافذة التركيب الصامتة قبل أن يصدر Codex حدث الدورة الحالية التالي. لا تعيد إشعارات خادم التطبيق العامة، مثل تحديثات حد المعدل، ضبط تقدم خمول الدورة. يمكن أن تتبع اكتمالات الاستدلال، واكتمالات agentMessage في قناة commentary، وتقدم الاستدلال الخام أو المساعد قبل الأداة استجابة نهائية تلقائية، لذلك تستخدم حارس الرد بعد التقدم بدلًا من تحرير مسار الجلسة فورًا. فقط عناصر agentMessage النهائية/غير التابعة لقناة commentary المكتملة واكتمالات المساعد الخام قبل الأداة تفعّل تحرير إخراج المساعد: إذا أصبح Codex صامتًا بعد ذلك بدون turn/completed، يحاول OpenClaw بأفضل جهد مقاطعة الدورة الأصلية وتحرير مسار الجلسة. إذا فاز مراقب دورة آخر بسباق التحرير ذلك، لا يزال OpenClaw يقبل عنصر المساعد النهائي المكتمل بمجرد ألا يبقى أي طلب أصلي أو عنصر أو اكتمال أداة ديناميكية نشطًا، وأن يظل تحرير إخراج المساعد تابعًا لآخر عنصر مكتمل، بدون أي اكتمال عنصر لاحق. يمكن أن يحافظ هذا على الإجابة النهائية بعد اكتمال عمل الأدوات بدون إعادة تشغيل الدورة. لا تؤهل دلتا المساعد الجزئية، والردود السابقة القديمة، والاكتمالات اللاحقة الفارغة. تُعاد محاولة إخفاقات خادم تطبيق stdio الآمنة لإعادة التشغيل، بما في ذلك مهل خمول اكتمال الدورة بدون دليل مساعد أو أداة أو عنصر نشط أو أثر جانبي، مرة واحدة في محاولة خادم تطبيق جديدة. لا تزال المهل غير الآمنة تُنهي عميل خادم التطبيق العالق وتحرر مسار جلسة OpenClaw. كما أنها تمسح ربط مؤشر الترابط الأصلي القديم بدلًا من إعادة تشغيله تلقائيًا. تعرض مهل مراقبة الاكتمال نص مهلة خاصًا بـ Codex: تقول الحالات الآمنة لإعادة التشغيل إن الاستجابة قد تكون غير مكتملة، بينما تطلب الحالات غير الآمنة من المستخدم التحقق من الحالة الحالية قبل إعادة المحاولة. تتضمن تشخيصات المهلة العامة حقولًا بنيوية مثل آخر طريقة إشعار لخادم التطبيق، ومعرّف/نوع/دور عنصر استجابة المساعد الخام، وأعداد الطلبات/العناصر النشطة، وحالة المراقبة المفعلة. عندما يكون آخر إشعار عنصر استجابة مساعد خام، فإنها تتضمن أيضًا معاينة محدودة لنص المساعد. ولا تتضمن محتوى المطالبة أو الأداة الخام.

تظل تجاوزات البيئة متاحة للاختبار المحلي:

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

يتجاوز OPENCLAW_CODEX_APP_SERVER_BIN الملف الثنائي المُدار عندما يكون appServer.command غير مضبوط.

تمت إزالة OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1. استخدم plugins.entries.codex.config.appServer.mode: "guardian" بدلًا من ذلك، أو OPENCLAW_CODEX_APP_SERVER_MODE=guardian للاختبار المحلي لمرة واحدة. يُفضل استخدام الإعدادات للنشرات القابلة للتكرار لأنها تبقي سلوك Plugin في الملف المراجع نفسه كبقية إعداد حزام Codex.

Plugins الأصلية لـ Codex

يستخدم دعم Plugins الأصلية لـ Codex قدرات التطبيق وPlugin الخاصة بخادم تطبيق Codex في مؤشر ترابط Codex نفسه مثل دورة حزام OpenClaw. لا يترجم OpenClaw Plugins الخاصة بـ Codex إلى أدوات ديناميكية اصطناعية من OpenClaw باسم codex_plugin_*.

يؤثر codexPlugins فقط في الجلسات التي تختار حزام Codex الأصلي. لا أثر له في تشغيلات الحزام المدمج، أو تشغيلات موفر OpenAI العادية، أو روابط محادثات ACP، أو الأحزمة الأخرى.

إعدادات مرحّلة بالحد الأدنى:

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

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

لأهلية الترحيل، ومخزون التطبيقات، وسياسة الإجراءات التدميرية، والاستدعاءات، وتشخيصات Plugin الأصلية، راجع Plugins الأصلية لـ Codex.

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

استخدام الحاسوب

تمت تغطية استخدام الحاسوب في دليل إعداد مستقل: استخدام الحاسوب في Codex.

النسخة المختصرة: لا يضمّن OpenClaw تطبيق التحكم بسطح المكتب ولا ينفذ إجراءات سطح المكتب بنفسه. إنه يجهز خادم تطبيق Codex، ويتحقق من توفر خادم MCP computer-use، ثم يترك Codex يمتلك استدعاءات أدوات MCP الأصلية أثناء دورات وضع Codex.

حدود التشغيل

يغير حزام Codex منفذ الوكيل المضمن منخفض المستوى فقط.

• أدوات OpenClaw الديناميكية مدعومة. يطلب Codex من OpenClaw تنفيذ تلك الأدوات، لذلك يبقى OpenClaw في مسار التنفيذ.
• أدوات الصدفة، والتصحيح، وMCP، والتطبيقات الأصلية الخاصة بـ Codex مملوكة لـ Codex. يمكن لـ OpenClaw مراقبة أحداث أصلية محددة أو حظرها عبر الترحيل المدعوم، لكنه لا يعيد كتابة وسائط الأدوات الأصلية.
• يمتلك Codex Compaction الأصلي. يحتفظ OpenClaw بنسخة مرآة من النص للحفاظ على سجل القناة، والبحث، و/new، و/reset، والتبديل المستقبلي للنموذج أو الحزام، لكنه لا يستبدل Compaction الخاص بـ Codex بملخص من OpenClaw أو محرك السياق.
• يظل إنشاء الوسائط، وفهم الوسائط، وTTS، والموافقات، وإخراج أدوات المراسلة يمر عبر إعدادات موفر/نموذج OpenClaw المطابقة.
• ينطبق tool_result_persist على نتائج أدوات النص المملوكة لـ OpenClaw، وليس على سجلات نتائج الأدوات الأصلية لـ Codex.

لطبقات الخطافات، والأسطح المدعومة من V1، ومعالجة الأذونات الأصلية، وتوجيه الصفوف، وآليات رفع ملاحظات Codex، وتفاصيل Compaction، راجع تشغيل حزام Codex.

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

لا يظهر Codex كموفر /model عادي: هذا متوقع للإعدادات الجديدة. اختر نموذج openai/gpt-*، وفعّل plugins.entries.codex.enabled، وتحقق مما إذا كان plugins.allow يستبعد codex.

يستخدم OpenClaw الحزام المدمج بدلًا من Codex: تأكد من أن مرجع النموذج هو openai/gpt-* على موفر OpenAI الرسمي وأن Plugin الخاصة بـ Codex مثبتة ومفعلة. إذا كنت بحاجة إلى إثبات صارم أثناء الاختبار، فاضبط agentRuntime.id: "codex" للموفر أو النموذج. يفشل تشغيل Codex الإجباري بدلًا من الرجوع إلى OpenClaw.

يعود تشغيل OpenAI Codex إلى مسار مفتاح API: اجمع مقتطف Gateway منقحًا يظهر النموذج، ووقت التشغيل، والموفر المحدد، والإخفاق. اطلب من المتعاونين المتأثرين تشغيل هذا الأمر للقراءة فقط على مضيف OpenClaw لديهم:

(  pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth'   if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then    grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true  else    journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \      | grep -E -i "$pattern" || true  fi) | sed -E \    -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \    -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \    -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \    -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \    -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \    -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \  | tail -200

عادةً ما تتضمن المقتطفات المفيدة openai/gpt-5.5 أو openai/gpt-5.4، وRuntime: OpenAI Codex، وagentRuntime.id أو harnessRuntime، وcandidateProvider: "openai"، ونتيجة 401 أو Incorrect API key أو No API key. ينبغي أن يُظهر التشغيل المصحح مسار OAuth الخاص بـ OpenAI بدلًا من إخفاق مفتاح API عادي لـ OpenAI.

تبقى إعدادات مراجع نماذج Codex القديمة: شغّل openclaw doctor --fix. يعيد Doctor كتابة مراجع النماذج القديمة إلى openai/*، ويزيل دبابيس وقت التشغيل القديمة للجلسة والوكيل بالكامل، ويحافظ على تجاوزات ملف تعريف المصادقة الحالية.

يتم رفض خادم التطبيق: استخدم خادم تطبيق Codex إصدار 0.125.0 أو أحدث. تُرفض إصدارات ما قبل الإصدار من الإصدار نفسه أو الإصدارات الملحقة ببناء مثل 0.125.0-alpha.2 أو 0.125.0+custom لأن OpenClaw يختبر حد بروتوكول 0.125.0 المستقر.

لا يمكن لـ /codex status الاتصال: تحقق من أن Plugin codex المجمعة مفعلة، وأن plugins.allow يتضمنها عند ضبط قائمة سماح، وأن أي appServer.command أو url أو authToken أو ترويسات مخصصة صالحة.

اكتشاف النماذج بطيء: خفّض plugins.entries.codex.config.discovery.timeoutMs أو عطّل الاكتشاف. راجع مرجع حزام Codex.

يفشل نقل WebSocket فورًا: تحقق من appServer.url، وauthToken، والترويسات، وأن خادم التطبيق البعيد يتحدث إصدار بروتوكول خادم تطبيق Codex نفسه.

تُحظر أدوات الصدفة الأصلية أو أدوات التصحيح مع Native hook relay unavailable: لا يزال خيط Codex يحاول استخدام معرّف ترحيل خطاف أصلي لم يعد OpenClaw مسجّلاً لديه. هذه مشكلة في نقل خطافات Codex الأصلية، وليست فشلاً في خلفية ACP أو الموفّر أو GitHub أو أمر الصدفة. ابدأ جلسة جديدة في المحادثة المتأثرة باستخدام /new أو /reset، ثم أعد محاولة أمر غير مؤذٍ. إذا نجح ذلك مرة واحدة لكن فشلت استدعاءة الأداة الأصلية التالية مرة أخرى، فتعامل مع /new كحل مؤقت فقط: انسخ الموجّه إلى جلسة جديدة بعد إعادة تشغيل خادم تطبيق Codex أو OpenClaw Gateway حتى تُسقَط الخيوط القديمة وتُعاد إنشاء تسجيلات الخطافات الأصلية.

يستخدم نموذج غير Codex المشغّل المضمّن: هذا متوقع ما لم توجّهه سياسة وقت تشغيل الموفّر أو النموذج إلى مشغّل آخر. تبقى مراجع الموفّرين العاديين غير OpenAI على مسار الموفّر الطبيعي الخاص بها في وضع auto.

تم تثبيت استخدام الكمبيوتر لكن الأدوات لا تعمل: تحقّق من /codex computer-use status من جلسة جديدة. إذا أبلغت أداة عن Native hook relay unavailable، فاستخدم استرداد ترحيل الخطاف الأصلي أعلاه. راجع استخدام الكمبيوتر من Codex.

ذو صلة

• مرجع مشغّل Codex
• وقت تشغيل مشغّل Codex
• Plugins Codex الأصلية
• استخدام الكمبيوتر من Codex
• أوقات تشغيل الوكلاء
• موفّرو النماذج
• موفّر OpenAI
• مساعدة OpenAI Codex
• Plugins مشغّل الوكلاء
• خطافات Plugin
• تصدير التشخيصات
• الحالة
• الاختبار