استخدام الحاسوب في Codex

Computer Use هو Plugin ‏MCP أصلي لـ Codex للتحكم المحلي بسطح المكتب. لا يضمّن OpenClaw تطبيق سطح المكتب، ولا ينفذ إجراءات سطح المكتب بنفسه، ولا يتجاوز أذونات Codex. إن Plugin ‏codex المضمّن يجهّز Codex app-server فقط: فهو يفعّل دعم Plugins في Codex، ويعثر على Plugin ‏Codex Computer Use المكوّن أو يثبّته، ويتحقق من توفر خادم MCP ‏computer-use، ثم يترك لـ Codex امتلاك استدعاءات أدوات MCP الأصلية أثناء أدوار وضع Codex.

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

OpenClaw.app وPeekaboo

تكامل Peekaboo في OpenClaw.app منفصل عن Codex Computer Use. يمكن لتطبيق macOS استضافة مقبس PeekabooBridge بحيث يستطيع CLI ‏peekaboo إعادة استخدام منح التطبيق المحلية لإمكانية الوصول وتسجيل الشاشة لأدوات أتمتة Peekaboo الخاصة. لا يثبّت ذلك الجسر Codex Computer Use ولا يعمل وكيلا له، كما أن Codex Computer Use لا يستدعي عبر مقبس PeekabooBridge.

استخدم جسر Peekaboo عندما تريد أن يكون OpenClaw.app مضيفا واعيا بالأذونات لأتمتة Peekaboo CLI. استخدم هذه الصفحة عندما يجب أن يتوفر Plugin ‏MCP الأصلي computer-use الخاص بـ Codex لوكيل OpenClaw في وضع Codex قبل بدء الدور.

تطبيق iOS

تطبيق iOS منفصل عن Codex Computer Use. فهو لا يثبّت خادم MCP ‏computer-use الخاص بـ Codex ولا يعمل وكيلا له، وليس خلفية للتحكم بسطح المكتب. بدلا من ذلك، يتصل تطبيق iOS كعقدة OpenClaw ويكشف إمكانات الهاتف عبر أوامر العقدة مثل canvas.* وcamera.* وscreen.* وlocation.* وtalk.*.

استخدم iOS عندما تريد أن يقود وكيل عقدة iPhone عبر Gateway. استخدم هذه الصفحة عندما يجب أن يتحكم وكيل في وضع Codex بسطح مكتب macOS المحلي من خلال Plugin ‏Computer Use الأصلي الخاص بـ Codex.

cua-driver MCP المباشر

Codex Computer Use ليس الطريقة الوحيدة لكشف التحكم بسطح المكتب. إذا كنت تريد أن تستدعي أوقات التشغيل المُدارة من OpenClaw مشغل TryCua مباشرة، فاستخدم خادم cua-driver mcp المنبع عبر سجل MCP في OpenClaw بدلا من تدفق السوق الخاص بـ Codex.

بعد تثبيت cua-driver، إما أن تطلب منه أمر OpenClaw:

cua-driver mcp-config --client openclaw

أو تسجل خادم stdio بنفسك:

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'

يحافظ هذا المسار على سطح أدوات MCP المنبعي كما هو، بما في ذلك مخططات المشغل واستجابات MCP المهيكلة. استخدمه عندما تريد أن يكون مشغل CUA متاحا كخادم MCP عادي في OpenClaw. استخدم إعداد Codex Computer Use في هذه الصفحة عندما يجب أن يمتلك Codex app-server تثبيت Plugin، وإعادة تحميل MCP، واستدعاءات الأدوات الأصلية داخل أدوار وضع Codex.

مشغل CUA خاص بـ macOS وما زال يتطلب أذونات macOS المحلية التي يطلبها تطبيقه، مثل إمكانية الوصول وتسجيل الشاشة. لا يثبّت OpenClaw ‏cua-driver، ولا يمنح تلك الأذونات، ولا يتجاوز نموذج أمان المشغل المنبعي.

