OpenAI

توفّر OpenAI واجهات API للمطوّرين لنماذج GPT، كما يتوفر Codex أيضًا كوكيل برمجة ضمن خطة ChatGPT من خلال عملاء Codex لدى OpenAI. يستخدم OpenClaw معرّف مزوّد واحدًا، openai، لكلا شكلي المصادقة.

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

• نماذج الوكيل - نماذج openai/* عبر وقت تشغيل Codex؛ سجّل الدخول باستخدام مصادقة Codex لاستخدام اشتراك ChatGPT/Codex، أو اضبط ملفًا احتياطيًا متوافقًا مع Codex لمفتاح API من OpenAI عندما تريد عمدًا استخدام مصادقة مفتاح API.
• واجهات API من OpenAI غير الوكيلة - وصول مباشر إلى OpenAI Platform مع فوترة حسب الاستخدام عبر OPENAI_API_KEY أو إعداد مفتاح API من OpenAI.
• الإعدادات القديمة - تُصلَح مراجع نماذج Codex القديمة بواسطة openclaw doctor --fix إلى openai/* بالإضافة إلى وقت تشغيل Codex.

تدعم OpenAI صراحةً استخدام OAuth للاشتراكات في أدوات وسير عمل خارجية مثل OpenClaw.

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

الاختيار السريع

خريطة التسمية

الأسماء متشابهة لكنها غير قابلة للتبادل:

يعني هذا أن الإعدادات يمكن أن تحتوي عمدًا على مراجع نماذج openai/* بينما تشير ملفات المصادقة إما إلى بيانات اعتماد مفتاح API أو بيانات اعتماد ChatGPT/Codex OAuth. استخدم auth.order.openai للإعدادات؛ يعيد openclaw doctor --fix كتابة مراجع نماذج Codex القديمة، ومعرّفات ملفات مصادقة Codex القديمة، وترتيب مصادقة Codex القديم إلى مسار OpenAI القياسي.

معاينة محدودة لـ GPT-5.6

يتعرّف OpenClaw على معرّفات نماذج GPT-5.6 العامة الثلاثة:

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

تعرض النماذج الثلاثة جميعها استدلال max في كتالوج خادم تطبيق Codex الحالي. يصف إعلان الإطلاق من OpenAI نموذج Sol بأنه المستوى الرائد، وTerra بأنه المستوى المتوازن، وLuna بأنه المستوى السريع الأقل تكلفة. راجع إعلان إطلاق GPT-5.6 ودليل الوصول إلى المعاينة.

يكون الوصول مدرجًا في قائمة سماح أثناء المعاينة، ويمكن منحه بشكل منفصل لكل من API وCodex. لا تمنح خطة ChatGPT مدفوعة وحدها حق الوصول. يُبقي OpenClaw openai/gpt-5.5 كإعداد افتراضي؛ ويؤدي اختيار مرجع GPT-5.6 بدون وصول إلى إرجاع خطأ الوصول من المصدر بدلًا من الرجوع بصمت.

تغطية ميزات OpenClaw

تضمينات الذاكرة

يمكن لـ OpenClaw استخدام OpenAI، أو نقطة نهاية تضمين متوافقة مع OpenAI، لفهرسة memory_search وتضمينات الاستعلام:

{  agents: {    defaults: {      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",      },    },  },}

بالنسبة إلى نقاط النهاية المتوافقة مع OpenAI التي تتطلب تسميات تضمين غير متماثلة، اضبط queryInputType وdocumentInputType ضمن memorySearch. يمرّر OpenClaw هذه القيم كحقول طلب input_type خاصة بالمزوّد: تستخدم تضمينات الاستعلام queryInputType؛ وتستخدم مقاطع الذاكرة المفهرسة والفهرسة الدُفعية documentInputType. راجع مرجع إعدادات الذاكرة للاطلاع على المثال الكامل.

البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.5

openclaw models list --provider openai

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

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

مصادقة app-server الأصلية لـ Codex

تستخدم حزمة تشغيل app-server الأصلية لـ Codex مراجع نماذج openai/* مع إعداد وقت تشغيل محذوف أو مزود/نموذج agentRuntime.id: "codex"، لكن مصادقتها لا تزال مبنية على الحساب. يختار OpenClaw المصادقة بهذا الترتيب:

1. ملفات مصادقة OpenAI المرتبة للوكيل، ويفضل أن تكون تحت auth.order.openai. شغل openclaw doctor --fix لترحيل معرفات ملفات مصادقة Codex القديمة وترتيب مصادقة Codex القديم.
2. الحساب الموجود في app-server، مثل تسجيل دخول ChatGPT محلي عبر Codex CLI.
3. لإطلاقات app-server المحلية عبر stdio فقط، CODEX_API_KEY، ثم OPENAI_API_KEY، عندما يبلغ app-server عن عدم وجود حساب ولا يزال يتطلب مصادقة OpenAI.

يعني ذلك أن تسجيل دخول اشتراك ChatGPT/Codex المحلي لا يستبدل لمجرد أن عملية Gateway لديها أيضا OPENAI_API_KEY لنماذج OpenAI المباشرة أو التضمينات. احتياطي مفتاح API من البيئة هو فقط مسار stdio المحلي بلا حساب؛ ولا يرسل إلى اتصالات app-server عبر WebSocket. عند تحديد ملف Codex بنمط الاشتراك، يبقي OpenClaw أيضا CODEX_API_KEY و OPENAI_API_KEY خارج عملية app-server الفرعية عبر stdio التي يتم تشغيلها، ويرسل بيانات الاعتماد المحددة من خلال RPC تسجيل الدخول في app-server. عندما يحجب ملف الاشتراك ذلك بسبب حد استخدام Codex، يستطيع OpenClaw التدوير إلى ملف مفتاح API التالي المرتب openai:* دون تغيير النموذج المحدد أو الخروج من حزمة تشغيل Codex. بعد مرور وقت إعادة ضبط الاشتراك، يصبح ملف الاشتراك مؤهلا مرة أخرى.

توليد الصور

يسجل Plugin openai المضمن توليد الصور عبر أداة image_generate. وهو يدعم توليد الصور بمفتاح OpenAI API وتوليد الصور عبر Codex OAuth من خلال مرجع النموذج نفسه openai/gpt-image-2.

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 هو الإعداد الافتراضي لكل من توليد الصور من النص وتحرير الصور في OpenAI. تظل gpt-image-1.5 وgpt-image-1 وgpt-image-1-mini قابلة للاستخدام كتجاوزات صريحة للنموذج. استخدم openai/gpt-image-1.5 لإخراج PNG/WebP بخلفية شفافة؛ إذ ترفض API الحالية لـ gpt-image-2 الخيار background: "transparent".

لطلب بخلفية شفافة، ينبغي للوكلاء استدعاء image_generate مع model: "openai/gpt-image-1.5" وoutputFormat: "png" أو "webp" و background: "transparent"؛ ولا يزال خيار المزوّد الأقدم openai.background مقبولاً. يحمي OpenClaw أيضاً مسارات OpenAI العامة ومسارات OAuth الخاصة بـ OpenAI Codex عبر إعادة كتابة طلبات الشفافية الافتراضية openai/gpt-image-2 إلى gpt-image-1.5؛ أما Azure ونقاط النهاية المخصصة المتوافقة مع OpenAI فتحتفظ بأسماء النشر/النماذج المضبوطة لها.

يُعرَض الإعداد نفسه لتشغيلات CLI بلا واجهة:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "A simple red circle sticker on a transparent background" \  --json

استخدم عَلَمَي --output-format و--background نفسيهما مع openclaw infer image edit عند البدء من ملف إدخال. يبقى --openai-background متاحاً كاسم بديل خاص بـ OpenAI. استخدم --quality low|medium|high|auto عندما تحتاج إلى التحكم في جودة OpenAI Images وتكلفتها. استخدم --openai-moderation low|auto لتمرير تلميح الإشراف الخاص بالمزوّد في OpenAI من image generate أو image edit.

لتثبيتات ChatGPT/Codex OAuth، أبقِ مرجع openai/gpt-image-2 نفسه. عندما يكون ملف تعريف OAuth لـ openai مضبوطاً، يحل OpenClaw رمز وصول OAuth المخزّن ويرسل طلبات الصور عبر الواجهة الخلفية Codex Responses. ولا يحاول أولاً استخدام OPENAI_API_KEY أو الرجوع بصمت إلى مفتاح API لذلك الطلب. اضبط models.providers.openai صراحةً باستخدام مفتاح API أو عنوان URL أساسي مخصص أو نقطة نهاية Azure عندما تريد مسار OpenAI Images API المباشر بدلاً من ذلك. إذا كانت نقطة نهاية الصور المخصصة هذه على عنوان LAN/خاص موثوق، فاضبط أيضاً browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true؛ إذ يبقي OpenClaw نقاط نهاية الصور الخاصة/الداخلية المتوافقة مع OpenAI محظورة ما لم يكن هذا الاشتراك الصريح موجوداً.

توليد:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

توليد PNG شفاف:

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

تحرير:

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

توليد الفيديو

يسجّل Plugin openai المضمّن توليد الفيديو عبر أداة video_generate.

تستخدم طلبات OpenAI من الصورة إلى الفيديو POST /v1/videos مع input_reference لصورة. وتستخدم تحريرات الفيديو الواحد POST /v1/videos/edits مع الفيديو المرفوع في الحقل video.

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

مساهمة مطالبة GPT-5

يضيف OpenClaw مساهمة مطالبة GPT-5 مشتركة لتشغيلات عائلة GPT-5 على أسطح المطالبات التي يجمّعها OpenClaw. تُطبَّق حسب معرّف النموذج، لذلك تتلقى مسارات OpenClaw/المزوّد مثل المراجع القديمة قبل الإصلاح (مرجع Codex GPT-5.5 القديم)، وopenrouter/openai/gpt-5.5، وopencode/gpt-5.5، ومراجع GPT-5 المتوافقة الأخرى، الطبقة نفسها. ولا تحصل نماذج GPT-4.x الأقدم عليها.

لا يتلقى حزام Codex الأصلي المضمّن طبقة OpenClaw GPT-5 هذه عبر تعليمات المطوّر لخادم تطبيق Codex. يحتفظ Codex الأصلي بسلوك الأساس والنموذج ومستندات المشروع المملوك لـ Codex، بينما يعطّل OpenClaw الشخصية المدمجة في Codex للخيوط الأصلية بحيث تبقى ملفات شخصية مساحة عمل الوكيل هي المرجع الحاكم. لا يساهم OpenClaw إلا بسياق وقت التشغيل مثل تسليم القنوات، وأدوات OpenClaw الديناميكية، وتفويض ACP، وسياق مساحة العمل، وSkills في OpenClaw.

تضيف مساهمة GPT-5 عقد سلوك موسوماً لاستمرار الشخصية، وسلامة التنفيذ، وانضباط الأدوات، وشكل الإخراج، وفحوصات الاكتمال، والتحقق على مطالبات OpenClaw المجمّعة المطابقة. يبقى سلوك الرد الخاص بالقناة والرسائل الصامتة في مطالبة نظام OpenClaw المشتركة وسياسة التسليم الصادر. طبقة أسلوب التفاعل الودّي منفصلة وقابلة للضبط.

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

الصوت والكلام

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "openai",            model: "gpt-4o-transcribe",          },        ],      },    },  },}

نقاط نهاية Azure OpenAI

يمكن لموفر openai المضمن استهداف مورد Azure OpenAI لتوليد الصور عن طريق تجاوز عنوان URL الأساسي. في مسار توليد الصور، يكتشف OpenClaw أسماء مضيف Azure على models.providers.openai.baseUrl ويتحول إلى شكل طلب Azure تلقائيًا.

استخدم Azure OpenAI عندما:

• تكون لديك بالفعل اشتراك Azure OpenAI أو حصة أو اتفاقية مؤسسية
• تحتاج إلى إقامة بيانات إقليمية أو ضوابط امتثال توفرها Azure
• تريد إبقاء الحركة داخل مستأجر Azure موجود

الإعدادات

لتوليد الصور عبر Azure من خلال موفر openai المضمن، وجّه models.providers.openai.baseUrl إلى مورد Azure الخاص بك واضبط apiKey على مفتاح Azure OpenAI (وليس مفتاح منصة OpenAI):

{  models: {    providers: {      openai: {        baseUrl: "https://<your-resource>.openai.azure.com",        apiKey: "<azure-openai-api-key>",      },    },  },}

يتعرف OpenClaw على لواحق مضيف Azure التالية لمسار توليد الصور في Azure:

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

لطلبات توليد الصور على مضيف Azure معروف، يقوم OpenClaw بما يلي:

• يرسل ترويسة api-key بدلًا من Authorization: Bearer
• يستخدم مسارات محددة بنطاق النشر (/openai/deployments/{deployment}/...)
• يضيف ?api-version=... إلى كل طلب
• يستخدم مهلة طلب افتراضية قدرها 600 ثانية لاستدعاءات توليد الصور في Azure. تظل قيم timeoutMs لكل استدعاء تتجاوز هذا الافتراضي.

تحتفظ عناوين URL الأساسية الأخرى (OpenAI العام، والوكلاء المتوافقون مع OpenAI) بشكل طلب الصور القياسي في OpenAI.

إصدار API

اضبط AZURE_OPENAI_API_VERSION لتثبيت إصدار Azure معاينة أو عام محدد لمسار توليد الصور في Azure:

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

القيمة الافتراضية هي 2024-12-01-preview عندما لا يكون المتغير معيّنًا.

أسماء النماذج هي أسماء النشر

يربط Azure OpenAI النماذج بعمليات النشر. بالنسبة لطلبات توليد الصور في Azure الموجهة عبر موفر openai المضمن، يجب أن يكون حقل model في OpenClaw هو اسم نشر Azure الذي هيأته في بوابة Azure، وليس معرّف نموذج OpenAI العام.

إذا أنشأت نشرًا باسم gpt-image-2-prod يقدم gpt-image-2:

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

تنطبق قاعدة اسم النشر نفسها على استدعاءات توليد الصور الموجهة عبر موفر openai المضمن.

التوافر الإقليمي

يتوفر توليد الصور في Azure حاليًا في مجموعة فرعية فقط من المناطق (على سبيل المثال eastus2، وswedencentral، وpolandcentral، وwestus3، وuaenorth). تحقق من قائمة مناطق Microsoft الحالية قبل إنشاء نشر، وتأكد من أن النموذج المحدد متاح في منطقتك.

اختلافات المعلمات

لا يقبل Azure OpenAI وOpenAI العام دائمًا معلمات الصور نفسها. قد يرفض Azure خيارات يسمح بها OpenAI العام (على سبيل المثال بعض قيم background في gpt-image-2) أو لا يعرضها إلا في إصدارات نماذج محددة. تأتي هذه الاختلافات من Azure والنموذج الأساسي، وليس من OpenClaw. إذا فشل طلب Azure بخطأ تحقق، فتحقق من مجموعة المعلمات التي يدعمها النشر المحدد وإصدار API لديك في بوابة Azure.

الإعدادات المتقدمة

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { serviceTier: "priority" } },      },    },  },}

{  agents: {    defaults: {      models: {        "azure-openai-responses/gpt-5.5": {          params: { responsesServerCompaction: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 120000,          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}

{  agents: {    defaults: {      embeddedAgent: { executionContract: "strict-agentic" },    },  },}

ذو صلة