Codex harness

مرجع بيئة تشغيل Codex

يغطي هذا المرجع الإعدادات التفصيلية لـ Plugin codex المضمّن. بالنسبة لقرارات الإعداد والتوجيه، ابدأ بـ حاضنة Codex.

سطح إعدادات Plugin

توجد جميع إعدادات حاضنة Codex ضمن plugins.entries.codex.config.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

الحقول المدعومة في المستوى الأعلى:

الحقل	القيمة الافتراضية	المعنى
`discovery`	مفعّل	إعدادات اكتشاف النماذج لـ `model/list` في خادم تطبيقات Codex.
`appServer`	خادم تطبيقات stdio مُدار	إعدادات النقل، والأمر، والمصادقة، والموافقة، والعزل، والمهلة.
`codexDynamicToolsLoading`	`"searchable"`	استخدم `"direct"` لوضع أدوات OpenClaw الديناميكية مباشرة في سياق أدوات Codex الأولي.
`codexDynamicToolsExclude`	`[]`	أسماء أدوات OpenClaw الديناميكية الإضافية المطلوب حذفها من أدوار خادم تطبيقات Codex.
`codexPlugins`	معطّل	دعم Plugin/التطبيق الأصلي في Codex للـ plugins المنسقة والمثبتة من المصدر بعد الترحيل. راجع Plugins الأصلية في Codex.
`computerUse`	معطّل	إعداد استخدام الكمبيوتر في Codex. راجع استخدام الكمبيوتر في Codex.

نقل خادم التطبيقات

افتراضياً، يبدأ OpenClaw ملف Codex الثنائي المُدار المشحون مع Plugin المضمّن:

codex app-server --listen stdio://

يبقي هذا إصدار خادم التطبيقات مرتبطاً بـ Plugin codex المضمّن بدلاً من أي Codex CLI منفصل قد يكون مثبتاً محلياً. اضبط appServer.command فقط عندما تريد عن قصد تشغيل ملف تنفيذي مختلف.

بالنسبة إلى خادم تطبيقات قيد التشغيل بالفعل، استخدم نقل WebSocket:

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

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

الحقل	القيمة الافتراضية	المعنى
`transport`	`"stdio"`	يؤدي `"stdio"` إلى تشغيل Codex؛ ويتصل `"websocket"` بـ `url`.
`command`	ملف Codex الثنائي المُدار	الملف التنفيذي لنقل stdio. اتركه غير مضبوط لاستخدام الملف الثنائي المُدار.
`args`	`["app-server", "--listen", "stdio://"]`	الوسيطات لنقل stdio.
`url`	غير مضبوط	عنوان URL لخادم تطبيقات WebSocket.
`authToken`	غير مضبوط	رمز Bearer لنقل WebSocket.
`headers`	`{}`	ترويسات WebSocket إضافية.
`clearEnv`	`[]`	أسماء متغيرات بيئة إضافية تُزال من عملية خادم تطبيقات stdio التي جرى تشغيلها بعد أن يبني OpenClaw بيئته الموروثة.
`requestTimeoutMs`	`60000`	مهلة استدعاءات مستوى التحكم في خادم التطبيقات.
`turnCompletionIdleTimeoutMs`	`60000`	نافذة هادئة بعد طلب إلى خادم التطبيقات محدود النطاق بدور بينما ينتظر OpenClaw حدث `turn/completed`.
`mode`	`"yolo"` ما لم تمنع متطلبات Codex المحلية YOLO	إعداد مسبق لتنفيذ YOLO أو التنفيذ الخاضع لمراجعة guardian.
`approvalPolicy`	`"never"` أو سياسة موافقة guardian مسموح بها	سياسة موافقة Codex الأصلية المرسلة إلى بدء الخيط واستئنافه والدور.
`sandbox`	`"danger-full-access"` أو عزل guardian مسموح به	وضع عزل Codex الأصلي المرسل إلى بدء الخيط واستئنافه.
`approvalsReviewer`	`"user"` أو مراجع guardian مسموح به	استخدم `"auto_review"` للسماح لـ Codex بمراجعة مطالبات الموافقة الأصلية عند السماح بذلك.
`defaultWorkspaceDir`	دليل العملية الحالي	مساحة العمل التي يستخدمها `/codex bind` عند حذف `--cwd`.
`serviceTier`	غير مضبوط	طبقة خدمة خادم تطبيقات Codex اختيارية. يمكّن `"priority"` توجيه الوضع السريع، ويطلب `"flex"` معالجة مرنة، ويمسح `null` التجاوز. تُقبل القيمة القديمة `"fast"` بوصفها `"priority"`.