الإعداد السريع

اضبط plugins.entries.codex.config.computerUse عندما يجب أن يتوفر Computer Use لأدوار وضع Codex قبل بدء سلسلة محادثة. يفعّل autoInstall: true خيار Computer Use ويسمح لـ OpenClaw بتثبيته أو إعادة تفعيله قبل الدور:

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

مع هذا الإعداد، يتحقق OpenClaw من Codex app-server قبل كل دور في وضع Codex. إذا كان Computer Use مفقودا لكن Codex app-server اكتشف بالفعل سوقا قابلا للتثبيت، يطلب OpenClaw من Codex app-server تثبيت Plugin أو إعادة تفعيله وإعادة تحميل خوادم MCP. على macOS، عندما لا يكون أي سوق مطابق مسجلا وتوجد حزمة تطبيق Codex القياسية، يحاول OpenClaw أيضا تسجيل سوق Codex المضمّن من /Applications/Codex.app/Contents/Resources/plugins/openai-bundled قبل أن يفشل. إذا ظل الإعداد غير قادر على جعل خادم MCP متاحا، يفشل الدور قبل بدء سلسلة المحادثة.

بعد تغيير إعداد Computer Use، استخدم /new أو /reset في الدردشة المتأثرة قبل الاختبار إذا كانت سلسلة Codex موجودة قد بدأت بالفعل.

عند بدء stdio المُدار على macOS، يفضّل OpenClaw حزمة تطبيق Codex المكتبي الموقعة في /Applications/Codex.app/Contents/Resources/codex عندما تكون موجودة. يحافظ ذلك على Computer Use ضمن حزمة التطبيق التي تملك أذونات التحكم بسطح المكتب المحلية. إذا لم يكن تطبيق سطح المكتب مثبتا، يرجع OpenClaw إلى ثنائي Codex المُدار المثبت بجانب Plugin. إذا تمت تهيئة تطبيق سطح مكتب مثبت بإصدار app-server غير مدعوم، يغلق OpenClaw ذلك الابن ويعيد المحاولة بمرشح الثنائي المُدار التالي بدلا من السماح لتطبيق سطح مكتب قديم بحجب البديل المحلي لـ Plugin. لا يزال إعداد appServer.command الصريح أو OPENCLAW_CODEX_APP_SERVER_BIN يتجاوز هذا الاختيار المُدار.

الأوامر

استخدم أوامر /codex computer-use من أي سطح دردشة يتوفر فيه سطح أوامر Plugin ‏codex. هذه أوامر دردشة/وقت تشغيل في OpenClaw، وليست أوامر CLI فرعية من openclaw codex ...:

/codex computer-use status/codex computer-use install/codex computer-use install --source <marketplace-source>/codex computer-use install --marketplace-path <path>/codex computer-use install --marketplace <name>

status للقراءة فقط. لا يضيف مصادر سوق، ولا يثبّت Plugins، ولا يفعّل دعم Plugins في Codex. إذا لم يفعل أي إعداد خيار Computer Use، فقد يبلغ status أنه معطل حتى بعد أمر تثبيت لمرة واحدة.

يفعّل install دعم Plugins في Codex app-server، ويضيف اختياريا مصدر سوق مكوّنا، ويثبّت أو يعيد تفعيل Plugin المكوّن عبر Codex app-server، ويعيد تحميل خوادم MCP، ويتحقق من أن خادم MCP يكشف أدوات. لأن التثبيت يغير موارد مضيف موثوقة، يمكن لمالك فقط أو عميل Gateway بصلاحية operator.admin تشغيل install. يمكن للمرسلين الآخرين المصرح لهم الاستمرار في استخدام أمر status للقراءة فقط، بما في ذلك مع التجاوزات.

خيارات السوق

يستخدم OpenClaw واجهة API نفسها الخاصة بـ app-server التي يكشفها Codex نفسه. تحدد حقول السوق أين يجب أن يجد Codex ‏computer-use.

