بيئات تشغيل الوكلاء

بيئة تشغيل الوكيل هي المكوّن الذي يمتلك حلقة نموذج واحدة مُعدّة: فهي تتلقى الموجّه، وتدير مخرجات النموذج، وتعالج استدعاءات الأدوات الأصلية، وتعيد الدورة المكتملة إلى OpenClaw.

من السهل الخلط بين بيئات التشغيل والموفّرين لأن كليهما يظهر قرب إعدادات النموذج. إنهما طبقتان مختلفتان:

الطبقة	أمثلة	ما تعنيه
الموفّر	openai, anthropic, openai-codex	كيف يصادق OpenClaw، ويكتشف النماذج، ويسمي مراجع النماذج.
النموذج	gpt-5.5, claude-opus-4-6	النموذج المحدد لدورة الوكيل.
بيئة تشغيل الوكيل	pi, codex, claude-cli	الحلقة أو الخلفية منخفضة المستوى التي تنفّذ الدورة المُعدّة.
القناة	Telegram, Discord, Slack, WhatsApp	المكان الذي تدخل منه الرسائل إلى OpenClaw وتخرج منه.

سترى أيضا كلمة الحاضنة في الكود. الحاضنة هي التنفيذ الذي يوفّر بيئة تشغيل للوكيل. على سبيل المثال، حاضنة Codex المضمّنة تنفّذ بيئة التشغيل codex. تستخدم الإعدادات العامة agentRuntime.id؛ ويعيد openclaw doctor --fix كتابة مفاتيح سياسة التشغيل القديمة إلى هذا الشكل.

هناك عائلتان لبيئات التشغيل:

• الحاضنات المضمّنة تعمل داخل حلقة الوكيل المُعدّة في OpenClaw. حاليا يشمل ذلك بيئة التشغيل المدمجة pi إضافة إلى حاضنات Plugin المسجلة مثل codex.
• خلفيات CLI تشغّل عملية CLI محلية مع إبقاء مرجع النموذج معياريا. على سبيل المثال، anthropic/claude-opus-4-7 مع agentRuntime.id: "claude-cli" يعني "حدد نموذج Anthropic، ونفّذ عبر Claude CLI." ليست claude-cli معرّف حاضنة مضمّنة ويجب عدم تمريرها إلى اختيار AgentHarness.

# أسطح Codex

ينشأ معظم الالتباس من عدة أسطح مختلفة تشترك في اسم Codex:

