الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Computer Use هو Plugin MCP أصلي لـ Codex للتحكم في سطح المكتب المحلي. لا يقوم OpenClaw بتضمين تطبيق سطح المكتب، ولا ينفذ إجراءات سطح المكتب بنفسه، ولا يتجاوز أذونات Codex. يقوم Plugin codex المضمن فقط بإعداد خادم تطبيق Codex: إذ يفعّل دعم Plugin في 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 إعادة استخدام أذونات Accessibility وScreen Recording المحلية الخاصة بالتطبيق لأدوات الأتمتة الخاصة بـ 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.

​
MCP مباشر عبر cua-driver

Codex Computer Use ليس الطريقة الوحيدة لكشف التحكم في سطح المكتب. إذا كنت تريد أن تستدعي أوقات التشغيل المدارة بواسطة OpenClaw مشغل TryCua مباشرة، فاستخدم خادم cua-driver mcp upstream عبر سجل MCP في OpenClaw بدلا من مسار السوق الخاص بـ Codex. بعد تثبيت cua-driver، إما اطلب منه أمر OpenClaw: 
cua-driver mcp-config --client openclaw
أو سجّل خادم stdio بنفسك: 
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
يحافظ ذلك المسار على سطح أدوات MCP upstream كما هو، بما في ذلك مخططات المشغل واستجابات MCP المهيكلة. استخدمه عندما تريد أن يتوفر مشغل CUA كخادم MCP عادي في OpenClaw. استخدم إعداد Codex Computer Use في هذه الصفحة عندما يجب أن يمتلك خادم تطبيق Codex تثبيت Plugin، وإعادة تحميل MCP، واستدعاءات الأدوات الأصلية داخل أدوار وضع Codex. مشغل CUA خاص بـ macOS وما زال يتطلب أذونات macOS المحلية التي يطلبها تطبيقه، مثل Accessibility وScreen Recording. لا يقوم OpenClaw بتثبيت cua-driver، أو منح تلك الأذونات، أو تجاوز نموذج الأمان الخاص بالمشغل upstream.

​
إعداد سريع

عيّن plugins.entries.codex.config.computerUse عندما يجب أن تتوفر Computer Use لأدوار وضع Codex قبل بدء محادثة: 
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}
باستخدام هذا التكوين، يفحص OpenClaw خادم تطبيق Codex قبل كل دور في وضع Codex. إذا كانت Computer Use مفقودة لكن خادم تطبيق Codex اكتشف بالفعل سوقا قابلا للتثبيت، يطلب OpenClaw من خادم تطبيق Codex تثبيت Plugin أو إعادة تفعيله وإعادة تحميل خوادم MCP. على macOS، عندما لا يكون هناك سوق مطابق مسجل وتوجد حزمة تطبيق Codex القياسية، يحاول OpenClaw أيضا تسجيل سوق Codex المضمن من /Applications/Codex.app/Contents/Resources/plugins/openai-bundled قبل أن يفشل. إذا ظل الإعداد غير قادر على إتاحة خادم MCP، يفشل الدور قبل بدء المحادثة. بعد تغيير تكوين Computer Use، استخدم /new أو /reset في الدردشة المتأثرة قبل الاختبار إذا كانت محادثة Codex موجودة قد بدأت بالفعل.

​
الأوامر

استخدم أوامر /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، ولا يفعّل دعم Plugin في Codex. install يفعّل دعم Plugin في خادم تطبيق Codex، ويضيف اختياريا مصدر سوق مهيأ، ويثبت Plugin المهيأ أو يعيد تفعيله عبر خادم تطبيق Codex، ويعيد تحميل خوادم MCP، ويتحقق من أن خادم MCP يكشف أدوات.

​
خيارات السوق