يحظر Plugin مصافحات خادم التطبيقات القديمة أو غير ذات الإصدار. يجب أن يعلن خادم تطبيقات Codex عن الإصدار المستقر 0.125.0 أو أحدث.

أوضاع الموافقة والعزل

تستخدم جلسات خادم تطبيقات stdio المحلية وضع YOLO افتراضياً: approvalPolicy: "never"، وapprovalsReviewer: "user"، و sandbox: "danger-full-access". يتيح وضع المشغّل المحلي الموثوق هذا لأدوار OpenClaw غير المراقبة وHeartbeats التقدم من دون مطالبات موافقة أصلية لا يوجد أحد متاح للرد عليها.

إذا كان ملف متطلبات النظام المحلي في Codex يمنع قيم موافقة YOLO أو المراجع أو العزل الضمنية، فإن OpenClaw يعامل القيمة الافتراضية الضمنية باعتبارها guardian بدلاً من ذلك ويحدد أذونات guardian المسموح بها. تُحترم إدخالات [[remote_sandbox_config]] المطابقة لاسم المضيف في ملف المتطلبات نفسه عند اتخاذ قرار القيمة الافتراضية للعزل.

اضبط appServer.mode: "guardian" لموافقات Codex الخاضعة لمراجعة guardian:

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

يتوسع الإعداد المسبق guardian إلى approvalPolicy: "on-request"، وapprovalsReviewer: "auto_review"، وsandbox: "workspace-write" عندما تكون تلك القيم مسموحاً بها. تتجاوز حقول السياسة الفردية mode. لا تزال قيمة المراجع الأقدم guardian_subagent مقبولة كاسم مستعار للتوافق، لكن يجب أن تستخدم الإعدادات الجديدة auto_review.

المصادقة وعزل البيئة

تُحدد المصادقة بهذا الترتيب:

ملف تعريف مصادقة OpenClaw Codex صريح للوكيل.
الحساب الحالي لخادم التطبيقات في منزل Codex الخاص بذلك الوكيل.
بالنسبة إلى عمليات تشغيل خادم تطبيقات 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؛ استخدم ملف تعريف مصادقة صريحاً أو حساب خادم التطبيقات البعيد نفسه.

ترث عمليات تشغيل خادم تطبيقات stdio بيئة عملية OpenClaw افتراضياً، لكن OpenClaw يملك جسر حساب خادم تطبيقات Codex ويضبط كلاً من CODEX_HOME و HOME إلى أدلة لكل وكيل ضمن حالة OpenClaw لذلك الوكيل. يقرأ محمّل Skills الخاص بـ Codex كلاً من $CODEX_HOME/skills و$HOME/.agents/skills، لذلك تُعزل القيمتان لعمليات تشغيل خادم التطبيقات المحلية. يبقي ذلك Skills والـ plugins والإعدادات والحسابات وحالة الخيوط الأصلية في Codex محصورة في وكيل OpenClaw بدلاً من تسربها من منزل Codex CLI الشخصي للمشغّل.

