بيئة تشغيل حاضنة Codex

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.

توثق هذه الصفحة عقد وقت التشغيل لدورات حاضنة Codex. للإعداد والتوجيه، ابدأ بـ حاضنة Codex. لحقول الإعداد، راجع مرجع حاضنة Codex.

​

نظرة عامة

وضع Codex ليس PI مع استدعاء نموذج مختلف في الداخل. يملك Codex جزءًا أكبر من حلقة النموذج الأصلية، ويكيّف OpenClaw أسطح الـ Plugin والأدوات والجلسات والتشخيصات حول ذلك الحد. لا يزال OpenClaw يملك توجيه القنوات، وملفات الجلسات، وتسليم الرسائل المرئية، وأدوات OpenClaw الديناميكية، والموافقات، وتسليم الوسائط، ومرآة النص الكامل. ويملك Codex الخيط الأصلي المعتمد، وحلقة النموذج الأصلية، واستمرار الأداة الأصلية، وCompaction الأصلية.

​

ربط الخيوط وتغييرات النموذج

عند إرفاق جلسة OpenClaw بخيط Codex موجود، ترسل الدورة التالية نموذج OpenAI المحدد حاليًا، وسياسة الموافقة، وصندوق العزل، وطبقة الخدمة إلى app-server مرة أخرى. يحافظ الانتقال من openai/gpt-5.5 إلى openai/gpt-5.2 على ربط الخيط لكنه يطلب من Codex المتابعة بالنموذج المحدد حديثًا.

​

الردود المرئية وHeartbeats

عندما تمر دورة محادثة مصدر عبر حاضنة Codex، تكون الردود المرئية افتراضيًا عبر أداة message في OpenClaw إذا لم يضبط النشر messages.visibleReplies صراحة. لا يزال بإمكان الوكيل إنهاء دورة Codex الخاصة به بشكل خاص؛ فهو لا ينشر إلى القناة إلا عندما يستدعي message(action="send"). اضبط messages.visibleReplies: "automatic" لإبقاء الردود النهائية في المحادثات المباشرة على مسار التسليم التلقائي القديم. تحصل دورات Heartbeat في Codex أيضًا على heartbeat_respond في كتالوج أدوات OpenClaw القابل للبحث افتراضيًا، بحيث يستطيع الوكيل تسجيل ما إذا كان ينبغي أن تبقى اليقظة صامتة أو ترسل إشعارًا من دون ترميز تدفق التحكم هذا في النص النهائي. تُرسل إرشادات المبادرة الخاصة بـ Heartbeat كتعليمة مطور لوضع تعاون Codex في دورة Heartbeat نفسها. وتستعيد دورات المحادثة العادية وضع Codex Default بدلًا من حمل فلسفة Heartbeat في موجه وقت التشغيل العادي الخاص بها.

​

حدود الخطافات

تحتوي حاضنة Codex على ثلاث طبقات خطافات: لا يستخدم OpenClaw ملفات hooks.json الخاصة بالمشروع أو العامة في Codex لتوجيه سلوك Plugin في OpenClaw. وبالنسبة لجسر الأداة الأصلية والأذونات المدعوم، يحقن OpenClaw إعداد Codex لكل خيط لـ PreToolUse وPostToolUse وPermissionRequest وStop. عند تمكين موافقات app-server في Codex، أي عندما لا تكون approvalPolicy هي "never"، يحذف إعداد الخطاف الأصلي الافتراضي المحقون PermissionRequest كي يتولى مراجع app-server في Codex وجسر الموافقة في OpenClaw التصعيدات الحقيقية بعد المراجعة. يمكن للمشغلين إضافة permission_request صراحة إلى nativeHookRelay.events عندما يحتاجون إلى مرحّل التوافق. تبقى خطافات Codex الأخرى مثل SessionStart وUserPromptSubmit عناصر تحكم على مستوى Codex. ولا تُعرض كخطافات Plugin في OpenClaw ضمن عقد v1. بالنسبة لأدوات OpenClaw الديناميكية، ينفذ OpenClaw الأداة بعد أن يطلب Codex الاستدعاء، لذلك يشغّل OpenClaw سلوك Plugin والوسيط الذي يملكه في مهايئ الحاضنة. وبالنسبة لأدوات Codex الأصلية، يملك Codex سجل الأداة المعتمد. يمكن لـ OpenClaw عكس أحداث محددة، لكنه لا يستطيع إعادة كتابة خيط Codex الأصلي ما لم يعرّض Codex تلك العملية عبر app-server أو استدعاءات الخطافات الأصلية. تأتي إسقاطات Compaction ودورة حياة LLM من إشعارات app-server في Codex وحالة مهايئ OpenClaw، لا من أوامر خطافات Codex الأصلية. أحداث before_compaction وafter_compaction وllm_input وllm_output في OpenClaw هي ملاحظات على مستوى المهايئ، وليست لقطات حرفية لطلب Codex الداخلي أو حمولات Compaction. تُسقط إشعارات app-server الأصلية hook/started وhook/completed في Codex كأحداث وكيل codex_app_server.hook للمسار والتصحيح. وهي لا تستدعي خطافات Plugin في OpenClaw.

​

