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 استفاده میکند. حساب فعلی را با این فرمان بررسی کنید:
openclaw models list --provider openaiدسترسی سازمان API و فضای کاری Codex میتوانند متفاوت باشند. اگر GPT-5.6 در دسترس نیست، GPT-5.5 را صراحتاً انتخاب کنید:
openclaw models set openai/gpt-5.5OpenClaw خطای دسترسی بالادستی را نمایش میدهد و انتخاب 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 و تعبیههای پرسوجو استفاده کند:
{ 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 ایجاد یا کپی کنید.
راهاندازی اولیه را اجرا کنید
openclaw onboard --auth-choice openai-api-keyیا کلید را مستقیماً ارسال کنید:
openclaw onboard --openai-api-key "$OPENAI_API_KEY"در دسترس بودن مدل را تأیید کنید
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 با متن ساده | رد میشود | اعتبارنامه ارسال نمیشود |
نمونه پیکربندی
{ 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 تنظیم کنید:
{ 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 را اجرا کنید
openclaw onboard --auth-choice openaiیا OAuth را مستقیماً اجرا کنید:
openclaw models auth login --provider openaiبرای راهاندازیهای بدون رابط گرافیکی یا ناسازگار با callback، --device-code را اضافه کنید تا
بهجای callback مرورگر localhost، با جریان کد دستگاه ChatGPT
وارد شوید:
openclaw models auth login --provider openai --device-codeاز مسیر متعارف مدل OpenAI استفاده کنید
openclaw config set agents.defaults.model.primary openai/gpt-5.6-solبرای این مسیر بومی HTTPS رسمی و دقیق، هیچ پیکربندی runtime لازم نیست. این مسیر ممکن است runtime متعلق به app-server مربوط به Codex را بهطور خودکار انتخاب کند و OpenClaw هنگام انتخاب آن runtime، Plugin همراه Codex را نصب یا اصلاح میکند.
در دسترس بودن احراز هویت Codex را تأیید کنید
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 |
نمونه پیکربندی
{ plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.6-sol" }, }, },}با یک پشتیبان کلید API، مدل انتخابشده را زیر openai/* نگه دارید و
ترتیب احراز هویت را زیر openai قرار دهید. OpenClaw ابتدا اشتراک و سپس
کلید API را امتحان میکند، درحالیکه روی چارچوب Codex باقی میماند:
{ 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
openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --jsonبرای یک عامل مشخص، --agent <id> را اضافه کنید:
openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openaiاگر یک پیکربندی قدیمی هنوز ارجاعهای قدیمی Codex GPT یا یک پین نشست زماناجرای منسوخ OpenAI بدون پیکربندی صریح زماناجرا دارد، آن را تعمیر کنید:
openclaw doctor --fixopenclaw config validateاگر models auth list --provider openai هیچ نمایه قابلاستفادهای نشان نمیدهد، دوباره
وارد شوید:
openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openaiبرای چند ورود OAuth Codex در یک عامل از --profile-id استفاده کنید، سپس
آنها را از طریق ترتیب احراز هویت یا /model ...@<profileId> کنترل کنید:
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 انجام دهد:
{ 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 احراز هویت را با این ترتیب انتخاب میکند:
- نمایههای احراز هویت مرتبشده OpenAI برای عامل، ترجیحاً زیر
auth.order.openai. برای مهاجرت شناسههای قدیمی نمایه احراز هویت Codex و ترتیب احراز هویت،openclaw doctor --fixرا اجرا کنید. - حساب موجود app-server، مانند ورود محلی ChatGPT در Codex CLI. برای خانه عامل ایزوله پیشفرض، OpenClaw آن حساب بومی CLI را از طریق RPC ورود به app-server متصل میکند؛ پیکربندی، Pluginها یا مخزن رشتههای CLI را بهاشتراک نمیگذارد.
- فقط برای اجرای محلی 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 ارسال نمیشود | در صورت ایمنبودن، به اندازهای پشتیبانیشده نگاشت میشود |
{ 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 بدون رابط نیز ارائه میشود:
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 برای تصویر را مسدود نگه میدارد، مگر اینکه این
اعلام موافقت وجود داشته باشد.
تولید:
/tool image_generate model=openai/gpt-image-2 prompt="یک پوستر حرفهای عرضه OpenClaw برای macOS" size=3840x2160 count=1تولید یک PNG شفاف:
/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تولید ویدئو
Plugin همراه openai، تولید ویدئو را از طریق ابزار
video_generate ثبت میکند.
| قابلیت | مقدار |
|---|---|
| مدل پیشفرض | openai/sora-2 |
| حالتها | متنبهویدئو، تصویربهویدئو، ویرایش یک ویدئو |
| ورودیهای مرجع | 1 تصویر یا 1 ویدئو |
| بازنویسی اندازه | برای متنبهویدئو و تصویربهویدئو پشتیبانی میشود |
| نسبت ابعاد | به نزدیکترین اندازه پشتیبانیشده تبدیل میشود و بهصورت خام ارسال نمیشود |
| سایر بازنویسیها | resolution، audio، watermark پشتیبانی نمیشوند و همراه با هشدار ابزار کنار گذاشته میشوند |
درخواستهای تصویربهویدئوی OpenAI از POST /v1/videos با یک
input_reference تصویر استفاده میکنند. ویرایش یک ویدئو از POST /v1/videos/edits
استفاده میکند و ویدئوی بارگذاریشده را در فیلد video قرار میدهد.
{ 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" |
فقط لایه سبک دوستانه را غیرفعال میکند |
پیکربندی
{ agents: { defaults: { promptOverlays: { gpt5: { personality: "friendly" }, }, }, },}CLI
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 نادیده گرفته میشوند.
{ 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 در رونویسی صدای ورودی:
{ 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):
{ 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 را تنظیم کنید:
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="یک پوستر ساده" 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 را اجباری میکند |
{ 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 را روی مدل فعال تنظیم کنید.
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } }, }, }, },}پردازش اولویتدار (service_tier)
API متعلق به OpenAI پردازش اولویتدار را از طریق service_tier ارائه میکند. آن را برای هر
مدل در OpenClaw تنظیم کنید:
{ 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 مفید است:
{ 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 }, }, }, }, },}حالت GPT با عاملمندی سختگیرانه
برای مدلهای خانوادهٔ GPT-5 ارائهدهندهٔ openai که از طریق زماناجرای توکار
OpenClaw اجرا میشوند، OpenClaw از پیش یک قرارداد اجرایی سختگیرانهتر با نام
strict-agentic را بهطور پیشفرض بهکار میگیرد. هرگاه ارائهدهندهٔ برطرفشده
openai باشد و شناسهٔ مدل با خانوادهٔ GPT-5 مطابقت داشته باشد، این قرارداد
بهطور خودکار فعال میشود، مگر اینکه پیکربندی صراحتاً از آن انصراف دهد:
{ 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 میپذیرند- شِمای سختگیرانهٔ ابزار یا سربرگهای مختص مسیر بومی را اجباری نمیکنند