يستخدم OpenClaw واجهة API خادم التطبيق نفسها التي يكشفها Codex نفسه. تختار حقول السوق أين يجب أن يعثر Codex على computer-use.
الحقلاستخدمه عندمادعم التثبيت
بلا حقل سوقتريد أن يستخدم خادم تطبيق Codex الأسواق التي يعرفها بالفعل.نعم، عندما يعيد خادم التطبيق سوقا محليا.
marketplaceSourceلديك مصدر سوق Codex يمكن لخادم التطبيق إضافته.نعم، للتنفيذ الصريح لـ /codex computer-use install.
marketplacePathتعرف بالفعل مسار ملف السوق المحلي على المضيف.نعم، للتثبيت الصريح والتثبيت التلقائي عند بدء الدور.
marketplaceNameتريد اختيار سوق مسجل بالفعل بالاسم.نعم فقط عندما يكون لدى السوق المحدد مسار محلي.
قد تحتاج أدلة 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
يمكنك أيضا تسجيله صراحة من shell باستخدام Codex: 
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
إذا كنت تستخدم مسار تطبيق Codex غير قياسي، فعيّن computerUse.marketplacePath إلى مسار ملف سوق محلي أو شغّل /codex computer-use install --source <marketplace-source> مرة واحدة.

​
حد الكتالوج البعيد

يمكن لخادم تطبيق Codex سرد وقراءة إدخالات الكتالوج البعيدة فقط، لكنه لا يدعم حاليا plugin/install البعيد. هذا يعني أن marketplaceName يمكنه اختيار سوق بعيد فقط لفحوصات الحالة، لكن عمليات التثبيت وإعادة التفعيل ما زالت تحتاج إلى سوق محلي عبر marketplaceSource أو marketplacePath. إذا ذكرت الحالة أن Plugin متوفر في سوق Codex بعيد لكن التثبيت البعيد غير مدعوم، فشغّل التثبيت بمصدر أو مسار محلي: 
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

​
مرجع التكوين

الحقلالافتراضيالمعنى
enabledمستنتجيتطلب Computer Use. تكون القيمة الافتراضية true عند تعيين حقل Computer Use آخر.
autoInstallfalseيثبت أو يعيد التفعيل من الأسواق المكتشفة بالفعل عند بدء الدور.
marketplaceDiscoveryTimeoutMs60000المدة التي ينتظرها التثبيت لاكتشاف سوق خادم تطبيق Codex.
marketplaceSourceغير معينسلسلة المصدر الممررة إلى marketplace/add في خادم تطبيق Codex.
marketplacePathغير معينمسار ملف سوق Codex محلي يحتوي على Plugin.
marketplaceNameغير معيناسم سوق Codex المسجل المطلوب اختياره.
pluginNamecomputer-useاسم Plugin سوق Codex.
mcpServerNamecomputer-useاسم خادم MCP الذي يكشفه Plugin المثبت.
يرفض التثبيت التلقائي عند بدء الدور عمدا قيم marketplaceSource المهيأة. إضافة مصدر جديد هي عملية إعداد صريحة، لذا استخدم /codex computer-use install --source <marketplace-source> مرة واحدة، ثم دع autoInstall يتولى عمليات إعادة التفعيل المستقبلية من الأسواق المحلية المكتشفة. يمكن للتثبيت التلقائي عند بدء الدور استخدام marketplacePath مهيأ، لأن ذلك مسار محلي بالفعل على المضيف.

​
ما يفحصه OpenClaw

يبلغ OpenClaw عن سبب إعداد مستقر داخليا وينسق الحالة المرئية للمستخدم للدردشة:
السببالمعنىالخطوة التالية
disabledتم حل computerUse.enabled إلى false.عيّن enabled أو حقلا آخر من Computer Use.
marketplace_missingلم يكن هناك سوق مطابق متاح.هيئ المصدر أو المسار أو اسم السوق.
plugin_not_installedالسوق موجود، لكن Plugin غير مثبت.شغّل التثبيت أو فعّل autoInstall.
plugin_disabledPlugin مثبت لكنه معطل في تكوين Codex.شغّل التثبيت لإعادة تفعيله.
remote_install_unsupportedالسوق المحدد بعيد فقط.استخدم marketplaceSource أو marketplacePath.
mcp_missingPlugin مفعّل، لكن خادم MCP غير متاح.افحص Codex Computer Use وأذونات نظام التشغيل.
readyPlugin وأدوات MCP متاحة.ابدأ الدور في وضع Codex.
check_failedفشل طلب خادم تطبيق Codex أثناء فحص الحالة.افحص اتصال خادم التطبيق والسجلات.
auto_install_blockedسيتطلب إعداد بدء الدور إضافة مصدر جديد.شغّل التثبيت الصريح أولا.
يتضمن خرج الدردشة حالة Plugin، وحالة خادم MCP، والسوق، والأدوات عند توفرها، والرسالة المحددة لخطوة الإعداد الفاشلة.

