codex المضمّن سوى تجهيز خادم تطبيق Codex:
فهو يفعّل دعم Plugins في Codex، ويعثر على Plugin Computer Use المضبوط أو يثبّته،
ويتحقق من توفر خادم MCP computer-use، ثم يترك
لـ Codex ملكية استدعاءات أدوات MCP الأصلية أثناء دورات وضع Codex.
استخدم هذه الصفحة عندما يكون OpenClaw مستخدمًا بالفعل لحاضنة Codex الأصلية. لإعداد
بيئة التشغيل نفسها، راجع حاضنة Codex.
يختلف هذا عن أداة الكمبيوتر المدعومة بعقدة والمضمّنة في OpenClaw. استخدم الأداة المضمّنة عندما ينبغي لعقد الوكيل نفسه التحكم في جهاز Mac مقترن، سواء كان الوكيل يعمل على Gateway أو على Node أخرى. استخدم Codex Computer Use عندما ينبغي لخادم تطبيق Codex امتلاك تثبيت MCP المحلي والأذونات واستدعاءات الأدوات الأصلية.
OpenClaw.app وPeekaboo
يُعد تكامل Peekaboo في OpenClaw.app منفصلًا عن Codex Computer Use. يمكن لتطبيق macOS استضافة مقبس PeekabooBridge كي تتمكن CLI peekaboo من إعادة استخدام
أذونات تسهيلات الاستخدام وتسجيل الشاشة المحلية الممنوحة للتطبيق، وذلك لأدوات
الأتمتة الخاصة بـ Peekaboo. لا يثبّت هذا الجسر Codex Computer Use ولا يعمل وسيطًا له، كما أن
Codex Computer Use لا يستدعي عبر مقبس PeekabooBridge.
استخدم جسر Peekaboo عندما تريد أن يكون OpenClaw.app
مضيفًا مدركًا للأذونات لأتمتة CLI الخاصة بـ Peekaboo. استخدم هذه الصفحة عندما ينبغي
لوكيل OpenClaw في وضع Codex أن يتوفر له Plugin MCP computer-use الأصلي
الخاص بـ Codex قبل بدء الدورة.
تطبيق iOS
تطبيق iOS منفصل عن Codex Computer Use. فهو لا يثبّت خادم MCP computer-use
الخاص بـ Codex ولا يعمل وسيطًا له، وليس واجهة خلفية للتحكم في سطح المكتب.
بدلًا من ذلك، يتصل تطبيق iOS بوصفه Node في OpenClaw ويعرض إمكانات
الأجهزة المحمولة من خلال أوامر Node مثل canvas.* وcamera.* وscreen.*
وlocation.* وtalk.*.
استخدم iOS عندما تريد من وكيل تشغيل Node على iPhone
عبر Gateway. استخدم هذه الصفحة عندما ينبغي لوكيل في وضع Codex التحكم في
سطح مكتب macOS المحلي من خلال Plugin Computer Use الأصلي الخاص بـ Codex.
MCP المباشر لـ cua-driver
Codex Computer Use ليس الطريقة الوحيدة لإتاحة التحكم في سطح المكتب. إذا كنت تريد أن تستدعي بيئات التشغيل التي يديرها OpenClaw برنامج تشغيل TryCua مباشرةً، فاستخدم خادمcua-driver mcp الأصلي عبر سجل MCP الخاص بـ OpenClaw بدلًا من
مسار السوق الخاص بـ Codex.
بعد تثبيت cua-driver، إما أن تطلب منه أمر OpenClaw:
cua-driver أو منح تلك الأذونات أو تجاوز
نموذج أمان برنامج التشغيل الأصلي.
الإعداد السريع
اضبطplugins.entries.codex.config.computerUse عندما يجب أن يتوفر
Computer Use لدورات وضع Codex قبل بدء سلسلة محادثة. يؤدي autoInstall: true إلى
تفعيل Computer Use والسماح لـ OpenClaw بتثبيته أو إعادة تمكينه قبل الدورة:
/Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled، مع الاحتفاظ بـ
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
كخيار احتياطي لعمليات التثبيت المستقلة القديمة. إذا ظل الإعداد غير قادر على إتاحة
خادم MCP، تفشل الدورة قبل بدء سلسلة المحادثة.
بعد تغيير ضبط Computer Use، استخدم /new أو /reset في المحادثة
المتأثرة قبل الاختبار إذا كانت سلسلة محادثة Codex حالية قد بدأت بالفعل.
على macOS، يفضّل بدء التشغيل المُدار لـ Computer Use الملف التنفيذي لتطبيق سطح المكتب في
/Applications/ChatGPT.app/Contents/Resources/codex، ثم
يرجع إلى /Applications/Codex.app/Contents/Resources/codex كخيار احتياطي لعمليات
التثبيت المستقلة القديمة. ينطبق هذا أيضًا على أوامر حالة Computer Use
والتثبيت لمرة واحدة التي تشغّل عميلها الخاص. وهذا يُبقي التحكم في سطح المكتب تحت
حزمة التطبيق المالكة لأذونات macOS المحلية. إذا لم يكن تطبيق سطح المكتب
مثبّتًا، يرجع OpenClaw إلى الملف التنفيذي المُدار لـ Codex والمثبّت بجوار
Plugin. تفضّل دورات Codex المُدارة العادية التي تستخدم المجلد الرئيسي المعزول الافتراضي للوكيل
تلك الحزمة المثبّتة أولًا، كي لا يحجب تطبيق سطح مكتب أقدم دعم النماذج
الحالي. تظل المجلدات الرئيسية ضمن نطاق المستخدم مفضِّلةً لتطبيق سطح المكتب لأنها تستطيع تحميل
حالة Computer Use الأصلية. كما يظل المجلد الرئيسي المعزول للوكيل، الذي يفعّل ضبط Codex الفعلي فيه
Computer Use، مفضِّلًا لتطبيق سطح المكتب. يظل ضبط
appServer.command الصريح أو OPENCLAW_CODEX_APP_SERVER_BIN متجاوزًا
لهذا الاختيار المُدار.
يسلسل OpenClaw قراءات ضبط Codex الأصلي وتثبيت Computer Use
داخل Gateway واحد قيد التشغيل. ولا تخضع عملية Codex منفصلة أو Gateway آخر
لهذا الحاجز. بعد تغيير ضبط Plugin الأصلي لـ Codex خارج
Gateway، أعد تشغيل Gateway وابدأ محادثة جديدة قبل الاعتماد على
الاختيار الجديد.
الأوامر
استخدم أوامر/codex computer-use من أي واجهة محادثة يتوفر فيها
سطح أوامر Plugin codex. هذه أوامر محادثة/بيئة تشغيل خاصة بـ OpenClaw،
وليست أوامر فرعية لـ CLI openclaw codex ...:
status هو الإجراء الافتراضي وهو للقراءة فقط: لا يضيف مصادر أسواق
ولا يثبّت Plugins ولا يفعّل دعم Plugins في Codex. إذا لم يفعّل أي ضبط
Computer Use، فقد يعرض status أنه معطّل حتى بعد أمر تثبيت
لمرة واحدة.
يعمل install على تمكين دعم Plugins في خادم تطبيق Codex، وإضافة
مصدر سوق مضبوط اختياريًا، وتثبيت Plugin المضبوط أو إعادة تمكينه
من خلال خادم تطبيق Codex، وإعادة تحميل خوادم MCP، والتحقق من أن خادم MCP
يعرض أدوات. ولأن التثبيت يغيّر موارد المضيف الموثوقة،
لا يمكن تشغيل install إلا بواسطة مالك أو عميل Gateway من نوع operator.admin.
يمكن للمرسلين الآخرين المصرّح لهم مواصلة استخدام أمر status للقراءة فقط،
بما في ذلك مع التجاوزات.
كانت الإصدارات الأقدم تقبل تجاوزات الهوية لمرة واحدة --plugin و--server
و--mcp-server. اضبط computerUse.pluginName و
computerUse.mcpServerName بصورة دائمة بدلًا منها. عند استخدام علامة هوية قديمة،
يحدّد الأمر الإعداد الدقيق الذي يجب حفظه بصورة دائمة ويكرر الإجراء المطلوب
إضافةً إلى أي علامات سوق مدعومة في إرشادات الترحيل.
خيارات السوق
يستخدم OpenClaw واجهة API نفسها لخادم التطبيق التي يوفّرها Codex. تحدد حقول السوق المكان الذي ينبغي لـ Codex العثور فيه علىcomputer-use.
قد تحتاج المجلدات الرئيسية الجديدة لـ Codex إلى لحظة قصيرة لتهيئة
أسواقها الرسمية. أثناء التثبيت، يستطلع OpenClaw
plugin/list لمدة تصل إلى
marketplaceDiscoveryTimeoutMs مللي ثانية (الافتراضي 60 ثانية).
إذا احتوت عدة أسواق معروفة على Computer Use، يفضّل OpenClaw
openai-bundled، ثم openai-curated، ثم local. أما التطابقات المجهولة
الملتبسة فتفشل بشكل مغلق وتطلب منك ضبط marketplaceName أو
marketplacePath.
سوق macOS المضمّن
تضمّن إصدارات سطح المكتب الحالية من ChatGPT تطبيق Computer Use هنا؛ وتستخدم إصدارات سطح المكتب المستقلة القديمة من Codex التخطيط نفسه ضمنCodex.app:
computerUse.autoInstall هي true ولا يكون أي سوق يحتوي على
computer-use مسجّلًا، يحاول OpenClaw إضافة أول جذر سوق
مضمّن قياسي موجود:
/codex computer-use install --source <marketplace-root> مرة واحدة، أو اضبط computerUse.marketplacePath على
مسار ملف سوق محلي. لا تستخدم --marketplace-path إلا عندما يكون لديك
مسار ملف JSON الخاص بالسوق، وليس جذر السوق المضمّن.
ذاكرة التخزين المؤقت المشتركة للـ Plugin
يترك الإعداد الافتراضيpluginCacheMode: "independent" كل مجلد رئيسي لـ Codex وذاكرة
التخزين المؤقت للـ Plugin الخاصة به دون إدارة. اضبط pluginCacheMode: "shared" لنسخ Plugin
Computer Use المضمّن إلى ذاكرة التخزين المؤقت القابلة للاكتشاف للـ Plugin في مجلد Codex الرئيسي النشط
قبل بدء تشغيل خادم التطبيق. يحافظ الوضع المشترك على الإصدارات الأقدم المخزّنة مؤقتًا لأن
عملاء Codex قيد التشغيل قد يظلون يشيرون إلى أدلة Plugins ذات الإصدارات المحددة؛ كما يحافظ
فشل استبدال النسخة على ذاكرة التخزين المؤقت النشطة. يؤدي ضبط
marketplaceName أو marketplacePath الصريح إلى تعطيل هذه
المطابقة، كي لا يتجاوز OpenClaw ذلك الاختيار.
قيود الكتالوج البعيد
يمكن لخادم تطبيق Codex سرد إدخالات الكتالوج البعيدة فقط وقراءتها، لكنه لا يدعم حاليًاplugin/install عن بُعد. وهذا يعني أن marketplaceName
يمكنه تحديد سوق بعيد فقط لفحوصات الحالة، لكن عمليات التثبيت وإعادة
التمكين لا تزال تحتاج إلى سوق محلي عبر marketplaceSource أو
marketplacePath.
إذا أشارت الحالة إلى أن Plugin متاح في سوق Codex بعيد، لكن
التثبيت عن بُعد غير مدعوم، فنفّذ التثبيت باستخدام مصدر أو مسار محلي:
مرجع الضبط
يرفض التثبيت التلقائي عند بدء الدور عمدًا قيم
marketplaceSource
المُهيأة. تُعد إضافة مصدر جديد عملية إعداد صريحة، لذا استخدم
/codex computer-use install --source <marketplace-source> مرة واحدة، ثم دع
autoInstall يتولى عمليات إعادة التفعيل اللاحقة من أسواق الإضافات المحلية المكتشفة.
يمكن للتثبيت التلقائي عند بدء الدور استخدام marketplacePath مُهيأ، لأنه
مسار محلي موجود مسبقًا على المضيف.
يقبل كل حقل أيضًا تجاوزًا عبر متغير بيئة، ويُتحقق منه عندما يكون
مفتاح الإعداد المطابق غير معيّن:
ما الذي يتحقق منه OpenClaw
يُبلغ OpenClaw داخليًا عن سبب إعداد ثابت، وينسّق الحالة المعروضة للمستخدم في الدردشة:
يتضمن إخراج الدردشة حالة Plugin وحالة خادم MCP وسوق الإضافات،
والأدوات عند توفرها، والرسالة المحددة لخطوة الإعداد الفاشلة.
أذونات macOS
استخدام الحاسوب خاص بنظام macOS. قد يحتاج خادم MCP المملوك لـ Codex إلى أذونات محلية من نظام التشغيل قبل أن يتمكن من فحص التطبيقات أو التحكم فيها. إذا ذكر OpenClaw أن استخدام الحاسوب مثبّت لكن خادم MCP غير متاح، فتحقق أولًا من إعداد استخدام الحاسوب من جهة Codex:- يعمل خادم تطبيق Codex على المضيف نفسه الذي يجب أن يحدث عليه التحكم بسطح المكتب.
- Plugin استخدام الحاسوب مفعّل في إعدادات Codex.
- يظهر خادم MCP
computer-useفي حالة MCP لخادم تطبيق Codex. - منح macOS الأذونات المطلوبة لتطبيق التحكم بسطح المكتب.
- تستطيع جلسة المضيف الحالية الوصول إلى سطح المكتب الجاري التحكم فيه.
computerUse.enabled هي true. يجب
ألا يتابع الدور في وضع Codex بصمت من دون أدوات سطح المكتب الأصلية
التي تطلبها الإعدادات.
استكشاف الأخطاء وإصلاحها
تشير الحالة إلى أنه غير مثبّت. شغّل/codex computer-use install. إذا لم
يُكتشف سوق الإضافات، فمرّر --source أو --marketplace-path.
تشير الحالة إلى أنه مثبّت لكنه معطّل. شغّل /codex computer-use install
مرة أخرى. يعيد تثبيت خادم تطبيق Codex كتابة إعدادات Plugin بحالة مفعّلة.
تشير الحالة إلى أن التثبيت عن بُعد غير مدعوم. استخدم مصدرًا أو مسارًا محليًا
لسوق الإضافات. يمكن فحص إدخالات الفهرس المتاحة عن بُعد فقط، لكن لا يمكن
تثبيتها عبر واجهة API الحالية لخادم التطبيق.
تشير الحالة إلى أن خادم MCP غير متاح. أعد تشغيل التثبيت مرة واحدة لكي تُعاد
تحميل خوادم MCP. إذا ظل غير متاح، فأصلح تطبيق استخدام الحاسوب في Codex،
أو حالة MCP لخادم تطبيق Codex، أو أذونات macOS.
تنتهي مهلة الحالة أو الاختبار عند computer-use.list_apps. يكون Plugin
وخادم MCP موجودين، لكن جسر استخدام الحاسوب المحلي لم يستجب.
أغلق استخدام الحاسوب في Codex أو أعد تشغيله، وأعد تشغيل Codex Desktop عند الحاجة، ثم
أعد المحاولة في جلسة OpenClaw جديدة. إذا سبق أن شغّل المضيف استخدام الحاسوب
عبر خادم تطبيق Codex مُدار أقدم، فحدّث Plugin المثبّت من
سوق الإضافات المضمّن مع تطبيق سطح المكتب (استخدم مسار Codex.app لعمليات
تثبيت Codex المستقلة لسطح المكتب):
Native hook relay unavailable. تعذر على
خطاف الأداة الأصلي في Codex الوصول إلى مرحّل OpenClaw نشط عبر
الجسر المحلي أو مسار Gateway الاحتياطي. ابدأ جلسة OpenClaw جديدة باستخدام /new
أو /reset. إذا نجح مرة ثم فشل مجددًا في استدعاء أداة لاحق،
فإن /new يمسح المحاولة الحالية فقط؛ أعد تشغيل خادم تطبيق Codex أو
Gateway الخاص بـ OpenClaw حتى تُزال سلاسل التنفيذ القديمة وتسجيلات الخطافات، ثم
أعد المحاولة في جلسة جديدة.
يرفض التثبيت التلقائي عند بدء الدور مصدرًا. هذا مقصود. أضف
المصدر أولًا باستخدام /codex computer-use install --source <marketplace-source> بشكل صريح، وبعدها يمكن للتثبيت التلقائي في بدايات الأدوار اللاحقة استخدام
سوق الإضافات المحلي المكتشف.