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

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.

بيئة تشغيل الوكيل هي المكوّن الذي يمتلك حلقة نموذج واحدة مُحضّرة: فهو يتلقى الموجّه، ويقود مخرجات النموذج، ويتعامل مع استدعاءات الأدوات الأصلية، ويعيد الدور المكتمل إلى OpenClaw. يسهل الخلط بين بيئات التشغيل والمزوّدين لأن كليهما يظهر قرب إعدادات النموذج. لكنّهما طبقتان مختلفتان:
الطبقةأمثلةما تعنيه
المزوّدopenai, anthropic, openai-codexكيف يصادق OpenClaw ويكتشف النماذج ويسمّي مراجع النماذج.
النموذجgpt-5.5, claude-opus-4-6النموذج المحدد لدور الوكيل.
بيئة تشغيل الوكيلpi, codex, claude-cliالحلقة أو الخلفية منخفضة المستوى التي تنفّذ الدور المُحضّر.
القناةTelegram, Discord, Slack, WhatsAppأين تدخل الرسائل إلى OpenClaw وتخرج منه.
سترى أيضًا كلمة harness في الكود. والحاضنة هي التنفيذ الذي يوفّر بيئة تشغيل للوكيل. على سبيل المثال، حاضنة 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 ACPruntime: "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؛ يحافظ doctor على مسار مصادقة Codex بإضافة agentRuntime.id: "codex" محدد النطاق على مستوى المزوّد/النموذج حيثما كان مرجع النموذج القديم يدل على ذلك.
  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.

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

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

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

يختار OpenClaw بيئة تشغيل مضمّنة بعد حلّ المزوّد والنموذج:
  1. تفوز سياسة بيئة التشغيل محددة النطاق على مستوى النموذج. يمكن أن توجد هذه في إدخال نموذج مزوّد مكوّن أو في agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime.
  2. تأتي بعدها سياسة بيئة التشغيل محددة النطاق على مستوى المزوّد عند models.providers.<provider>.agentRuntime.
  3. في وضع auto، يمكن لبيئات تشغيل Plugin المسجّلة أن تطالب بأزواج المزوّد/النموذج المدعومة.
  4. إذا لم تطالب أي بيئة تشغيل بدور في وضع auto، يستخدم OpenClaw PI كبيئة تشغيل توافق. استخدم معرّف بيئة تشغيل صريحًا عندما يجب أن يكون التشغيل صارمًا.
يتم تجاهل تثبيتات بيئة التشغيل على مستوى الجلسة الكاملة والوكيل الكامل. ويشمل ذلك OPENCLAW_AGENT_RUNTIME وحالة الجلسة agentHarnessId/agentRuntimeOverride وagents.defaults.agentRuntime وagents.list[].agentRuntime. شغّل openclaw doctor --fix لإزالة إعدادات بيئة التشغيل المتقادمة على مستوى الوكيل الكامل وتحويل مراجع نماذج بيئة التشغيل القديمة حيث يستطيع OpenClaw الحفاظ على القصد. تفشل بيئات تشغيل Plugin الصريحة على مستوى المزوّد/النموذج بشكل مغلق. على سبيل المثال، يعني agentRuntime.id: "codex" على مزوّد أو نموذج Codex أو خطأ اختيار/بيئة تشغيل واضحًا؛ ولا يُعاد توجيهه بصمت إلى PI مطلقًا. تختلف الأسماء البديلة لخلفيات CLI عن معرّفات الحاضنات المضمّنة. الصيغة المفضلة لـ Claude CLI هي: 
{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-7",
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}
تظل المراجع القديمة مثل claude-cli/claude-opus-4-7 مدعومة للتوافق، لكن يجب أن تُبقي الإعدادات الجديدة المزوّد/النموذج قياسيًا وأن تضع خلفية التنفيذ في سياسة بيئة التشغيل على مستوى المزوّد/النموذج. وضع auto محافظ عن قصد لمعظم المزوّدين. نماذج وكلاء OpenAI هي الاستثناء: فكل من بيئة التشغيل غير المضبوطة وauto يتحللان إلى حاضنة Codex. تظل إعدادات بيئة تشغيل PI الصريحة مسار توافق اختياريًا لأدوار وكلاء openai/*؛ وعند إقرانها بملف تعريف مصادقة openai-codex محدد، يوجّه OpenClaw PI داخليًا عبر نقل مصادقة Codex القديم مع إبقاء مرجع النموذج العام على هيئة openai/*. يتم تجاهل تثبيتات جلسات OpenAI PI المتقادمة عند اختيار بيئة التشغيل، ويمكن تنظيفها باستخدام openclaw doctor --fix. إذا حذّر 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.
هل تعمل خطافات الأدوات الأصلية؟تحتاج أدوات Shell وpatch والأدوات المملوكة لوقت التشغيل إلى دعم خطافات أصلي للسياسة والمراقبة.
هل تعمل دورة حياة محرك السياق؟تعتمد Plugins الذاكرة والسياق على دورة حياة التجميع والاستيعاب وما بعد الدور وCompaction.
ما بيانات Compaction المكشوفة؟تحتاج بعض Plugins إلى الإشعارات فقط، بينما تحتاج أخرى إلى بيانات وصفية لما أُبقي أو أُسقط.
ما غير المدعوم عمدًا؟ينبغي ألا يفترض المستخدمون تكافؤ PI حيث يملك وقت التشغيل الأصلي حالة أكثر.
عقد دعم وقت تشغيل Codex موثق في وقت تشغيل حزمة Codex.

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

قد يعرض خرج الحالة تسميتي Execution وRuntime معًا. اقرأهما بوصفهما تشخيصات، لا أسماء مزودين.
  • يوضح مرجع نموذج مثل openai/gpt-5.5 المزود/النموذج المحدد.
  • يوضح معرف وقت تشغيل مثل codex الحلقة التي تنفذ الدور.
  • توضح تسمية قناة مثل Telegram أو Discord مكان حدوث المحادثة.
إذا كان التشغيل لا يزال يعرض وقت تشغيل غير متوقع، فافحص أولًا سياسة وقت تشغيل المزود/النموذج المحدد. لم تعد تثبيتات وقت تشغيل الجلسات القديمة تحدد التوجيه.

​
ذو صلة