​
أذونات macOS

Computer Use خاص بـ macOS. قد يحتاج خادم MCP المملوك لـ Codex إلى أذونات نظام تشغيل محلية قبل أن يتمكن من فحص التطبيقات أو التحكم فيها. إذا قال OpenClaw إن Computer Use مثبتة لكن خادم MCP غير متاح، فتحقق أولا من إعداد Computer Use من جانب Codex:
  • يعمل Codex app-server على المضيف نفسه حيث ينبغي أن يحدث التحكم بسطح المكتب.
  • تم تمكين Plugin Computer Use في إعدادات Codex.
  • يظهر خادم MCP الخاص بـ computer-use في حالة MCP لـ Codex app-server.
  • منح macOS الأذونات المطلوبة لتطبيق التحكم بسطح المكتب.
  • يمكن لجلسة المضيف الحالية الوصول إلى سطح المكتب الذي يجري التحكم به.
يفشل OpenClaw عمدا بوضع مغلق عندما تكون computerUse.enabled بقيمة true. ينبغي ألا تتابع دورة بنمط Codex بصمت من دون أدوات سطح المكتب الأصلية التي تطلبها الإعداد.

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

تشير الحالة إلى أنه غير مثبت. شغّل /codex computer-use install. إذا لم يتم اكتشاف السوق، فمرّر --source أو --marketplace-path. تشير الحالة إلى أنه مثبت لكنه معطل. شغّل /codex computer-use install مرة أخرى. يكتب تثبيت Codex app-server إعدادات Plugin مجددا بحالة ممكّنة. تشير الحالة إلى أن التثبيت البعيد غير مدعوم. استخدم مصدر سوق محليا أو مسارا محليا. يمكن فحص إدخالات الفهرس البعيدة فقط، لكن لا يمكن تثبيتها عبر API الحالي لـ app-server. تشير الحالة إلى أن خادم MCP غير متاح. أعد تشغيل التثبيت مرة واحدة كي يعاد تحميل خوادم MCP. إذا بقي غير متاح، فأصلح تطبيق Codex Computer Use أو حالة MCP لـ Codex app-server أو أذونات macOS. تنتهي مهلة الحالة أو فحص على computer-use.list_apps. يكون Plugin وخادم MCP موجودين، لكن جسر Computer Use المحلي لم يرد. أنهِ Codex Computer Use أو أعد تشغيله، وأعد تشغيل Codex Desktop إذا لزم الأمر، ثم أعد المحاولة في جلسة OpenClaw جديدة. تقول أداة Computer Use: Native hook relay unavailable. تعذر على خطاف الأداة الأصلي لـ Codex الوصول إلى مرحّل OpenClaw نشط عبر الجسر المحلي أو مسار Gateway الاحتياطي. ابدأ جلسة OpenClaw جديدة باستخدام /new أو /reset. إذا استمر ذلك، فأعد تشغيل Gateway حتى يتم إسقاط سلاسل app-server القديمة وتسجيلات الخطافات، ثم أعد المحاولة. يرفض التثبيت التلقائي عند بدء الدورة مصدرا. هذا مقصود. أضف المصدر أولا باستخدام /codex computer-use install --source <marketplace-source> صراحة، ثم يمكن للتثبيت التلقائي عند بدء الدورات المستقبلية استخدام السوق المحلي المكتشف.

​
ذو صلة