عقد دعم V1

مدعوم في وقت تشغيل Codex v1: غير مدعوم في وقت تشغيل Codex v1:

​

الأذونات الأصلية واستثارات MCP

بالنسبة إلى PermissionRequest، لا يعيد OpenClaw إلا قرارات السماح أو الرفض الصريحة عندما تقرر السياسة ذلك. نتيجة عدم وجود قرار ليست سماحًا. يعاملها Codex على أنها لا تمثل قرار خطاف ويمررها إلى مسار الحارس الخاص به أو موافقة المستخدم. تحذف أنماط موافقة app-server في Codex هذا الخطاف الأصلي افتراضيًا. ينطبق هذا السلوك عندما يتم تضمين permission_request صراحة في nativeHookRelay.events أو عندما يثبته وقت تشغيل توافق. عندما يختار المشغّل allow-always لطلب إذن أصلي من Codex، يتذكر OpenClaw بصمة المطابقة الدقيقة لذلك المزوّد/الجلسة/إدخال الأداة/cwd ضمن نافذة جلسة محدودة. القرار المتذكَّر يطابق عمدا بشكل تام فقط: أي تغيير في الأمر أو الوسائط أو حمولة الأداة أو cwd ينشئ موافقة جديدة. تُوجَّه استدعاءات طلب الموافقة لأدوات Codex MCP عبر تدفق موافقات Plugin في OpenClaw عندما يضع Codex قيمة _meta.codex_approval_kind على "mcp_tool_call". تُرسل مطالبات Codex request_user_input مرة أخرى إلى الدردشة الأصلية، وتجيب رسالة المتابعة التالية في الطابور عن طلب الخادم الأصلي ذلك بدلا من توجيهها كسياق إضافي. تفشل طلبات الاستدعاء الأخرى في MCP بشكل مغلق.

​

توجيه الطابور

يرتبط توجيه طابور التشغيل النشط بـ turn/steer في خادم تطبيق Codex. مع الوضع الافتراضي messages.queue.mode: "steer"، يجمع OpenClaw رسائل الدردشة الموجودة في الطابور خلال نافذة الهدوء المضبوطة ويرسلها كطلب turn/steer واحد حسب ترتيب الوصول. يرسل وضع queue القديم طلبات turn/steer منفصلة. يمكن أن ترفض أدوار مراجعة Codex وCompaction اليدوية التوجيه في الدور نفسه. في هذه الحالة، يستخدم OpenClaw طابور المتابعة عندما يسمح الوضع المحدد بالرجوع الاحتياطي. راجع طابور التوجيه.

​

رفع ملاحظات Codex

عند اعتماد /diagnostics [note] لجلسة تستخدم عُدّة Codex الأصلية، يستدعي OpenClaw أيضا feedback/upload في خادم تطبيق Codex لمؤشرات Codex ذات الصلة. يطلب الرفع من خادم التطبيق تضمين السجلات لكل مؤشر مدرج ولمؤشرات Codex الفرعية المُنشأة عندما تكون متاحة. يمر الرفع عبر مسار الملاحظات المعتاد في Codex إلى خوادم OpenAI. إذا كانت ملاحظات Codex معطلة في خادم التطبيق ذلك، يعيد الأمر خطأ خادم التطبيق. تسرد استجابة التشخيصات المكتملة القنوات، ومعرفات جلسات OpenClaw، ومعرفات مؤشرات Codex، وأوامر codex resume <thread-id> المحلية للمؤشرات التي أُرسلت. إذا رفضت الموافقة أو تجاهلتها، لا يطبع OpenClaw معرفات Codex تلك ولا يرسل ملاحظات Codex. لا يستبدل الرفع تصدير تشخيصات Gateway المحلي. راجع تصدير التشخيصات لمعرفة سلوك الموافقة والخصوصية والحزمة المحلية ودردشة المجموعة. استخدم /codex diagnostics [note] فقط عندما تريد تحديدا رفع ملاحظات Codex للمؤشر المرفق حاليا من دون حزمة تشخيصات Gateway الكاملة.

​

Compaction ومرآة النص المنسوخ

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

​

الوسائط والتسليم

يواصل OpenClaw امتلاك تسليم الوسائط واختيار مزوّد الوسائط. تستخدم الصور والفيديو والموسيقى وPDF وTTS وفهم الوسائط إعدادات المزوّد/النموذج المطابقة مثل agents.defaults.imageGenerationModel وvideoGenerationModel وpdfModel و messages.tts. يستمر مرور النصوص والصور والفيديو والموسيقى وTTS والموافقات ومخرجات أدوات المراسلة عبر مسار التسليم المعتاد في OpenClaw. لا يتطلب توليد الوسائط PI. عندما يصدر Codex عنصرا أصليا لتوليد الصور يحتوي على savedPath، يمرر OpenClaw ذلك الملف عينه عبر مسار وسائط الرد المعتاد حتى إذا لم يكن في دور Codex أي نص للمساعد.

​

ذات صلة

• عُدّة Codex
• مرجع عُدّة Codex
• Plugins Codex الأصلية
• خطافات Plugin
• Plugins عُدّة الوكيل
• تصدير التشخيصات
• تصدير المسار