​

OpenAI

​

نمط التفاعل الافتراضي

• "friendly": الافتراضي؛ يفعّل التراكب الخاص بـ OpenAI.
• "on": اسم مستعار لـ "friendly".
• "off": يعطّل التراكب ويستخدم توجيه OpenClaw الأساسي فقط.

• ينطبق على نماذج openai/*.
• ينطبق على نماذج openai-codex/*.
• لا يؤثر في الموفّرين الآخرين.

{
  plugins: {
    entries: {
      openai: {
        config: {
          personality: "friendly",
        },
      },
    },
  },
}

​

تعطيل تراكب توجيه OpenAI

{
  plugins: {
    entries: {
      openai: {
        config: {
          personality: "off",
        },
      },
    },
  },
}

openclaw config set plugins.entries.openai.config.personality off

​

الخيار A: مفتاح OpenAI API (OpenAI Platform)

• openai/gpt-5.4 = مسار OpenAI Platform API مباشر
• يتطلب OPENAI_API_KEY (أو إعداد موفّر OpenAI مكافئ)
• في OpenClaw، يتم توجيه تسجيل الدخول إلى ChatGPT/Codex عبر openai-codex/* وليس openai/*

​

إعداد CLI

openclaw onboard --auth-choice openai-api-key
# أو بدون تفاعل
openclaw onboard --openai-api-key "$OPENAI_API_KEY"

​

مقتطف إعدادات

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.4" } } },
}

​

توليد الصور

• نموذج الصور الافتراضي: openai/gpt-image-1
• التوليد: حتى 4 صور لكل طلب
• وضع التعديل: مفعّل، حتى 5 صور مرجعية
• يدعم size
• ملاحظة حالية خاصة بـ OpenAI: لا يمرّر OpenClaw حاليًا تجاوزات aspectRatio أو resolution إلى OpenAI Images API

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

​

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

• نموذج الفيديو الافتراضي: openai/sora-2
• الأوضاع: من نص إلى فيديو، ومن صورة إلى فيديو، وتدفقات مرجعية/تحرير لفيديو واحد
• الحدود الحالية: صورة واحدة أو مرجع فيديو واحد
• ملاحظة حالية خاصة بـ OpenAI: يمرّر OpenClaw حاليًا فقط تجاوزات size لتوليد الفيديو الأصلي في OpenAI. أما التجاوزات الاختيارية غير المدعومة مثل aspectRatio وresolution وaudio وwatermark فيتم تجاهلها والإبلاغ عنها كتحذير أداة.

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

​

الخيار B: اشتراك OpenAI Code (Codex)

• openai-codex/gpt-5.4 = مسار ChatGPT/Codex OAuth
• يستخدم تسجيل الدخول إلى ChatGPT/Codex، وليس مفتاح OpenAI Platform API مباشرًا
• قد تختلف الحدود من جهة الموفّر لـ openai-codex/* عن تجربة ChatGPT على الويب/التطبيق

​

إعداد CLI ‏(Codex OAuth)

# شغّل Codex OAuth في المعالج
openclaw onboard --auth-choice openai-codex

# أو شغّل OAuth مباشرة
openclaw models auth login --provider openai-codex

​

مقتطف إعدادات (اشتراك Codex)

{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.4" } } },
}

• openai-codex/gpt-5.3-codex-spark

​

حد نافذة سياق Codex

• contextWindow الأصلي: 1050000
• الحد الافتراضي لوقت التشغيل contextTokens: 272000

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

​

النقل الافتراضي

• "sse": فرض SSE
• "websocket": فرض WebSocket
• "auto": جرّب WebSocket، ثم تحوّل احتياطيًا إلى SSE

• Realtime API with WebSocket
• Streaming API responses (SSE)

{
  agents: {
    defaults: {
      model: { primary: "openai-codex/gpt-5.4" },
      models: {
        "openai-codex/gpt-5.4": {
          params: {
            transport: "auto",
          },
        },
      },
    },
  },
}

​

إحماء OpenAI WebSocket

​

تعطيل الإحماء

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: false,
          },
        },
      },
    },
  },
}

​

تفعيل الإحماء صراحةً

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            openaiWsWarmup: true,
          },
        },
      },
    },
  },
}

​

OpenAI وCodex والمعالجة ذات الأولوية

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

• يجب أن يستهدف openai/* المباشر api.openai.com
• يجب أن يستهدف openai-codex/* ‏chatgpt.com/backend-api
• إذا قمت بتوجيه أي من الموفّرين عبر base URL آخر أو proxy، فإن OpenClaw يترك service_tier من دون تعديل

​

وضع OpenAI السريع

• Chat/UI: ‏/fast status|on|off
• Config: ‏agents.defaults.models["<provider>/<model>"].params.fastMode

• ترسل استدعاءات Responses المباشرة من openai/* إلى api.openai.com القيمة service_tier = "priority"
• وترسل استدعاءات Responses من openai-codex/* إلى chatgpt.com/backend-api أيضًا القيمة service_tier = "priority"
• يتم الحفاظ على قيم service_tier الموجودة في الحمولة
• لا يعيد الوضع السريع كتابة reasoning أو text.verbosity

• إرسال /fast on في جلسة تستخدم openai/gpt-5.4 أو openai-codex/gpt-5.4
• أو ضبط agents.defaults.models["openai/gpt-5.4"].params.fastMode = true
• وإذا كنت تستخدم Codex OAuth أيضًا، فاضبط agents.defaults.models["openai-codex/gpt-5.4"].params.fastMode = true أيضًا

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.4": {
          params: {
            fastMode: true,
          },
        },
        "openai-codex/gpt-5.4": {
          params: {
            fastMode: true,
          },
        },
      },
    },
  },
}

​

مسارات Native OpenAI مقابل المسارات المتوافقة مع OpenAI

• تحافظ المسارات الأصلية openai/* وopenai-codex/* ومسارات Azure OpenAI على reasoning: { effort: "none" } كما هو عندما تعطل reasoning صراحةً
• تجعل مسارات عائلة OpenAI الأصلية مخططات الأدوات في الوضع الصارم افتراضيًا
• لا تُرفق رؤوس الإسناد المخفية الخاصة بـ OpenClaw (originator وversion و User-Agent) إلا على مضيفي OpenAI الأصليين المؤكدين (api.openai.com) ومضيفي Codex الأصليين (chatgpt.com/backend-api)
• تحتفظ مسارات Native OpenAI/Codex بتشكيل الطلبات الخاص بـ OpenAI فقط مثل service_tier، وstore الخاصة بـ Responses، والحمولات المتوافقة مع OpenAI reasoning، وتلميحات cache الخاصة بالتوجيه
• تحتفظ المسارات المتوافقة مع OpenAI على نمط proxy بسلوك التوافق الأكثر مرونة، ولا تفرض مخططات أدوات صارمة، أو تشكيل طلبات خاص بالأصل، أو رؤوس إسناد OpenAI/Codex المخفية

​

الضغط من جهة الخادم في OpenAI Responses

• يفرض store: true (إلا إذا ضبط توافق النموذج supportsStore: false)
• ويحقن context_management: [{ type: "compaction", compact_threshold: ... }]

​

تفعيل الضغط من جهة الخادم صراحةً

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

​

التفعيل مع عتبة مخصصة

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

​

تعطيل الضغط من جهة الخادم

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

​

ملاحظات

• تستخدم مراجع النماذج دائمًا الصيغة provider/model (راجع /concepts/models).
• توجد تفاصيل المصادقة + قواعد إعادة الاستخدام في /concepts/oauth.