قد تحتاج منازل Codex الجديدة إلى لحظة قصيرة لزرع أسواقها الرسمية. أثناء التثبيت، يستطلع OpenClaw ‏plugin/list لمدة تصل إلى marketplaceDiscoveryTimeoutMs ميلي ثانية. القيمة الافتراضية هي 60 ثانية.

إذا احتوت عدة أسواق معروفة على Computer Use، يفضّل OpenClaw openai-bundled، ثم openai-curated، ثم local. تفشل المطابقات الغامضة غير المعروفة بشكل مغلق وتطلب منك ضبط marketplaceName أو marketplacePath.

سوق macOS المضمّن

تضمّن إصدارات Codex المكتبية الحديثة Computer Use هنا:

/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use

عندما يكون computerUse.autoInstall صحيحا ولا يكون أي سوق يحتوي computer-use مسجلا، يحاول OpenClaw إضافة جذر السوق المضمّن القياسي تلقائيا:

/Applications/Codex.app/Contents/Resources/plugins/openai-bundled

يمكنك أيضا تسجيله صراحة من الصدفة باستخدام Codex:

codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled

إذا كنت تستخدم مسار تطبيق Codex غير قياسي، فشغّل /codex computer-use install --source <marketplace-root> مرة واحدة أو اضبط computerUse.marketplacePath إلى مسار ملف سوق محلي. استخدم --marketplace-path فقط عندما يكون لديك مسار ملف JSON للسوق، وليس جذر السوق المضمّن.

حد الفهرس البعيد

يمكن لـ Codex app-server سرد وقراءة إدخالات الفهرس البعيدة فقط، لكنه لا يدعم حاليا plugin/install البعيد. هذا يعني أن marketplaceName يمكنه تحديد سوق بعيد فقط لفحوصات الحالة، لكن عمليات التثبيت وإعادة التفعيل لا تزال تحتاج إلى سوق محلي عبر marketplaceSource أو marketplacePath.

إذا قالت الحالة إن Plugin متاح في سوق Codex بعيد لكن التثبيت البعيد غير مدعوم، فشغّل التثبيت باستخدام مصدر أو مسار محلي:

/codex computer-use install --source <marketplace-source>/codex computer-use install --marketplace-path <path>

مرجع الإعداد

يرفض التثبيت التلقائي عند بدء الدور عمدا قيم 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 الأذونات المطلوبة لتطبيق التحكم بسطح المكتب.
• يمكن لجلسة المضيف الحالية الوصول إلى سطح المكتب الذي يتم التحكم به.

يفشل OpenClaw عمداً بإغلاق المسار عندما تكون 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 computer-use install --source /Applications/Codex.app/Contents/Resources/plugins/openai-bundled

تقول أداة استخدام الكمبيوتر Native hook relay unavailable. تعذر على خطاف الأداة الأصلي في Codex الوصول إلى ترحيل OpenClaw نشط عبر الجسر المحلي أو رجوع Gateway. ابدأ جلسة OpenClaw جديدة باستخدام /new أو /reset. إذا عمل مرة واحدة ثم فشل مرة أخرى عند استدعاء أداة لاحق، فإن /new يمسح المحاولة الحالية فقط؛ أعد تشغيل خادم تطبيق Codex أو OpenClaw Gateway حتى تُسقط المسارات القديمة وتسجيلات الخطافات، ثم أعد المحاولة في جلسة جديدة.

يرفض التثبيت التلقائي عند بدء الدورة مصدراً. هذا مقصود. أضف المصدر باستخدام /codex computer-use install --source <marketplace-source> الصريح أولاً، وبعد ذلك يمكن للتثبيت التلقائي عند بدء الدورات المستقبلية استخدام السوق المحلي المكتشف.

ذو صلة

• تسخير Codex
• جسر Peekaboo
• تطبيق iOS