Naar hoofdinhoud gaan
NVIDIA biedt een OpenAI-compatibele API op https://integrate.api.nvidia.com/v1 voor open modellen gratis aan. Authenticeer met een API-sleutel van build.nvidia.com. OpenClaw stelt de NVIDIA-provider standaard in op Nemotron 3 Ultra, NVIDIA’s 550B totaal / 55B actieve redeneermodel voor agentisch werk met lange context.

​
Aan de slag

1

Get your API key

Maak een API-sleutel aan op build.nvidia.com.
2

Export the key and run onboarding

export NVIDIA_API_KEY="nvapi-..."
openclaw onboard --auth-choice nvidia-api-key
3

Set an NVIDIA model

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
Als je --nvidia-api-key doorgeeft in plaats van de env-var, komt de waarde in de shellgeschiedenis en ps-uitvoer terecht. Geef waar mogelijk de voorkeur aan de omgevingsvariabele NVIDIA_API_KEY.
Voor niet-interactieve configuratie kun je de sleutel ook rechtstreeks doorgeven: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

​
Configuratievoorbeeld

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

​
Uitgelichte catalogus

Wanneer een NVIDIA API-sleutel is geconfigureerd, proberen OpenClaw-configuratie- en modelselectiepaden NVIDIA’s openbare catalogus met uitgelichte modellen op te halen van https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json en cachen ze het gerangschikte resultaat 24 uur. Nieuwe uitgelichte modellen van build.nvidia.com verschijnen daardoor in configuratie- en modelselectieoppervlakken zonder te wachten op een OpenClaw-release. Wanneer de live feed beschikbaar is, is het eerste geretourneerde model de standaardoptie die tijdens NVIDIA-configuratie wordt getoond. De fetch gebruikt een vast HTTPS-hostbeleid voor assets.ngc.nvidia.com. Als er geen NVIDIA API-sleutel is geconfigureerd, of als die openbare catalogus niet beschikbaar of ongeldig gevormd is, valt OpenClaw terug op de gebundelde catalogus en de gebundelde standaard hieronder.

​
Nemotron 3 Ultra

Nemotron 3 Ultra is het standaard NVIDIA-model in OpenClaw. NVIDIA’s build-pagina voor nvidia/nemotron-3-ultra-550b-a55b vermeldt het als een beschikbaar gratis endpoint met een contextspecificatie van 1 miljoen tokens. De gebundelde catalogus registreert een maximale uitvoer van 16.384 tokens om overeen te komen met NVIDIA’s huidige OpenAI-compatibele voorbeeldaanvraag voor het gehoste endpoint. Gebruik Ultra voor de NVIDIA-standaard met de hoogste capaciteit. Houd Super geselecteerd wanneer je de kleinere Nemotron 3-optie wilt, of kies een van de modellen van derden die in NVIDIA’s catalogus worden gehost wanneer hun context, latency of gedrag beter past. De gebundelde Ultra-rij verzendt standaard chat_template_kwargs.enable_thinking: false en force_nonempty_content: true, zodat normale chatuitvoer in het zichtbare antwoord blijft in plaats van redeneertekst bloot te leggen.

​
Gebundelde fallbackcatalogus

ModelrefNaamContextMax. uitvoerNotities
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384Standaard
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B1,048,5768,192Uitgelichte fallback
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192Uitgelichte fallback
nvidia/minimaxai/minimax-m2.7Minimax M2.7196,6088,192Uitgelichte fallback
nvidia/z-ai/glm-5.1GLM 5.1202,7528,192Uitgelichte fallback
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196,6088,192Verouderd, upgradecompatibiliteit
nvidia/z-ai/glm5GLM-5202,7528,192Verouderd, upgradecompatibiliteit

​
Geavanceerde configuratie

De provider wordt automatisch ingeschakeld wanneer de omgevingsvariabele NVIDIA_API_KEY is ingesteld. Er is naast de sleutel geen expliciete providerconfiguratie vereist.
OpenClaw geeft de voorkeur aan NVIDIA’s openbare catalogus met uitgelichte modellen wanneer NVIDIA-authenticatie is geconfigureerd en cachet deze 24 uur. De gebundelde fallbackcatalogus is statisch en behoudt verouderde verzonden refs voor upgradecompatibiliteit. Kosten zijn standaard 0 in de broncode, omdat NVIDIA momenteel gratis API-toegang biedt voor de vermelde modellen.
NVIDIA gebruikt het standaard /v1 completions-endpoint. Alle OpenAI-compatibele tooling zou direct moeten werken met de NVIDIA-basis-URL.
NVIDIA’s Ultra-voorbeeldaanvraag gebruikt chat_template_kwargs.enable_thinking en reasoning_budget voor redeneeruitvoer. OpenClaw’s gebundelde Ultra-rij schakelt template-denken standaard uit voor normaal chatgebruik. Als je je wilt aanmelden voor NVIDIA-redeneeruitvoer of andere NVIDIA-specifieke aanvraagvelden wilt afdwingen, stel dan parameters per model in en houd providerspecifieke overrides beperkt tot het NVIDIA-model:
{
  agents: {
    defaults: {
      models: {
        "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {
          params: {
            chat_template_kwargs: { enable_thinking: true },
            extra_body: { reasoning_budget: 16384 },
          },
        },
      },
    },
  },
}
params.extra_body is de uiteindelijke OpenAI-compatibele request-body-override, dus gebruik deze alleen voor velden die NVIDIA documenteert voor het geselecteerde endpoint.
Sommige door NVIDIA gehoste aangepaste modellen kunnen langer duren dan de standaard idle-watchdog van het model voordat ze een eerste responschunk uitsturen. Verhoog voor aangepaste NVIDIA-provideritems de providertime-out in plaats van de time-out van de volledige agent-runtime te verhogen:
{
  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" },
        },
      },
    },
  },
}
NVIDIA-modellen zijn momenteel gratis te gebruiken. Controleer build.nvidia.com voor de nieuwste beschikbaarheid en details over rate limits.

​
Gerelateerd

Model selection

Providers, modelrefs en failovergedrag kiezen.

Configuration reference

Volledige configuratiereferentie voor agents, modellen en providers.