Providers
NVIDIA
NVIDIA مدلهای باز را بهصورت رایگان از طریق یک API سازگار با OpenAI در
https://integrate.api.nvidia.com/v1 ارائه میکند که با یک کلید API از
build.nvidia.com احراز هویت میشود. OpenClaw
بهطور پیشفرض ارائهدهنده NVIDIA را روی Nemotron 3 Ultra تنظیم میکند؛ مدل استدلالی NVIDIA
با ۵۵۰ میلیارد پارامتر کل و ۵۵ میلیارد پارامتر فعال که برای کارهای عاملی با زمینه طولانی طراحی شده است.
شروع به کار
دریافت کلید API
در build.nvidia.com یک کلید API ایجاد کنید.
خروجیگرفتن کلید و اجرای راهاندازی اولیه
export NVIDIA_API_KEY="nvapi-..."openclaw onboard --auth-choice nvidia-api-keyتنظیم یک مدل NVIDIA
openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55bبرای راهاندازی غیرتعاملی، کلید را مستقیماً ارسال کنید:
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."نمونه پیکربندی
{ env: { NVIDIA_API_KEY: "nvapi-..." }, models: { providers: { nvidia: { baseUrl: "https://integrate.api.nvidia.com/v1", api: "openai-completions", }, }, }, agents: { defaults: { model: { primary: "nvidia/nvidia/nemotron-3-ultra-550b-a55b" }, }, },}فهرست برگزیده
هنگامی که یک کلید API برای NVIDIA پیکربندی شده باشد، مسیرهای راهاندازی و انتخاب مدل،
فهرست عمومی مدلهای برگزیده NVIDIA را از
https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json
دریافت میکنند و نتیجه را بهمدت ۲۴ ساعت در حافظه نهان نگه میدارند (۳۲ ورودی نخست که
بهصورت ردیفهای رایگان با ورودی متنی وارد میشوند). بنابراین مدلهای برگزیده جدید
build.nvidia.com بدون نیاز به انتظار برای انتشار نسخه جدید OpenClaw، در بخشهای
راهاندازی و انتخاب مدل ظاهر میشوند. وقتی خوراک زنده در دسترس باشد، نخستین مدل
بازگرداندهشده گزینه ازپیشانتخابشده در هنگام راهاندازی NVIDIA است.
دریافت داده از یک سیاست ثابت میزبان HTTPS برای assets.ngc.nvidia.com استفاده میکند.
اگر هیچ کلید API برای NVIDIA پیکربندی نشده باشد، یا خوراک در دسترس نباشد یا ساختار
نامعتبری داشته باشد، OpenClaw به فهرست همراه و پیشفرض همراه زیر بازمیگردد.
Nemotron 3 Ultra
Nemotron 3 Ultra مدل پیشفرض NVIDIA در OpenClaw است. صفحه ساخت NVIDIA برای
nvidia/nemotron-3-ultra-550b-a55b
آن را بهعنوان یک نقطه پایانی رایگان و در دسترس با مشخصات زمینه یکمیلیونتوکنی معرفی میکند.
ردیف همراه Ultra بهطور پیشفرض
chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }
را ارسال میکند تا خروجی عادی گفتوگو بهجای آشکارکردن متن استدلال، در پاسخ قابلمشاهده باقی بماند.
برای بهرهگیری از توانمندترین گزینه پیشفرض NVIDIA از Ultra استفاده کنید. اگر گزینه کوچکتر Nemotron 3 را میخواهید، Super را انتخابشده نگه دارید؛ یا هنگامی که زمینه، تأخیر یا رفتار یکی از مدلهای شخص ثالث میزبانیشده در فهرست NVIDIA مناسبتر است، یکی از آنها را انتخاب کنید.
فهرست جایگزین همراه
ردیفهای همراه قابلانتخاب، تصویری لحظهای از فهرست مدلهای برگزیده NVIDIA هستند. ردیفهای سازگاری منسوخ همچنان با ارجاع دقیق قابل شناساییاند، اما در انتخابگرهای مدل نمایش داده نمیشوند.
| ارجاع مدل | نام | زمینه | حداکثر خروجی |
|---|---|---|---|
nvidia/nvidia/nemotron-3-ultra-550b-a55b |
Nemotron 3 Ultra 550B | 1,048,576 | 8,192 |
nvidia/nvidia/nemotron-3-super-120b-a12b |
Nemotron 3 Super 120B | 1,000,000 | 8,192 |
nvidia/z-ai/glm-5.2 |
GLM 5.2 | 202,752 | 8,192 |
nvidia/moonshotai/kimi-k2.6 |
Kimi K2.6 | 262,144 | 8,192 |
nvidia/minimaxai/minimax-m3 |
Minimax M3 | 196,608 | 8,192 |
nvidia/deepseek-ai/deepseek-v4-pro |
DeepSeek V4 Pro | 262,144 | 16,384 |
nvidia/qwen/qwen3.5-397b-a17b |
Qwen3.5 397B A17B | 262,144 | 16,384 |
فهرست کامل سازگاری همچنین این ارجاعهای منتشرشده را برای پیکربندیهای موجود حفظ میکند:
nvidia/moonshotai/kimi-k2.5، nvidia/z-ai/glm-5.1،
nvidia/minimaxai/minimax-m2.5، nvidia/z-ai/glm5 و
nvidia/minimaxai/minimax-m2.7. آنها همچنان با ارجاع دقیق در دسترساند، اما
هرگز در راهاندازی اولیه یا انتخابگرهای مدل ظاهر نمیشوند.
پیکربندی پیشرفته
رفتار فعالسازی خودکار
ارائهدهنده هنگامی بهطور خودکار فعال میشود که متغیر محیطی NVIDIA_API_KEY
تنظیم شده باشد یا کلیدی هنگام راهاندازی اولیه ذخیره شده باشد. فراتر از کلید،
هیچ پیکربندی صریحی برای ارائهدهنده لازم نیست.
فهرست و قیمتگذاری
وقتی احراز هویت NVIDIA پیکربندی شده باشد، OpenClaw فهرست عمومی مدلهای برگزیده
NVIDIA را ترجیح میدهد و آن را بهمدت ۲۴ ساعت در حافظه نهان نگه میدارد.
جایگزین همراه قابلانتخاب، تصویری ثابت از فهرست مدلهای برگزیده NVIDIA است؛
ردیفهای سازگاری منسوخ با ارجاع دقیق از انتخابگرهای مدل پنهان میشوند. هزینهها
در منبع بهطور پیشفرض 0 هستند، زیرا NVIDIA درحالحاضر برای مدلهای فهرستشده
دسترسی رایگان به API ارائه میدهد.
نقطه پایانی سازگار با OpenAI
OpenClaw از طریق آداپتور openai-completions و مسیر استاندارد تکمیل گفتوگوی
/v1 با NVIDIA ارتباط برقرار میکند. هر ابزار سازگار با OpenAI باید با نشانی
پایه NVIDIA بدون نیاز به پیکربندی اضافی کار کند.
پارامترهای استدلال Nemotron 3 Ultra
درخواست نمونه Ultra از NVIDIA برای خروجی استدلال از
chat_template_kwargs.enable_thinking و reasoning_budget استفاده میکند.
ردیف همراه Ultra در OpenClaw برای استفاده عادی از گفتوگو، تفکر الگو را
بهطور پیشفرض غیرفعال میکند. اگر لازم است خروجی استدلال NVIDIA را فعال کنید
یا سایر فیلدهای درخواست مختص NVIDIA را اجباراً تنظیم کنید، پارامترهای هر مدل
را تنظیم کرده و بازنویسیهای مختص ارائهدهنده را به مدل NVIDIA محدود نگه دارید:
{ agents: { defaults: { models: { "nvidia/nvidia/nemotron-3-ultra-550b-a55b": { params: { chat_template_kwargs: { enable_thinking: true }, extra_body: { reasoning_budget: 16384 }, }, }, }, }, },}params.chat_template_kwargs بهجای جایگزینی کل شیء، با هر
chat_template_kwargs موجود در درخواست ادغام میشود.
params.extra_body بازنویسی نهایی بدنه درخواست سازگار با OpenAI است و کلیدهای
متداخل داده ارسالی را بازنویسی میکند؛ بنابراین فقط برای فیلدهایی از آن استفاده
کنید که NVIDIA برای نقطه پایانی انتخابشده مستند کرده است.
پاسخهای کند ارائهدهنده سفارشی
برخی مدلهای سفارشی میزبانیشده توسط NVIDIA ممکن است پیش از ارسال نخستین بخش
پاسخ، بیشتر از زمان پیشفرض حدود ۱۲۰ ثانیهای ناظر بیکاری مدل طول بکشند.
برای ورودیهای ارائهدهنده سفارشی NVIDIA، بهجای افزایش مهلت زمانی کل زمان
اجرای عامل، مهلت زمانی ارائهدهنده را افزایش دهید؛ timeoutSeconds درخواستهای
HTTP ارائهدهنده را پوشش میدهد و سقف ناظر بیکاری/جریان را برای آن ارائهدهنده
افزایش میدهد:
{ models: { providers: { "custom-integrate-api-nvidia-com": { baseUrl: "https://integrate.api.nvidia.com/v1", api: "openai-completions", apiKey: "NVIDIA_API_KEY", timeoutSeconds: 300, }, }, }, agents: { defaults: { models: { "custom-integrate-api-nvidia-com/meta/llama-3.1-70b-instruct": { params: { thinking: "off" }, }, }, }, },}