OpenAI

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

​

تتبّع الاستخدام والتكلفة

• يعرض OAuth الخاص بـ ChatGPT/Codex خطة الاشتراك ونوافذ الحصة ورصيد الاعتمادات.
• يعرض OPENAI_ADMIN_KEY مدة 30 يومًا من تكلفة المؤسسة واستخدام الإكمالات اللذين أبلغ عنهما المزوّد في الاستخدام ضمن واجهة التحكم، بما في ذلك الإنفاق اليومي وإجماليات الطلبات/الرموز المميزة وأبرز النماذج وفئات التكلفة.
• يقيّد OPENAI_PROJECT_ID اختياريًا سجل Admin API بمشروع واحد.
• لا يرسل OpenClaw مطلقًا OPENAI_API_KEY أو ملف تعريف استدلال openai إلى واجهات API الخاصة بالمؤسسة؛ فقد تخص بيانات الاعتماد هذه نقاط نهاية مخصصة أو Azure أو نقاط نهاية محلية للوكيل.

​

اختيار سريع

​

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

​

وقت تشغيل الوكيل الضمني

​

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

openclaw models list --provider openai

openclaw models set openai/gpt-5.5

​

تغطية ميزات OpenClaw

​

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

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

​

بدء الاستخدام

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.6" } } },
}

{
  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.6-sol

openclaw models list --provider openai

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

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

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

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

openclaw doctor --fix
openclaw config validate

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

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

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

​

مصادقة خادم تطبيق Codex الأصلي

1. ملفات تعريف مصادقة OpenAI المرتبة للوكيل، ويُفضّل أن تكون ضمن auth.order.openai. شغّل openclaw doctor --fix لترحيل معرّفات ملفات تعريف مصادقة Codex القديمة وترتيب المصادقة.
2. الحساب الموجود في خادم التطبيق، مثل تسجيل دخول ChatGPT محلي عبر Codex CLI. بالنسبة إلى مجلد الوكيل المعزول الافتراضي، يصل OpenClaw حساب CLI الأصلي هذا بخادم التطبيق عبر RPC لتسجيل الدخول؛ ولا يشارك إعدادات CLI أو plugins الخاصة به أو مخزن سلاسل المحادثات.
3. لتشغيل خادم التطبيق محليًا عبر stdio فقط، وفقط عندما يبلغ خادم التطبيق عن عدم وجود حساب: CODEX_API_KEY، ثم OPENAI_API_KEY.

​

توليد الصور

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

openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "ملصق دائرة حمراء بسيط على خلفية شفافة" \
  --json

/tool image_generate model=openai/gpt-image-2 prompt="ملصق إطلاق مصقول لـ OpenClaw على macOS" size=3840x2160 count=1

/tool image_generate model=openai/gpt-image-1.5 prompt="ملصق دائرة حمراء بسيط على خلفية شفافة" outputFormat=png background=transparent

/tool image_generate model=openai/gpt-image-2 prompt="حافظ على شكل العنصر، وغيّر مادته إلى زجاج شفاف جزئيًا" image=/path/to/reference.png size=1024x1536

​

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

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

​

مساهمة موجّه GPT-5

{
  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

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

​

الإعداد

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

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

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

​

إصدار API

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

​

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

/tool image_generate model=openai/gpt-image-2-prod prompt="ملصق أنيق" size=1024x1024 count=1

​

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

​

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

​

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

{
  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: "default" },
    },
  },
}

​

ذو صلة