لا تزال plugins الخاصة بـ OpenClaw ولقطات Skills في OpenClaw تمر عبر سجل plugins ومحمّل Skills الخاصين بـ OpenClaw. أما أصول Codex CLI الشخصية فلا تمر. إذا كانت لديك Skills أو plugins مفيدة في Codex CLI يجب أن تصبح جزءاً من وكيل OpenClaw، فقم بجردها صراحة:

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

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

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

لا يؤثر appServer.clearEnv إلا في عملية خادم تطبيقات Codex الفرعية التي جرى تشغيلها. يظل CODEX_HOME وHOME محجوزين لعزل Codex لكل وكيل في OpenClaw عند عمليات التشغيل المحلية.

الأدوات الديناميكية

تستخدم أدوات Codex الديناميكية تحميل searchable افتراضياً. لا يكشف OpenClaw الأدوات الديناميكية التي تكرر عمليات مساحة العمل الأصلية في Codex:

read
write
edit
apply_patch
exec
process
update_plan

تتوفر أدوات تكامل OpenClaw المتبقية، مثل المراسلة والجلسات والوسائط وcron والمتصفح والعُقد وgateway وheartbeat_respond وweb_search، من خلال بحث أدوات Codex ضمن مساحة الأسماء openclaw. يُبقي هذا سياق النموذج الأولي أصغر. تبقى sessions_yield وردود المصدر الخاصة بأدوات الرسائل فقط مباشرة لأن تلك عقود تحكم بالدور.

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

المهل الزمنية

تُحدَّد استدعاءات الأدوات الديناميكية المملوكة لـ OpenClaw بشكل مستقل عن appServer.requestTimeoutMs. يستخدم كل طلب Codex من نوع item/tool/call أول مهلة متاحة وفق هذا الترتيب:

وسيط timeoutMs موجب لكل استدعاء.
بالنسبة إلى image_generate، القيمة agents.defaults.imageGenerationModel.timeoutMs.
بالنسبة إلى أداة الوسائط image لفهم الوسائط، القيمة tools.media.image.timeoutSeconds محولة إلى مللي ثانية، أو مهلة الوسائط الافتراضية البالغة 60 ثانية.
القيمة الافتراضية للأداة الديناميكية البالغة 30 ثانية.

تُحدَّد ميزانيات الأدوات الديناميكية بسقف 600000 مللي ثانية. عند انتهاء المهلة، يلغي OpenClaw إشارة الأداة حيث يكون ذلك مدعوماً ويعيد إلى Codex استجابة أداة ديناميكية فاشلة كي يستمر الدور بدلاً من ترك الجلسة في حالة processing.

بعد أن يستجيب OpenClaw لطلب خادم تطبيقات محدد النطاق بدور من Codex، يتوقع الحاضن أيضاً أن يُنهي Codex الدور الأصلي باستخدام turn/completed. إذا صمت خادم التطبيقات لمدة appServer.turnCompletionIdleTimeoutMs بعد تلك الاستجابة، يقاطع OpenClaw دور Codex وفق أفضل جهد، ويسجل مهلة تشخيصية، ويحرر مسار جلسة OpenClaw حتى لا تُصف رسائل الدردشة اللاحقة خلف دور أصلي متقادم.

أي إشعار غير نهائي للدور نفسه، بما في ذلك rawResponseItem/completed، يعطل ذلك المراقب القصير لأن Codex أثبت أن الدور لا يزال حياً. يستمر المراقب النهائي الأطول في حماية الأدوار العالقة فعلاً. تتضمن تشخيصات المهلة آخر طريقة إشعار من خادم التطبيقات، وبالنسبة إلى عناصر استجابة المساعد الخام، نوع العنصر ودوره ومعرّفه ومعاينة محدودة لنص المساعد.

اكتشاف النماذج

افتراضياً، يطلب Plugin Codex من خادم التطبيقات النماذج المتاحة. تعود ملكية إتاحة النماذج إلى خادم تطبيقات Codex، لذلك يمكن أن تتغير القائمة عندما يرقي OpenClaw إصدار @openai/codex المضمن أو عندما يوجه نشرٌ ما appServer.command إلى ملف Codex ثنائي مختلف. ويمكن أيضاً أن تكون الإتاحة مرتبطة بالحساب. استخدم /codex models على Gateway قيد التشغيل لرؤية الفهرس الحي لذلك الحاضن والحساب.