السطح	اسم/إعداد OpenClaw	ما يفعله
بيئة تشغيل خادم تطبيقات Codex الأصلية	مراجع نماذج openai/*	تشغّل دورات وكيل OpenAI المضمّنة عبر خادم تطبيقات Codex. هذا هو إعداد اشتراك ChatGPT/Codex المعتاد.
ملفات تعريف مصادقة Codex OAuth	موفّر المصادقة openai-codex	تخزّن مصادقة اشتراك ChatGPT/Codex التي تستهلكها حاضنة خادم تطبيقات Codex.
محوّل Codex ACP	runtime: "acp", agentId: "codex"	يشغّل Codex عبر مستوى التحكم الخارجي ACP/acpx. استخدمه فقط عندما يُطلب ACP/acpx صراحة.
مجموعة أوامر التحكم بالمحادثة الأصلية في Codex	/codex ...	تربط خيوط خادم تطبيقات Codex من المحادثة وتستأنفها وتوجّهها وتوقفها وتفحصها.
مسار OpenAI Platform API للأسطح غير الوكيلة	openai/* مع مصادقة مفتاح API	يُستخدم لواجهات OpenAI API المباشرة مثل الصور والتضمينات والكلام والوقت الفعلي.

هذه الأسطح مستقلة عمدا. يتيح تفعيل Plugin codex الميزات الأصلية لخادم التطبيقات؛ ويتولى openclaw doctor --fix إصلاح المسارات القديمة openai-codex/* وتنظيف تثبيتات الجلسات الراكدة. اختيار openai/* لنموذج وكيل يعني الآن "شغّل هذا عبر Codex" إلا إذا كان يتم استخدام سطح OpenAI API غير وكيل.

يستخدم إعداد اشتراك ChatGPT/Codex الشائع Codex OAuth للمصادقة، لكنه يُبقي مرجع النموذج بصيغة openai/* ويحدد بيئة التشغيل codex:

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

هذا يعني أن OpenClaw يحدد مرجع نموذج OpenAI، ثم يطلب من بيئة تشغيل خادم تطبيقات Codex تشغيل دورة الوكيل المضمّنة. لا يعني ذلك "استخدام فوترة API"، ولا يعني أن القناة أو كتالوج موفّري النماذج أو مخزن جلسات OpenClaw يصبح Codex.

عند تفعيل Plugin codex المضمّن، ينبغي أن يستخدم التحكم بـ Codex عبر اللغة الطبيعية سطح أوامر /codex الأصلي (/codex bind, /codex threads, /codex resume, /codex steer, /codex stop) بدلا من ACP. استخدم ACP مع Codex فقط عندما يطلب المستخدم ACP/acpx صراحة أو يختبر مسار محوّل ACP. أما Claude Code وGemini CLI وOpenCode وCursor والحاضنات الخارجية المشابهة فما زالت تستخدم ACP.

هذه شجرة القرار المواجهة للوكيل:

1. إذا طلب المستخدم ربط/تحكم/خيط/استئناف/توجيه/إيقاف Codex، فاستخدم سطح أوامر /codex الأصلي عندما يكون Plugin codex المضمّن مفعّلا.
2. إذا طلب المستخدم Codex كبيئة التشغيل المضمّنة أو أراد تجربة وكيل Codex العادية المدعومة بالاشتراك، فاستخدم openai/<model>.
3. إذا اختار المستخدم صراحة PI لنموذج OpenAI، فأبق مرجع النموذج openai/<model> واضبط agentRuntime.id: "pi". يُوجَّه ملف تعريف المصادقة openai-codex المحدد داخليا عبر نقل مصادقة Codex القديم في PI.
4. إذا كانت الإعدادات القديمة ما زالت تحتوي على مراجع نماذج openai-codex/*، فأصلحها إلى openai/<model> باستخدام openclaw doctor --fix.
5. إذا قال المستخدم صراحة ACP أو acpx أو محوّل Codex ACP، فاستخدم ACP مع runtime: "acp" وagentId: "codex".
6. إذا كان الطلب يخص Claude Code أو Gemini CLI أو OpenCode أو Cursor أو Droid أو حاضنة خارجية أخرى، فاستخدم ACP/acpx، وليس بيئة تشغيل الوكيل الفرعي الأصلية.

ما تقصده...	استخدم...
تحكم محادثة/خيط خادم تطبيقات Codex	/codex ... من Plugin codex المضمّن
بيئة تشغيل الوكيل المضمّنة لخادم تطبيقات Codex	مراجع نماذج الوكيل openai/*
OpenAI Codex OAuth	ملفات تعريف المصادقة openai-codex
Claude Code أو حاضنة خارجية أخرى	ACP/acpx

للاطلاع على فصل بادئات عائلة OpenAI، راجع OpenAI و موفّرو النماذج. ولعقد دعم بيئة تشغيل Codex، راجع حاضنة Codex.

# ملكية بيئة التشغيل

تمتلك بيئات التشغيل المختلفة مقادير مختلفة من الحلقة.

السطح	تضمين OpenClaw PI	خادم تطبيقات Codex
مالك حلقة النموذج	OpenClaw عبر مشغّل PI المضمّن	خادم تطبيقات Codex
حالة الخيط المعيارية	نص OpenClaw المنسوخ	خيط Codex، إضافة إلى مرآة نص OpenClaw المنسوخ
أدوات OpenClaw الديناميكية	حلقة أدوات OpenClaw الأصلية	موصولة عبر محوّل Codex
أدوات الصدفة والملفات الأصلية	مسار PI/OpenClaw	أدوات Codex الأصلية، موصولة عبر الخطافات الأصلية حيثما كان ذلك مدعوما
محرك السياق	تجميع سياق OpenClaw الأصلي	يركّب OpenClaw سياق المشاريع داخل دورة Codex
Compaction	OpenClaw أو محرك السياق المحدد	Compaction أصلي في Codex، مع إشعارات OpenClaw وصيانة المرآة
تسليم القناة	OpenClaw	OpenClaw

هذا الفصل في الملكية هو قاعدة التصميم الأساسية:

• إذا كان OpenClaw يمتلك السطح، يمكنه توفير سلوك خطافات Plugin العادي.
• إذا كانت بيئة التشغيل الأصلية تمتلك السطح، يحتاج OpenClaw إلى أحداث بيئة التشغيل أو خطافات أصلية.
• إذا كانت بيئة التشغيل الأصلية تمتلك حالة الخيط المعيارية، فينبغي أن يعكس OpenClaw السياق ويعرضه، لا أن يعيد كتابة داخليات غير مدعومة.

# اختيار بيئة التشغيل

يختار OpenClaw بيئة تشغيل مضمّنة بعد حلّ الموفّر والنموذج:

1. تفوز بيئة التشغيل المسجلة في الجلسة. لا تبدّل تغييرات الإعدادات نصا منسوخا موجودا مباشرة إلى نظام خيط أصلي مختلف.
2. يفرض OPENCLAW_AGENT_RUNTIME=<id> تلك البيئة للجلسات الجديدة أو المعاد ضبطها.
3. يمكن أن يضبط agents.defaults.agentRuntime.id أو agents.list[].agentRuntime.id القيمة auto، أو pi، أو معرّف حاضنة مضمّنة مسجلة مثل codex، أو اسما مستعارا مدعوما لخلفية CLI مثل claude-cli.
4. في وضع auto، يمكن لبيئات تشغيل Plugin المسجلة المطالبة بأزواج موفّر/نموذج مدعومة.
5. إذا لم تطالب أي بيئة تشغيل بدورة في وضع auto، يستخدم OpenClaw PI كبيئة تشغيل توافق. استخدم معرّف بيئة تشغيل صريحا عندما يجب أن يكون التشغيل صارما.

تفشل بيئات تشغيل Plugin الصريحة بإغلاق. على سبيل المثال، agentRuntime.id: "codex" يعني Codex أو خطأ اختيار/تشغيل واضحا؛ ولا يُعاد توجيهه بصمت إلى PI أبدا.

تختلف الأسماء المستعارة لخلفيات CLI عن معرّفات الحاضنات المضمّنة. الصيغة المفضلة لـ Claude CLI هي:

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-7",
      agentRuntime: { id: "claude-cli" },
    },
  },
}

تبقى المراجع القديمة مثل claude-cli/claude-opus-4-7 مدعومة للتوافق، لكن ينبغي أن تُبقي الإعدادات الجديدة الموفّر/النموذج معياريا وأن تضع خلفية التنفيذ في agentRuntime.id.

وضع auto محافظ عمدا لمعظم الموفّرين. نماذج وكلاء OpenAI هي الاستثناء: كل من بيئة التشغيل غير المضبوطة وauto يُحلّان إلى حاضنة Codex. تبقى إعدادات بيئة تشغيل PI الصريحة مسار توافق اختياري لدورات وكلاء openai/*؛ وعند إقرانها بملف تعريف مصادقة openai-codex محدد، يوجّه OpenClaw PI داخليا عبر نقل مصادقة Codex القديم مع إبقاء مرجع النموذج العام openai/*. تُصلح تثبيتات جلسات OpenAI PI الراكدة من دون إعداد صريح بالعودة إلى Codex.

إذا حذّر openclaw doctor من أن Plugin codex مفعّل بينما ما زال openai-codex/* في الإعدادات، فتعامل مع ذلك كحالة مسار قديم. شغّل openclaw doctor --fix لإعادة كتابته إلى openai/* مع بيئة تشغيل Codex.

# عقد التوافق

عندما لا تكون بيئة التشغيل PI، ينبغي أن توثق أسطح OpenClaw التي تدعمها. استخدم هذا الشكل لوثائق بيئة التشغيل:

السؤال	لماذا يهم
من يمتلك حلقة النموذج؟	يحدد أين تحدث عمليات إعادة المحاولة، ومتابعة الأدوات، وقرارات الإجابة النهائية.
من يمتلك سجل الخيط المعياري؟	يحدد ما إذا كان بإمكان OpenClaw تعديل السجل أم عكسه فقط.
هل تعمل أدوات OpenClaw الديناميكية؟	تعتمد الرسائل والجلسات وcron والأدوات المملوكة لـ OpenClaw على ذلك.
هل تعمل خطافات الأدوات الديناميكية؟	تتوقع Plugins وجود before_tool_call وafter_tool_call والبرمجيات الوسيطة حول الأدوات المملوكة لـ OpenClaw.
هل تعمل خطافات الأدوات الأصلية؟	تحتاج أدوات الصدفة والتصحيح والأدوات المملوكة لبيئة التشغيل إلى دعم خطافات أصلية للسياسة والمراقبة.
هل تعمل دورة حياة محرك السياق؟	تعتمد Plugins الذاكرة والسياق على دورة حياة التجميع، والإدخال، وما بعد الدورة، وCompaction.
ما بيانات Compaction المكشوفة؟	تحتاج بعض Plugins إلى الإشعارات فقط، بينما يحتاج بعضها الآخر إلى بيانات وصفية لما أُبقي عليه وما أُسقط.
ما غير المدعوم عمدا؟	ينبغي ألا يفترض المستخدمون التكافؤ مع PI عندما تمتلك بيئة التشغيل الأصلية حالة أكثر.

يوثق عقد دعم وقت تشغيل Codex في حاضنة Codex.

# تسميات الحالة

قد يعرض إخراج الحالة تسميتي Execution وRuntime معًا. اقرأهما بوصفهما تشخيصات، لا أسماء موفرين.

• يشير مرجع نموذج مثل openai/gpt-5.5 إلى الموفر/النموذج المحدد.
• يشير معرّف وقت تشغيل مثل codex إلى الحلقة التي تنفذ الدور.
• تشير تسمية قناة مثل Telegram أو Discord إلى مكان حدوث المحادثة.

إذا كانت الجلسة لا تزال تعرض PI بعد تغيير إعداد وقت التشغيل، فابدأ جلسة جديدة باستخدام /new أو امسح الجلسة الحالية باستخدام /reset. تحتفظ الجلسات الحالية بوقت التشغيل المسجل لديها حتى لا يُعاد تشغيل النص عبر نظامي جلسات أصليين غير متوافقين.

# ذات صلة

• حاضنة Codex
• OpenAI
• Plugins حاضنة الوكيل
• حلقة الوكيل
• النماذج
• الحالة