Providers

OpenAI

OpenClaw از یک شناسه ارائه‌دهنده، openai، هم برای احراز هویت مستقیم با کلید API و هم برای احراز هویت اشتراک ChatGPT/Codex استفاده می‌کند. openai/* مسیر متعارف مدل است. برای نوبت‌های عامل تعبیه‌شده که خط‌مشی زمان اجرا تنظیم نشده یا auto است، مشخصات مسیر OpenAI تعیین می‌کنند که آیا OpenClaw می‌تواند زمان اجرای همراهِ app-server مربوط به Codex را به‌طور ضمنی انتخاب کند یا نه. پیشوند openai/* به‌تنهایی زمان اجرا را انتخاب نمی‌کند.

  • مدل‌های عامل - openai/* از طریق زمان اجرایی که با پیکربندی صریح agentRuntime یا خط‌مشی ضمنی مسیر OpenAI انتخاب شده است. برای استفاده از اشتراک ChatGPT/Codex با احراز هویت Codex وارد شوید، یا هنگامی که صورت‌حساب مبتنی بر کلید می‌خواهید، یک نمایه احراز هویت با کلید API پیکربندی کنید.
  • APIهای غیرعاملی OpenAI - دسترسی مستقیم به OpenAI Platform، با صورت‌حساب به‌ازای مصرف، از طریق OPENAI_API_KEY یا یک نمایه احراز هویت با کلید API به نام openai.
  • پیکربندی قدیمی - ارجاع‌های codex/* و openai-codex/* به openai/* به‌همراه agentRuntime.id: "codex" در سطح مدل، توسط openclaw doctor --fix اصلاح می‌شوند.

OpenAI صراحتاً از استفاده از OAuth اشتراک در ابزارهای خارجی و گردش‌کارهایی مانند OpenClaw پشتیبانی می‌کند.

رهگیری مصرف و هزینه

OpenClaw سهمیه اشتراک و صورت‌حساب API پلتفرم را از هم متمایز نگه می‌دارد:

  • OAuth مربوط به ChatGPT/Codex طرح اشتراک، بازه‌های سهمیه و مانده اعتبار را نشان می‌دهد.
  • OPENAI_ADMIN_KEY در بخش مصرف رابط کنترل، 30 روز از هزینه سازمان و مصرف تکمیل‌ها را طبق گزارش ارائه‌دهنده نشان می‌دهد؛ از جمله هزینه روزانه، مجموع درخواست‌ها/توکن‌ها، مدل‌های برتر و دسته‌های هزینه.
  • OPENAI_PROJECT_ID در صورت تمایل، تاریخچه Admin API را به یک پروژه محدود می‌کند.
  • OpenClaw هرگز OPENAI_API_KEY یا یک نمایه استنتاج openai را به APIهای سازمان ارسال نمی‌کند؛ این اعتبارنامه‌ها ممکن است متعلق به نقاط پایانی سفارشی، Azure یا محلیِ عامل باشند.

یک کلید صریح Admin بر OAuth اولویت دارد. تاریخچه گزارش‌شده توسط ارائه‌دهنده با هزینه تخمینی مشتق‌شده از نشست‌های OpenClaw ادغام نمی‌شود؛ این تاریخچه می‌تواند فعالیت API از سرویس‌گیرنده‌های دیگر و تعدیلات صورت‌حساب سمت ارائه‌دهنده را نیز شامل شود.

مستندات داشبورد مصرف API متعلق به OpenAI، الزامات مالک سازمان و مجوز صریح Usage Dashboard را برای داده‌های مصرف شرح می‌دهد.

ارائه‌دهنده، مدل، زمان اجرا و کانال، لایه‌هایی جداگانه هستند. اگر این برچسب‌ها با هم اشتباه گرفته می‌شوند، پیش از تغییر پیکربندی، زمان‌های اجرای عامل را بخوانید.

انتخاب سریع

هدف استفاده نکات
اشتراک ChatGPT/Codex، زمان اجرای بومی Codex openai/gpt-5.6-sol راه‌اندازی تازه اشتراک؛ با احراز هویت Codex وارد شوید.
صورت‌حساب مستقیم با کلید API برای نوبت‌های عامل openai/gpt-5.6 به‌همراه یک نمایه مرتب‌شده احراز هویت با کلید API راه‌اندازی تازه کلید API؛ شناسه ساده API مستقیم به Sol نگاشت می‌شود.
انتخاب یک رده دقیق GPT-5.6 openai/gpt-5.6-sol، -terra یا -luna برای رده‌های در دسترس این حساب، models list را بررسی کنید.
حساب بدون دسترسی به GPT-5.6 openai/gpt-5.5 انتخاب صریح بازیابی؛ OpenClaw بی‌سروصدا نسخه را پایین نمی‌آورد.
صورت‌حساب مستقیم با کلید API، زمان اجرای صریح OpenClaw openai/gpt-5.6 به‌همراه agentRuntime.id: "openclaw" ارائه‌دهنده/مدل یک نمایه عادی کلید API از نوع openai انتخاب کنید.
جدیدترین نام مستعار مدل ChatGPT Instant openai/chat-latest فقط API مستقیم با کلید؛ نام مستعاری متغیر است، نه پیش‌فرض پایدار.
تولید یا ویرایش تصویر openai/gpt-image-2 با OPENAI_API_KEY یا OAuth مربوط به Codex کار می‌کند.
تصاویر با پس‌زمینه شفاف openai/gpt-image-1.5 outputFormat را روی png یا webp و background=transparent تنظیم کنید.

نگاشت نام‌ها

نامی که می‌بینید لایه معنا
openai پیشوند ارائه‌دهنده مسیر متعارف مدل OpenAI؛ مشخصات مسیر، زمان اجرای ضمنی را تعیین می‌کنند.
Plugin مربوط به codex Plugin Plugin همراهی که زمان اجرای بومی app-server مربوط به Codex و کنترل‌های گفت‌وگوی /codex را فراهم می‌کند.
agentRuntime.id: codex ارائه‌دهنده/مدل زمان اجرای عامل برای نوبت‌های تعبیه‌شده منطبق، مهار بومی app-server مربوط به Codex را اجباری می‌کند.
/codex ... مجموعه فرمان گفت‌وگو رشته‌های app-server مربوط به Codex را از داخل یک مکالمه متصل/کنترل می‌کند.
runtime: "acp", agentId: "codex" مسیر نشست ACP مسیر جایگزین صریحی که Codex را از طریق ACP/acpx اجرا می‌کند.

زمان اجرای ضمنی عامل

وقتی خط‌مشی agentRuntime ارائه‌دهنده/مدل تنظیم نشده یا auto است، خط‌مشی مسیر متعلق به ارائه‌دهنده OpenAI، زمان اجرای ضمنی را بر اساس نقطه پایانی و آداپتور مؤثر انتخاب می‌کند:

مشخصات مسیر مؤثر زمان اجرای ضمنی
نقطه پایانی HTTPS رسمی و دقیق Platform با openai-responses، یا نقطه پایانی HTTPS رسمی و دقیق ChatGPT با openai-chatgpt-responses؛ بدون بازنویسی تألیفی درخواست ممکن است Codex انتخاب شود
آداپتور تألیفی openai-completions OpenClaw
نقطه پایانی سفارشی OpenClaw
نقطه پایانی رسمی و دقیقِ صریح با استفاده از HTTP رد می‌شود
مسیری با بازنویسی تألیفی درخواست ارائه‌دهنده/مدل OpenClaw

یک agentRuntime.id صریح و غیراستاندارد برای ارائه‌دهنده/مدل همچنان مرجع نهایی است. برای مثال، agentRuntime.id: "openclaw" مسیری را که در حالت عادی واجد شرایط Codex است روی OpenClaw نگه می‌دارد، درحالی‌که agentRuntime.id: "codex" به Codex نیاز دارد و اگر مسیر مؤثر سازگار با Codex اعلام نشده باشد، به‌صورت بسته شکست می‌خورد. انتخاب زمان اجرا نوع اعتبارنامه یا صورت‌حساب را تغییر نمی‌دهد: احراز هویت با کلید API پلتفرم و احراز هویت اشتراک ChatGPT/Codex همچنان متمایز می‌مانند.

openclaw doctor --fix ارجاع‌های مدل قدیمی codex/* و openai-codex/*، شناسه‌های قدیمی نمایه احراز هویت Codex و ورودی‌های قدیمی ترتیب احراز هویت Codex را به مسیر متعارف openai مهاجرت می‌دهد. ارجاع‌های مدل مهاجرت‌یافته، agentRuntime.id: "codex" در سطح مدل دریافت می‌کنند؛ برای پیکربندی جدید ترتیب احراز هویت از auth.order.openai استفاده کنید.

پیش‌نمایش محدود GPT-5.6

OpenClaw شناسه‌های دقیق مدل openai/gpt-5.6-sol، openai/gpt-5.6-terra و openai/gpt-5.6-luna را تشخیص می‌دهد. هر سه در کاتالوگ فعلی، استدلال xhigh و max را ارائه می‌کنند. OpenAI، Sol را رده پرچم‌دار، Terra را رده متعادل و Luna را رده سریع و کم‌هزینه‌تر توصیف می‌کند. اعلامیه عرضه GPT-5.6 و راهنمای دسترسی را ببینید.

با احراز هویت مستقیم کلید API مربوط به OpenAI، شناسه ساده openai/gpt-5.6 نام مستعاری برای Sol و پیش‌فرض راه‌اندازی تازه است. کاتالوگ بومی Codex آن نام مستعار API مستقیم را در سمت سرویس‌گیرنده اعمال نمی‌کند؛ بسته به دسترسی فضای کاری، ممکن است شناسه‌های دقیق Sol، Terra و Luna را نشان دهد. بنابراین راه‌اندازی تازه OAuth مربوط به ChatGPT/Codex از openai/gpt-5.6-sol استفاده می‌کند. حساب فعلی را با این فرمان بررسی کنید:

bash
openclaw models list --provider openai

دسترسی سازمان API و فضای کاری Codex می‌توانند متفاوت باشند. اگر GPT-5.6 در دسترس نیست، GPT-5.5 را صراحتاً انتخاب کنید:

bash
openclaw models set openai/gpt-5.5

OpenClaw خطای دسترسی بالادستی را نمایش می‌دهد و انتخاب GPT-5.6 را بی‌سروصدا با GPT-5.5 جایگزین نمی‌کند.

پوشش قابلیت‌های OpenClaw

قابلیت OpenAI سطح OpenClaw وضعیت
چت / پاسخ‌ها ارائه‌دهنده مدل openai/<model> بله
مدل‌های اشتراک Codex openai/<model> با OAuth متعلق به OpenAI بله
ارجاع‌های مدل قدیمی Codex ارجاع‌های قدیمی مدل Codex، codex-cli/<model> توسط doctor به openai/<model> اصلاح می‌شود
مهار اجرای app-server متعلق به Codex مسیر HTTPS سازگار با Codex با runtime تنظیم‌نشده/auto، یا agentRuntime.id: codex صریح بله
جست‌وجوی وب سمت سرور ابزار بومی Responses متعلق به OpenAI بله، هنگامی که جست‌وجوی وب فعال باشد و ارائه‌دهنده دیگری پین نشده باشد
تصاویر image_generate بله
ویدئوها video_generate بله
تبدیل متن به گفتار tts.provider: "openai" / tts بله
تبدیل دسته‌ای گفتار به متن tools.media.audio / درک رسانه بله
تبدیل جریانی گفتار به متن Voice Call streaming.provider: "openai" بله
صدای بلادرنگ Voice Call realtime.provider: "openai" / گفت‌وگوی Control UI talk.realtime.provider: "openai" بله (کلید API پلتفرم OpenAI)
تعبیه‌ها ارائه‌دهنده تعبیه حافظه بله

تعبیه‌های حافظه

OpenClaw می‌تواند از OpenAI یا یک نقطه پایانی تعبیه سازگار با OpenAI برای نمایه‌سازی memory_search و تعبیه‌های پرس‌وجو استفاده کند:

json5
{  memory: {    search: {      provider: "openai",      model: "text-embedding-3-small",    },  },}

برای نقاط پایانی سازگار با OpenAI که به برچسب‌های تعبیه نامتقارن نیاز دارند، queryInputType و documentInputType را زیر memory.search تنظیم کنید. OpenClaw این موارد را به‌عنوان فیلدهای درخواست input_type ویژه ارائه‌دهنده ارسال می‌کند: تعبیه‌های پرس‌وجو از queryInputType استفاده می‌کنند؛ قطعه‌های نمایه‌شده حافظه و نمایه‌سازی دسته‌ای از documentInputType استفاده می‌کنند. برای نمونه کامل، به مرجع پیکربندی حافظه مراجعه کنید.

شروع به کار

کلید API (پلتفرم OpenAI)

بهترین گزینه برای: دسترسی مستقیم به API و صورت‌حساب مبتنی بر میزان استفاده.

  • کلید API خود را دریافت کنید

    یک کلید API را از داشبورد پلتفرم OpenAI ایجاد یا کپی کنید.

  • راه‌اندازی اولیه را اجرا کنید

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

    یا کلید را مستقیماً ارسال کنید:

    bash
    openclaw onboard --openai-api-key "$OPENAI_API_KEY"
  • در دسترس بودن مدل را تأیید کنید

    bash
    openclaw models list --provider openai
  • خلاصه مسیر

    ارجاع مدل سیاست runtime یا واقعیت‌های مسیر مسیر احراز هویت
    openai/gpt-5.6 تنظیم‌نشده/auto، مسیر بومی HTTPS رسمی و دقیق، بدون بازنویسی درخواست ممکن است Codex انتخاب شود پروفایل احراز هویت مرتب‌شده کلید API
    openai/gpt-5.6 ارائه‌دهنده/مدل agentRuntime.id: "openclaw" runtime توکار OpenClaw پروفایل کلید API ‏openai انتخاب‌شده
    openai/gpt-5.5 ارائه‌دهنده/مدل صریح agentRuntime.id runtime عامل انتخاب‌شده پروفایل کلید API ‏OpenAI انتخاب‌شده
    openai/* Completions تألیفی، سفارشی یا بازنویسی درخواست runtime توکار OpenClaw نوع اعتبارنامه بدون تغییر باقی می‌ماند
    openai/* نقطه پایانی رسمی HTTP با متن ساده رد می‌شود اعتبارنامه ارسال نمی‌شود

    نمونه پیکربندی

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

    شناسه بدون پیشوند API مستقیم gpt-5.6 به سطح Sol نگاشت می‌شود. اگر این سازمان API به GPT-5.6 دسترسی ندارد، مدل اصلی را صراحتاً روی openai/gpt-5.5 تنظیم کنید.

    برای امتحان کردن مدل فعلی Instant متعلق به ChatGPT از طریق API ‏OpenAI، مدل را روی openai/chat-latest تنظیم کنید:

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

    chat-latest یک نام مستعار متغیر است. راه‌اندازی جدید با کلید API ‏OpenAI در عوض از openai/gpt-5.6 استفاده می‌کند که شناسه بدون پیشوند API مستقیم آن به Sol نگاشت می‌شود. مدل‌های اصلی صریح موجود، از جمله openai/gpt-5.5، بدون تغییر باقی می‌مانند. نام مستعار chat-latest فقط پرگویی متن medium را می‌پذیرد؛ OpenClaw هر پرگویی درخواستی دیگری را برای این مدل به medium اجبار می‌کند.

    اشتراک Codex

    بهترین گزینه برای: استفاده از اشتراک ChatGPT/Codex با اجرای بومی app-server متعلق به Codex به‌جای یک کلید API جداگانه. ابر Codex به ورود به ChatGPT نیاز دارد.

  • OAuth متعلق به Codex را اجرا کنید

    bash
    openclaw onboard --auth-choice openai

    یا OAuth را مستقیماً اجرا کنید:

    bash
    openclaw models auth login --provider openai

    برای راه‌اندازی‌های بدون رابط گرافیکی یا ناسازگار با callback، ‏--device-code را اضافه کنید تا به‌جای callback مرورگر localhost، با جریان کد دستگاه ChatGPT وارد شوید:

    bash
    openclaw models auth login --provider openai --device-code
  • از مسیر متعارف مدل OpenAI استفاده کنید

    bash
    openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol

    برای این مسیر بومی HTTPS رسمی و دقیق، هیچ پیکربندی runtime لازم نیست. این مسیر ممکن است runtime متعلق به app-server مربوط به Codex را به‌طور خودکار انتخاب کند و OpenClaw هنگام انتخاب آن runtime، ‏Plugin همراه Codex را نصب یا اصلاح می‌کند.

  • در دسترس بودن احراز هویت Codex را تأیید کنید

    bash
    openclaw models list --provider openai

    پس از اجرای Gateway، ‏/codex status یا /codex models را در چت ارسال کنید تا runtime بومی app-server را تأیید کنید.

  • خلاصه مسیر

    ارجاع مدل سیاست runtime یا واقعیت‌های مسیر مسیر احراز هویت
    openai/gpt-5.6-sol تنظیم‌نشده/auto، مسیر بومی HTTPS رسمی و دقیق، بدون بازنویسی درخواست ممکن است Codex انتخاب شود ورود Codex یا یک پروفایل احراز هویت مرتب‌شده openai
    openai/gpt-5.6-terra تنظیم‌نشده/auto، مسیر بومی HTTPS رسمی و دقیق، بدون بازنویسی درخواست ممکن است Codex انتخاب شود ورود Codex هنگامی که کاتالوگ Terra را ارائه کند
    openai/gpt-5.6-luna تنظیم‌نشده/auto، مسیر بومی HTTPS رسمی و دقیق، بدون بازنویسی درخواست ممکن است Codex انتخاب شود ورود Codex هنگامی که کاتالوگ Luna را ارائه کند
    openai/gpt-5.6-sol ارائه‌دهنده/مدل agentRuntime.id: "openclaw" runtime توکار OpenClaw، انتقال داخلی احراز هویت Codex پروفایل OAuth ‏openai انتخاب‌شده
    openai/gpt-5.5 ارائه‌دهنده/مدل صریح agentRuntime.id runtime عامل انتخاب‌شده پروفایل احراز هویت OpenAI انتخاب‌شده
    openai/* Completions تألیفی، سفارشی یا بازنویسی درخواست runtime توکار OpenClaw الزام اعتبارنامه همچنان مختص مسیر باقی می‌ماند
    openai/* نقطه پایانی رسمی HTTP با متن ساده رد می‌شود اعتبارنامه ارسال نمی‌شود
    ارجاع قدیمی Codex GPT-5.5 توسط doctor اصلاح می‌شود به openai/gpt-5.5 بازنویسی می‌شود پروفایل OAuth ‏OpenAI مهاجرت‌یافته
    codex-cli/gpt-5.5 توسط doctor اصلاح می‌شود به openai/gpt-5.5 بازنویسی می‌شود احراز هویت app-server متعلق به Codex

    نمونه پیکربندی

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

    با یک پشتیبان کلید API، مدل انتخاب‌شده را زیر openai/* نگه دارید و ترتیب احراز هویت را زیر openai قرار دهید. OpenClaw ابتدا اشتراک و سپس کلید API را امتحان می‌کند، درحالی‌که روی چارچوب Codex باقی می‌ماند:

    json5
    {  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",      ],    },  },}

    بررسی و بازیابی مسیریابی OAuth ‏Codex

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

    برای یک عامل مشخص، --agent <id> را اضافه کنید:

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

    اگر یک پیکربندی قدیمی هنوز ارجاع‌های قدیمی Codex GPT یا یک پین نشست زمان‌اجرای منسوخ OpenAI بدون پیکربندی صریح زمان‌اجرا دارد، آن را تعمیر کنید:

    bash
    openclaw doctor --fixopenclaw config validate

    اگر models auth list --provider openai هیچ نمایه قابل‌استفاده‌ای نشان نمی‌دهد، دوباره وارد شوید:

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

    برای چند ورود OAuth ‏Codex در یک عامل از --profile-id استفاده کنید، سپس آن‌ها را از طریق ترتیب احراز هویت یا /model ...@<profileId> کنترل کنید:

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

    برای مهاجرت شناسه‌های نمایه و ورودی‌های ترتیب با پیشوند قدیمی OpenAI Codex، پیش از اتکا به ترتیب نمایه‌ها openclaw doctor --fix را اجرا کنید.

    نشانگر وضعیت

    /status در گفت‌وگو نشان می‌دهد کدام زمان‌اجرای مدل برای نشست کنونی فعال است. چارچوب app-server همراه Codex زمانی به‌شکل Runtime: OpenAI Codex ظاهر می‌شود که یک مسیر ضمنی واجد شرایط یا سیاست صریح زمان‌اجرای ارائه‌دهنده/مدل آن را انتخاب کند.

    هشدار Doctor

    اگر ارجاع‌های قدیمی مدل Codex یا پین‌های منسوخ زمان‌اجرای OpenAI در پیکربندی یا وضعیت نشست باقی مانده باشند، openclaw doctor --fix آن‌ها را با زمان‌اجرای Codex به openai/* بازنویسی می‌کند، مگر اینکه OpenClaw صراحتاً پیکربندی شده باشد.

    پیش‌فرض‌های پنجره زمینه و انتخاب اختیاری زمینه طولانی

    OpenClaw ظرفیت بومی مدل و بودجه فعال زمان‌اجرا را مقادیری جداگانه در نظر می‌گیرد:

    • contextWindow کل پنجره مدل ارائه‌دهنده را اعلام می‌کند.
    • contextTokens میزان استفاده OpenClaw از آن پنجره برای ورودی فعال را محدود می‌کند.

    OAuth ‏ChatGPT/Codex از کاتالوگ زنده حساب Codex پیروی می‌کند. کاتالوگ فعلی معمولاً یک پنجره فعال 272000 توکنی برای GPT-5.6 ارائه می‌دهد. مدل‌های مستقیم GPT-5.5 و GPT-5.6 با کلید API نیز به‌طور پیش‌فرض از 272000 contextTokens استفاده می‌کنند، هرچند Platform API پنجره بومی بزرگ‌تری ارائه می‌دهد. این کار مشخصات معمول تأخیر، کیفیت و هزینه را میان حالت‌های احراز هویت یکسان نگه می‌دارد. مقدار پیکربندی‌شده agents.defaults.contextTokens می‌تواند این بودجه را بیشتر کاهش دهد، اما نمی‌تواند مدلی را بالاتر از سقف پیکربندی‌شده contextTokens آن ببرد.

    برای GPT-5.5 و GPT-5.6 مستقیم با کلید API، ‏OpenAI یک پنجره 1050000 توکنی ارائه‌دهنده و حداکثر 128000 توکن خروجی را مستند کرده است. رزرو کامل ظرفیت خروجی، 922000 توکن برای ورودی باقی می‌گذارد. این یک بودجه عملیاتی محاسبه‌شده است، نه یک محدودیت ورودی جداگانه منتشرشده از سوی ارائه‌دهنده. به مقایسه مدل‌ها و صفحه مدل GPT-5.5 رسمی مراجعه کنید. نمونه زیر یک مدل Terra را برای استفاده از این ظرفیت فعال می‌کند و از OpenAI می‌خواهد در 700000 توکن فعال Compaction انجام دهد:

    json5
    {  models: {    providers: {      openai: {        models: [          {            id: "gpt-5.6-terra",            name: "GPT-5.6 Terra",            contextWindow: 1050000,            contextTokens: 922000,            maxTokens: 128000,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-terra" },      models: {        "openai/gpt-5.6-terra": {          agentRuntime: { id: "openclaw" },          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 700000,          },        },      },    },  },}

    agentRuntime.id: "openclaw" در این نمونه عمدی است. این ثابت می‌کند که مسیر تعبیه‌شده Responses در OpenClaw از فراداده مدل و تنظیمات Compaction سمت سرور در بالا استفاده می‌کند. در مقابل، یک رشته چارچوب بومی Codex بودجه زمینه‌اش را در پیکربندی Codex مدیریت می‌کند؛ به زمینه طولانی چارچوب Codex مراجعه کنید.

    بازیابی کاتالوگ

    OpenClaw در صورت وجود، از فراداده کاتالوگ بالادستی Codex برای gpt-5.5 استفاده می‌کند. اگر کشف زنده Codex درحالی‌که حساب احراز هویت شده است، ردیف gpt-5.5 را حذف کند، OpenClaw آن ردیف مدل OAuth را می‌سازد تا اجراهای Cron، عامل فرعی و مدل پیش‌فرض پیکربندی‌شده با Unknown model شکست نخورند.

    احراز هویت app-server بومی Codex

    چارچوب app-server بومی Codex زمانی از ارجاع‌های مدل openai/* استفاده می‌کند که یک مسیر رسمی HTTPS دقیق و واجد شرایط آن را به‌صورت ضمنی انتخاب کند، یا زمانی که agentRuntime.id: "codex" ارائه‌دهنده/مدل آن را صراحتاً انتخاب کند. احراز هویت آن همچنان بر پایه حساب است. OpenClaw احراز هویت را با این ترتیب انتخاب می‌کند:

    1. نمایه‌های احراز هویت مرتب‌شده OpenAI برای عامل، ترجیحاً زیر auth.order.openai. برای مهاجرت شناسه‌های قدیمی نمایه احراز هویت Codex و ترتیب احراز هویت، openclaw doctor --fix را اجرا کنید.
    2. حساب موجود app-server، مانند ورود محلی ChatGPT در Codex CLI. برای خانه عامل ایزوله پیش‌فرض، OpenClaw آن حساب بومی CLI را از طریق RPC ورود به app-server متصل می‌کند؛ پیکربندی، Plugin‌ها یا مخزن رشته‌های CLI را به‌اشتراک نمی‌گذارد.
    3. فقط برای اجرای محلی app-server با stdio و تنها زمانی که app-server هیچ حسابی گزارش نمی‌کند: CODEX_API_KEY، سپس OPENAI_API_KEY.

    ورود محلی اشتراک ChatGPT/Codex صرفاً به این دلیل جایگزین نمی‌شود که فرایند Gateway برای مدل‌ها یا تعبیه‌های مستقیم OpenAI نیز OPENAI_API_KEY دارد. بازگشت به کلید API محیطی فقط برای مسیر محلی stdio بدون حساب اعمال می‌شود؛ این کلید هرگز از طریق اتصال‌های app-server مبتنی بر WebSocket ارسال نمی‌شود. هنگامی که یک نمایه Codex از نوع اشتراک انتخاب می‌شود، OpenClaw همچنین CODEX_API_KEY و OPENAI_API_KEY را از فرزند app-server مبتنی بر stdio که ایجاد شده است، دور نگه می‌دارد و در عوض اعتبارنامه‌های انتخاب‌شده را از طریق RPC ورود app-server ارسال می‌کند.

    هنگامی که آن نمایه اشتراک به‌دلیل محدودیت استفاده Codex مسدود شود، OpenClaw نمایه را تا زمان بازنشانی اعلام‌شده Codex مسدود علامت‌گذاری می‌کند و اجازه می‌دهد ترتیب احراز هویت به نمایه بعدی openai:* بچرخد، بدون تغییر مدل انتخاب‌شده یا خروج از چارچوب Codex. پس از گذشت زمان بازنشانی، نمایه اشتراک دوباره واجد شرایط می‌شود.

    تولید تصویر

    Plugin همراه openai تولید تصویر را از طریق ابزار image_generate ثبت می‌کند. این Plugin از تولید تصویر با کلید API ‏OpenAI و OAuth ‏Codex، هر دو از طریق همان ارجاع مدل openai/gpt-image-2، پشتیبانی می‌کند.

    قابلیت کلید API ‏OpenAI OAuth ‏Codex
    ارجاع مدل openai/gpt-image-2 openai/gpt-image-2
    احراز هویت OPENAI_API_KEY ورود OAuth ‏OpenAI Codex
    انتقال API تصاویر OpenAI بک‌اند Responses در Codex
    حداکثر تصویر در هر درخواست 4 4
    حالت ویرایش فعال (تا 5 تصویر مرجع) فعال (تا 5 تصویر مرجع)
    جایگزینی اندازه پشتیبانی می‌شود، شامل اندازه‌های 2K/4K پشتیبانی می‌شود، شامل اندازه‌های 2K/4K
    نسبت ابعاد / وضوح به API تصاویر OpenAI ارسال نمی‌شود در صورت ایمن‌بودن، به اندازه‌ای پشتیبانی‌شده نگاشت می‌شود
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

    gpt-image-2 پیش‌فرض OpenAI برای تولید تصویر از متن و ویرایش تصویر است. gpt-image-1.5، gpt-image-1 و gpt-image-1-mini همچنان به‌عنوان جایگزین‌های صریح مدل قابل‌استفاده‌اند. برای خروجی PNG/WebP با پس‌زمینه شفاف از openai/gpt-image-1.5 استفاده کنید؛ API کنونی gpt-image-2 مقدار background: "transparent" را رد می‌کند.

    برای یک درخواست با پس‌زمینه شفاف، image_generate را همراه با model: "openai/gpt-image-1.5"، outputFormat: "png" یا "webp" و background: "transparent" فراخوانی کنید؛ گزینه قدیمی‌تر ارائه‌دهنده openai.background همچنان پذیرفته می‌شود. OpenClaw همچنین با بازنویسی درخواست‌های شفاف پیش‌فرض openai/gpt-image-2 به gpt-image-1.5 از مسیرهای عمومی OpenAI و OAuth ‏OpenAI Codex محافظت می‌کند؛ نقاط پایانی Azure و سفارشی سازگار با OpenAI نام‌های پیکربندی‌شده استقرار/مدل خود را حفظ می‌کنند.

    همین تنظیم برای اجراهای CLI بدون رابط نیز ارائه می‌شود:

    bash
    openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "یک برچسب دایره قرمز ساده روی پس‌زمینه شفاف" \  --json

    هنگام شروع از یک فایل ورودی، همان پرچم‌های --output-format و --background را همراه با openclaw infer image edit استفاده کنید. --openai-background همچنان به‌عنوان نام مستعار ویژه OpenAI در دسترس است. برای کنترل کیفیت و هزینه تصاویر OpenAI از --quality low|medium|high|auto استفاده کنید. برای ارسال راهنمای تعدیل محتوای OpenAI از --openai-moderation low|auto با مقدار image generate یا image edit استفاده کنید.

    برای نصب‌های OAuth مربوط به ChatGPT/Codex، همان ارجاع openai/gpt-image-2 را حفظ کنید. وقتی یک پروفایل OAuth با openai پیکربندی شده باشد، OpenClaw توکن دسترسی OAuth ذخیره‌شده را بازیابی می‌کند و درخواست‌های تصویر را از طریق بک‌اند Codex Responses می‌فرستد؛ ابتدا OPENAI_API_KEY را امتحان نمی‌کند و بی‌سروصدا نیز به کلید API برنمی‌گردد. هرگاه بخواهید به‌جای آن از مسیر مستقیم OpenAI Images API استفاده کنید، models.providers.openai را صراحتاً با یک کلید API، نشانی پایه سفارشی یا نقطه پایانی Azure پیکربندی کنید. اگر آن نقطه پایانی سفارشی تصویر روی یک نشانی LAN/خصوصی مورداعتماد قرار دارد، browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true را نیز تنظیم کنید؛ OpenClaw نقاط پایانی خصوصی/داخلی سازگار با OpenAI برای تصویر را مسدود نگه می‌دارد، مگر اینکه این اعلام موافقت وجود داشته باشد.

    تولید:

    Code
    /tool image_generate model=openai/gpt-image-2 prompt="یک پوستر حرفه‌ای عرضه OpenClaw برای macOS" size=3840x2160 count=1

    تولید یک PNG شفاف:

    Code
    /tool image_generate model=openai/gpt-image-1.5 prompt="یک برچسب دایره‌ای قرمز ساده روی پس‌زمینه شفاف" outputFormat=png background=transparent

    ویرایش:

    Code
    /tool image_generate model=openai/gpt-image-2 prompt="شکل شیء را حفظ کن و جنس آن را به شیشه نیمه‌شفاف تغییر بده" image=/path/to/reference.png size=1024x1536

    تولید ویدئو

    Plugin همراه openai، تولید ویدئو را از طریق ابزار video_generate ثبت می‌کند.

    قابلیت مقدار
    مدل پیش‌فرض openai/sora-2
    حالت‌ها متن‌به‌ویدئو، تصویر‌به‌ویدئو، ویرایش یک ویدئو
    ورودی‌های مرجع 1 تصویر یا 1 ویدئو
    بازنویسی اندازه برای متن‌به‌ویدئو و تصویر‌به‌ویدئو پشتیبانی می‌شود
    نسبت ابعاد به نزدیک‌ترین اندازه پشتیبانی‌شده تبدیل می‌شود و به‌صورت خام ارسال نمی‌شود
    سایر بازنویسی‌ها resolution، audio، watermark پشتیبانی نمی‌شوند و همراه با هشدار ابزار کنار گذاشته می‌شوند

    درخواست‌های تصویر‌به‌ویدئوی OpenAI از POST /v1/videos با یک input_reference تصویر استفاده می‌کنند. ویرایش یک ویدئو از POST /v1/videos/edits استفاده می‌کند و ویدئوی بارگذاری‌شده را در فیلد video قرار می‌دهد.

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

    مشارکت پرامپت GPT-5

    OpenClaw برای مدل‌های خانواده GPT-5 روی ارائه‌دهنده openai یک مشارکت پرامپت مشترک GPT-5 اضافه می‌کند (از جمله ارجاع‌های قدیمی Codex پیش از ترمیم که به openai/* عادی‌سازی می‌شوند). سایر ارائه‌دهندگانی که شناسه‌های مدل خانواده GPT-5 را نیز ارائه می‌کنند، مانند مسیرهای OpenRouter یا opencode، این پوشش را دریافت نمی‌کنند؛ شرط آن شناسه ارائه‌دهنده openai است، نه صرفاً شناسه مدل. مدل‌های قدیمی‌تر GPT-4.x هرگز آن را دریافت نمی‌کنند.

    چارچوب بومی app-server مربوط به Codex، قرارداد رفتاری شخصیت/انضباط ابزار یا پوشش سبک تعامل دوستانه را از طریق دستورالعمل‌های توسعه‌دهنده دریافت نمی‌کند؛ Codex بومی رفتار پایه، مدل و مستندات پروژه متعلق به Codex را حفظ می‌کند و OpenClaw شخصیت داخلی Codex را برای رشته‌های بومی غیرفعال می‌کند تا فایل‌های شخصیت فضای کاری عامل مرجع نهایی باقی بمانند. OpenClaw فقط زمینه زمان اجرا را در اختیار رشته‌های بومی Codex قرار می‌دهد: تحویل کانال، ابزارهای پویای OpenClaw، واگذاری ACP، زمینه فضای کاری و Skills مربوط به OpenClaw. متن راهنمای Heartbeat از همین مشارکت تنها استثناست: نوبت‌های Heartbeat در Codex بومی آن را دریافت می‌کنند؛ این متن به‌صورت دستورالعمل‌های همکاری اختصاصی تزریق می‌شود، نه از طریق قلاب مشترک مشارکت پرامپت.

    مشارکت GPT-5 برای پرامپت‌های منطبق که OpenClaw می‌سازد، یک قرارداد رفتاری برچسب‌گذاری‌شده برای پایداری شخصیت، ایمنی اجرا، انضباط ابزار، شکل خروجی، بررسی‌های تکمیل و راستی‌آزمایی اضافه می‌کند. رفتار پاسخ‌دهی ویژه کانال و پیام بی‌صدا در پرامپت سیستمی مشترک OpenClaw و سیاست تحویل خروجی باقی می‌ماند. لایه سبک تعامل دوستانه جداگانه و قابل‌پیکربندی است.

    مقدار اثر
    "friendly" (پیش‌فرض) فعال‌سازی لایه سبک تعامل دوستانه
    "on" نام مستعار "friendly"
    "off" فقط لایه سبک دوستانه را غیرفعال می‌کند

    پیکربندی

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

    CLI

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

    صدا و گفتار

    ترکیب گفتار (TTS)

    Plugin همراه openai، ترکیب گفتار را برای سطح tts ثبت می‌کند.

    تنظیم مسیر پیکربندی پیش‌فرض
    مدل tts.providers.openai.model gpt-4o-mini-tts
    صدا tts.providers.openai.speakerVoice coral
    سرعت tts.providers.openai.speed (تنظیم‌نشده)
    دستورالعمل‌ها tts.providers.openai.instructions (تنظیم‌نشده، فقط gpt-4o-mini-tts)
    قالب tts.providers.openai.responseFormat opus برای یادداشت‌های صوتی، mp3 برای فایل‌ها
    کلید API tts.providers.openai.apiKey به OPENAI_API_KEY برمی‌گردد
    نشانی پایه tts.providers.openai.baseUrl https://api.openai.com/v1
    بدنه اضافی tts.providers.openai.extraBody / extra_body (تنظیم‌نشده)

    مدل‌های موجود: gpt-4o-mini-tts، tts-1، tts-1-hd. صداهای موجود: alloy، ash، ballad، cedar، coral، echo، fable، juniper، marin، onyx، nova، sage، shimmer، verse.

    extraBody پس از فیلدهای تولیدشده OpenClaw در JSON درخواست /audio/speech ادغام می‌شود؛ بنابراین برای نقاط پایانی سازگار با OpenAI که به کلیدهای اضافی مانند lang نیاز دارند، از آن استفاده کنید. کلیدهای prototype نادیده گرفته می‌شوند.

    json5
    {  tts: {    providers: {      openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },    },  },}
    گفتار‌به‌متن

    Plugin همراه openai، گفتار‌به‌متن دسته‌ای را از طریق سطح رونویسی درک رسانه OpenClaw ثبت می‌کند.

    • مدل پیش‌فرض: gpt-4o-transcribe
    • نقطه پایانی: OpenAI REST /v1/audio/transcriptions
    • مسیر ورودی: بارگذاری فایل صوتی چندبخشی
    • در هر جایی استفاده می‌شود که رونویسی صدای ورودی، tools.media.audio را می‌خواند، از جمله قطعه‌های کانال صوتی Discord و پیوست‌های صوتی کانال

    برای اجبار استفاده از OpenAI در رونویسی صدای ورودی:

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

    راهنمایی‌های زبان و پرامپت، در صورت ارائه از طریق پیکربندی مشترک رسانه صوتی یا درخواست رونویسی هر فراخوانی، به OpenAI ارسال می‌شوند.

    رونویسی Realtime

    Plugin همراه openai، رونویسی Realtime را برای Plugin تماس صوتی ثبت می‌کند.

    تنظیم مسیر پیکربندی پیش‌فرض
    مدل plugins.entries.voice-call.config.streaming.providers.openai.model gpt-4o-transcribe
    زبان ...openai.language (تنظیم‌نشده)
    پرامپت ...openai.prompt (تنظیم‌نشده)
    مدت سکوت ...openai.silenceDurationMs 800
    آستانه VAD ...openai.vadThreshold 0.5
    احراز هویت پروفایل کلید API مربوط به ...openai.apiKey، OPENAI_API_KEY یا openai کلید API پلتفرم الزامی است
    صدای Realtime

    Plugin همراه openai، صدای Realtime را برای Plugin تماس صوتی ثبت می‌کند.

    تنظیم مسیر پیکربندی پیش‌فرض
    مدل plugins.entries.voice-call.config.realtime.providers.openai.model gpt-realtime-2.1
    صدا ...openai.voice alloy
    دما (پل استقرار Azure) ...openai.temperature 0.8
    آستانه VAD ...openai.vadThreshold 0.5
    مدت سکوت ...openai.silenceDurationMs 500
    حاشیه‌گذاری پیشوند ...openai.prefixPaddingMs 300
    میزان تلاش استدلال ...openai.reasoningEffort (تنظیم‌نشده)
    احراز هویت پروفایل کلید API ‏openai، ‏...openai.apiKey، یا OPENAI_API_KEY کلید API پلتفرم OpenAI الزامی است

    صداهای داخلی Realtime موجود برای gpt-realtime-2.1: ‏alloy، ‏ash، ‏ballad، ‏coral، ‏echo، ‏sage، ‏shimmer، ‏verse، ‏marin، ‏cedar. OpenAI برای دستیابی به بهترین کیفیت Realtime، ‏marin و cedar را توصیه می‌کند. این مجموعه از صداهای تبدیل متن به گفتار بالا جدا است؛ صدایی که فقط برای TTS است، مانند fable، ‏nova یا onyx، برای نشست‌های Realtime معتبر نیست. اگر گونه کوچک‌تر و کم‌هزینه‌تر Realtime 2.1 را ترجیح می‌دهید، مدل را صراحتاً روی gpt-realtime-2.1-mini تنظیم کنید.

    نقاط پایانی Azure OpenAI

    ارائه‌دهنده همراه openai می‌تواند با بازنویسی URL پایه، یک منبع Azure OpenAI را برای تولید تصویر هدف قرار دهد. در مسیر تولید تصویر، OpenClaw نام‌های میزبان Azure را در models.providers.openai.baseUrl تشخیص می‌دهد و به‌طور خودکار به ساختار درخواست Azure تغییر مسیر می‌دهد.

    در موارد زیر از Azure OpenAI استفاده کنید:

    • از قبل اشتراک، سهمیه یا قرارداد سازمانی Azure OpenAI دارید
    • به اقامت منطقه‌ای داده‌ها یا کنترل‌های انطباق ارائه‌شده توسط Azure نیاز دارید
    • می‌خواهید ترافیک را در یک محیط اجاره‌ای Azure موجود نگه دارید

    پیکربندی

    برای تولید تصویر Azure از طریق ارائه‌دهنده همراه openai، ‏models.providers.openai.baseUrl را به منبع Azure خود اشاره دهید و apiKey را روی کلید Azure OpenAI تنظیم کنید (نه کلید پلتفرم OpenAI):

    json5
    {  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=... را به هر درخواست می‌افزاید
    • برای فراخوانی‌های تولید تصویر Azure از مهلت پیش‌فرض درخواست 600s استفاده می‌کند. مقادیر timeoutMs برای هر فراخوانی همچنان این پیش‌فرض را بازنویسی می‌کنند.

    URLهای پایه دیگر (OpenAI عمومی، پراکسی‌های سازگار با OpenAI) ساختار استاندارد درخواست تصویر OpenAI را حفظ می‌کنند.

    نسخه API

    برای ثابت‌کردن یک نسخه پیش‌نمایش یا عمومی مشخص Azure برای مسیر تولید تصویر Azure، ‏AZURE_OPENAI_API_VERSION را تنظیم کنید:

    bash
    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 را ارائه می‌دهد:

    Code
    /tool image_generate model=openai/gpt-image-2-prod prompt="یک پوستر ساده" 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 بررسی کنید.

    پیکربندی پیشرفته

    نمونه‌های params برای هر مدل در ادامه، درخواست ارائه‌دهنده تعبیه‌شده OpenClaw را شکل می‌دهند. پیکربندی آن‌ها رفتاری است که به‌طور صریح برای درخواست تعریف شده است، بنابراین یک مسیر ‏auto که از جهات دیگر واجد شرایط است، به‌جای انتخاب ضمنی Codex در OpenClaw باقی می‌ماند. چارچوب بومی app-server ‏Codex مالک انتقال و تنظیمات درخواست خود است؛ وقتی مسیر مؤثر به‌عنوان سازگار با Codex اعلام نشده باشد، agentRuntime.id: "codex" صریح به‌صورت بسته شکست می‌خورد.

    انتقال (WebSocket در برابر SSE)

    OpenClaw برای openai/* ابتدا از WebSocket و سپس از SSE به‌عنوان جایگزین استفاده می‌کند ("auto").

    در حالت "auto"، ‏OpenClaw:

    • پیش از بازگشت به SSE، یک شکست اولیه WebSocket را دوباره امتحان می‌کند
    • پس از یک شکست، WebSocket را برای 60 ثانیه تضعیف‌شده علامت‌گذاری می‌کند و در دوره خنک‌شدن از SSE استفاده می‌کند
    • برای تلاش‌های مجدد و اتصال‌های دوباره، سرآیندهای پایدار هویت نشست و نوبت را پیوست می‌کند
    • شمارنده‌های مصرف (input_tokens / prompt_tokens) را در گونه‌های مختلف انتقال یکسان‌سازی می‌کند
    مقدار رفتار
    "auto" (پیش‌فرض) ابتدا WebSocket، سپس SSE جایگزین
    "sse" فقط SSE را اجباری می‌کند
    "websocket" فقط WebSocket را اجباری می‌کند
    json5
    {  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

    مستندات مرتبط OpenAI:

    حالت سریع

    OpenClaw یک کلید مشترک حالت سریع را برای openai/* ارائه می‌کند:

    • چت/رابط کاربری: /fast status|auto|on|off
    • پیکربندی: agents.defaults.models["<provider>/<model>"].params.fastMode

    وقتی فعال باشد، OpenClaw حالت سریع را به پردازش اولویت‌دار OpenAI (service_tier = "priority") نگاشت می‌کند. مقادیر موجود service_tier حفظ می‌شوند و حالت سریع reasoning یا text.verbosity را بازنویسی نمی‌کند. fastMode: "auto" فراخوانی‌های جدید مدل را تا حد قطع خودکار در حالت سریع آغاز می‌کند و سپس تلاش مجدد، جایگزین، نتیجه ابزار یا فراخوانی‌های ادامه بعدی را بدون حالت سریع آغاز می‌کند. حد قطع به‌طور پیش‌فرض 60 ثانیه است؛ برای تغییر آن، params.fastAutoOnSeconds را روی مدل فعال تنظیم کنید.

    json5
    {  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}
    پردازش اولویت‌دار (service_tier)

    API متعلق به OpenAI پردازش اولویت‌دار را از طریق service_tier ارائه می‌کند. آن را برای هر مدل در OpenClaw تنظیم کنید:

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

    مقادیر پشتیبانی‌شده: auto، default، flex، priority.

    Compaction سمت سرور (Responses API)

    برای مدل‌های مستقیم OpenAI Responses (openai/* روی api.openai.com)، پوشش‌دهندهٔ جریان OpenClaw در Plugin متعلق به OpenAI، Compaction سمت سرور را به‌طور خودکار فعال می‌کند:

    • store: true را اجباری می‌کند (مگر اینکه سازگاری مدل supportsStore: false را تنظیم کند)
    • context_management: [{ type: "compaction", compact_threshold: ... }] را تزریق می‌کند
    • compact_threshold پیش‌فرض: 70% از contextWindow (یا در صورت دردسترس‌نبودن، 80000)

    این تنظیم برای مسیر زمان‌اجرای داخلی OpenClaw و هوک‌های ارائه‌دهندهٔ OpenAI که اجراهای توکار استفاده می‌کنند اعمال می‌شود. هارنس بومی app-server در Codex زمینهٔ خود را از طریق Codex مدیریت می‌کند و این تنظیم بر آن تأثیری ندارد.

    فعال‌سازی صریح

    برای نقاط پایانی سازگار مانند Azure OpenAI Responses مفید است:

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

    آستانهٔ سفارشی

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

    غیرفعال‌سازی

    json5
    {  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}
    حالت GPT با عامل‌مندی سخت‌گیرانه

    برای مدل‌های خانوادهٔ GPT-5 ارائه‌دهندهٔ openai که از طریق زمان‌اجرای توکار OpenClaw اجرا می‌شوند، OpenClaw از پیش یک قرارداد اجرایی سخت‌گیرانه‌تر با نام strict-agentic را به‌طور پیش‌فرض به‌کار می‌گیرد. هرگاه ارائه‌دهندهٔ برطرف‌شده openai باشد و شناسهٔ مدل با خانوادهٔ GPT-5 مطابقت داشته باشد، این قرارداد به‌طور خودکار فعال می‌شود، مگر اینکه پیکربندی صراحتاً از آن انصراف دهد:

    json5
    {  agents: {    defaults: {      embeddedAgent: { executionContract: "default" },    },  },}

    تنظیم صریح "strict-agentic" در یک مسیر پشتیبانی‌شده بی‌اثر است (زیرا از پیش مقدار پیش‌فرض است) و در جفت‌های ارائه‌دهنده/مدل پشتیبانی‌نشده نیز اثری ندارد.

    هنگامی که strict-agentic فعال است، OpenClaw:

    • update_plan را برای کارهای قابل‌توجه به‌طور خودکار فعال می‌کند
    • نوبت‌های از نظر ساختاری خالی یا فقط شامل استدلال را با یک ادامهٔ دارای پاسخ قابل‌مشاهده دوباره امتحان می‌کند
    • هنگامی که هارنس انتخاب‌شده رویدادهای صریح برنامه را ارائه دهد، از آن‌ها استفاده می‌کند

    OpenClaw برای تشخیص اینکه یک نوبت برنامه، به‌روزرسانی پیشرفت یا پاسخ نهایی است، نثر دستیار را طبقه‌بندی نمی‌کند.

    مسیرهای بومی در برابر مسیرهای سازگار با OpenAI

    OpenClaw با نقاط پایانی مستقیم OpenAI، Codex و Azure OpenAI متفاوت از پراکسی‌های عمومی /v1 سازگار با OpenAI رفتار می‌کند:

    مسیرهای بومی (openai/*، Azure OpenAI):

    • reasoning: { effort: "none" } را فقط برای مدل‌هایی نگه می‌دارند که از میزان تلاش none در OpenAI پشتیبانی می‌کنند
    • استدلال غیرفعال را برای مدل‌ها یا پراکسی‌هایی که reasoning.effort: "none" را رد می‌کنند، حذف می‌کنند
    • شِمای ابزار را به‌طور پیش‌فرض روی حالت سخت‌گیرانه قرار می‌دهند
    • سربرگ‌های پنهان انتساب را فقط به میزبان‌های بومی تأییدشده پیوست می‌کنند (Azure OpenAI این سربرگ‌ها را دریافت نمی‌کند، هرچند یک مسیر بومی است)
    • شکل‌دهی درخواست مختص OpenAI را حفظ می‌کنند (service_tier، store، سازگاری استدلال و راهنمایی‌های حافظهٔ نهان پرامپت)

    مسیرهای پراکسی/سازگار:

    • از رفتار سازگاری سهل‌گیرانه‌تری استفاده می‌کنند
    • store مربوط به Completions را از محموله‌های غیربومی openai-completions حذف می‌کنند
    • JSON عبوری پیشرفتهٔ params.extra_body/params.extraBody را برای پراکسی‌های Completions سازگار با OpenAI می‌پذیرند
    • params.chat_template_kwargs را برای پراکسی‌های Completions سازگار با OpenAI مانند vLLM می‌پذیرند
    • شِمای سخت‌گیرانهٔ ابزار یا سربرگ‌های مختص مسیر بومی را اجباری نمی‌کنند

    مرتبط

    Was this useful?
    On this page

    On this page