إذا فشل الاكتشاف أو انتهت مهلته، يستخدم OpenClaw فهرساً احتياطياً مضمنًا لـ:

GPT-5.5
GPT-5.4 mini
GPT-5.2

الحاضن المضمن الحالي هو @openai/codex 0.130.0. أعاد فحص model/list ضد خادم التطبيقات المضمن ذلك ما يلي:

معرّف النموذج	الافتراضي	مخفي	وسائط الإدخال	جهود الاستدلال
`gpt-5.5`	نعم	لا	نص، صورة	low, medium, high, xhigh
`gpt-5.4`	لا	لا	نص، صورة	low, medium, high, xhigh
`gpt-5.4-mini`	لا	لا	نص، صورة	low, medium, high, xhigh
`gpt-5.3-codex`	لا	لا	نص، صورة	low, medium, high, xhigh
`gpt-5.3-codex-spark`	لا	لا	نص	low, medium, high, xhigh
`gpt-5.2`	لا	لا	نص، صورة	low, medium, high, xhigh

يمكن أن يعيد فهرس خادم التطبيقات نماذج مخفية للتدفقات الداخلية أو المتخصصة، لكنها ليست خيارات عادية في منتقي النماذج.

اضبط الاكتشاف ضمن plugins.entries.codex.config.discovery:

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
        },
      },
    },
  },
}

عطّل الاكتشاف عندما تريد أن يتجنب بدء التشغيل فحص Codex وأن يستخدم الفهرس الاحتياطي فقط:

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: false,
          },
        },
      },
    },
  },
}

ملفات تمهيد مساحة العمل

يتعامل Codex مع AGENTS.md بنفسه من خلال الاكتشاف الأصلي لوثائق المشروع. لا يكتب OpenClaw ملفات وثائق مشروع Codex اصطناعية ولا يعتمد على أسماء ملفات Codex الاحتياطية لملفات الشخصية، لأن احتياطيات Codex لا تنطبق إلا عند غياب AGENTS.md.

لتحقيق تكافؤ مساحة عمل OpenClaw، يحل حاضن Codex ملفات التمهيد الأخرى، بما في ذلك SOUL.md وTOOLS.md وIDENTITY.md وUSER.md وHEARTBEAT.md وBOOTSTRAP.md وMEMORY.md عند وجودها، ويمررها عبر تعليمات مطور Codex في thread/start وthread/resume. يُبقي هذا سياق شخصية مساحة العمل والملف التعريفي مرئياً على مسار Codex الأصلي المخصص لتشكيل السلوك دون تكرار AGENTS.md.

تجاوزات البيئة

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

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.

مرجع بيئة تشغيل Codex

سطح إعدادات Plugin

نقل خادم التطبيقات

أوضاع الموافقة والعزل

المصادقة وعزل البيئة

الأدوات الديناميكية

المهل الزمنية

اكتشاف النماذج

ملفات تمهيد مساحة العمل

تجاوزات البيئة

ذات صلة

Ask OpenClaw

# سطح إعدادات Plugin

# نقل خادم التطبيقات

# أوضاع الموافقة والعزل

# المصادقة وعزل البيئة

# الأدوات الديناميكية

# المهل الزمنية

# اكتشاف النماذج

# ملفات تمهيد مساحة العمل

# تجاوزات البيئة

# ذات صلة

سطح إعدادات Plugin

نقل خادم التطبيقات

أوضاع الموافقة والعزل

المصادقة وعزل البيئة

الأدوات الديناميكية

المهل الزمنية

اكتشاف النماذج

ملفات تمهيد مساحة العمل

تجاوزات البيئة

ذات صلة