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 ایجاد کنید.

  • خروجی‌گرفتن کلید و اجرای راه‌اندازی اولیه

    bash
    export NVIDIA_API_KEY="nvapi-..."openclaw onboard --auth-choice nvidia-api-key
  • تنظیم یک مدل NVIDIA

    bash
    openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
  • برای راه‌اندازی غیرتعاملی، کلید را مستقیماً ارسال کنید:

    bash
    openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

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

    json5
    {  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 محدود نگه دارید:

    json5
    {  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 ارائه‌دهنده را پوشش می‌دهد و سقف ناظر بی‌کاری/جریان را برای آن ارائه‌دهنده افزایش می‌دهد:

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

    مرتبط

    Was this useful?
    On this page

    On this page