Providers
NVIDIA
NVIDIA stellt offene Modelle kostenlos über eine OpenAI-kompatible API unter
https://integrate.api.nvidia.com/v1 bereit. Die Authentifizierung erfolgt mit einem API-Schlüssel von
build.nvidia.com. OpenClaw
verwendet für den NVIDIA-Provider standardmäßig Nemotron 3 Ultra, das Reasoning-Modell von NVIDIA
mit insgesamt 550 Milliarden und 55 Milliarden aktiven Parametern für agentenbasierte Aufgaben mit langem Kontext.
Erste Schritte
API-Schlüssel abrufen
Erstellen Sie unter build.nvidia.com einen API-Schlüssel.
Schlüssel exportieren und Onboarding ausführen
export NVIDIA_API_KEY="nvapi-..."openclaw onboard --auth-choice nvidia-api-keyEin NVIDIA-Modell festlegen
openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55bÜbergeben Sie den Schlüssel für eine nicht interaktive Einrichtung direkt:
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."Konfigurationsbeispiel
{ 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" }, }, },}Katalog der hervorgehobenen Modelle
Wenn ein NVIDIA-API-Schlüssel konfiguriert ist, rufen die Einrichtungs- und Modellauswahlpfade
den öffentlichen Katalog hervorgehobener NVIDIA-Modelle von
https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json ab und
speichern das Ergebnis 24 Stunden lang im Cache (die ersten 32 Einträge, importiert als Zeilen für
freie Texteingabe). Neue hervorgehobene Modelle von build.nvidia.com erscheinen dadurch in den
Einrichtungs- und Modellauswahloberflächen, ohne dass auf eine OpenClaw-Veröffentlichung gewartet werden muss. Wenn der
Live-Feed verfügbar ist, wird während der NVIDIA-Einrichtung das erste zurückgegebene Modell
vorab ausgewählt.
Der Abruf verwendet eine feste HTTPS-Hostrichtlinie für assets.ngc.nvidia.com. Wenn kein
NVIDIA-API-Schlüssel konfiguriert oder der Feed nicht verfügbar beziehungsweise fehlerhaft ist,
greift OpenClaw auf den nachfolgend aufgeführten integrierten Katalog und den integrierten Standardwert zurück.
Nemotron 3 Ultra
Nemotron 3 Ultra ist das standardmäßige NVIDIA-Modell in OpenClaw. Die Build-Seite von NVIDIA für
nvidia/nemotron-3-ultra-550b-a55b
führt es als verfügbaren kostenlosen Endpunkt mit einer Kontextgröße von einer Million Token auf.
Der integrierte Ultra-Eintrag sendet standardmäßig
chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true },
damit die normale Chat-Ausgabe in der sichtbaren Antwort verbleibt, anstatt
Reasoning-Text offenzulegen.
Verwenden Sie Ultra als leistungsfähigsten NVIDIA-Standard. Lassen Sie Super ausgewählt, wenn Sie die kleinere Nemotron-3-Option wünschen, oder wählen Sie eines der Drittanbietermodelle aus dem NVIDIA-Katalog, wenn dessen Kontext, Latenz oder Verhalten besser geeignet ist.
Integrierter Ausweichkatalog
Die auswählbaren integrierten Einträge bilden eine Momentaufnahme des Katalogs hervorgehobener NVIDIA-Modelle. Veraltete Kompatibilitätseinträge bleiben über ihre exakte Referenz auflösbar, werden jedoch nicht in der Modellauswahl angezeigt.
| Modellreferenz | Name | Kontext | Maximale Ausgabe |
|---|---|---|---|
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 |
Der vollständige Kompatibilitätskatalog enthält für bestehende Konfigurationen außerdem weiterhin diese
veröffentlichten Referenzen: nvidia/moonshotai/kimi-k2.5, nvidia/z-ai/glm-5.1,
nvidia/minimaxai/minimax-m2.5, nvidia/z-ai/glm5 und
nvidia/minimaxai/minimax-m2.7. Sie bleiben über ihre exakte Referenz verfügbar, erscheinen jedoch
weder beim Onboarding noch in der Modellauswahl.
Erweiterte Konfiguration
Automatische Aktivierung
Der Provider wird automatisch aktiviert, wenn die Umgebungsvariable NVIDIA_API_KEY
gesetzt ist oder während des Onboardings ein Schlüssel gespeichert wurde. Über den Schlüssel hinaus ist
keine explizite Provider-Konfiguration erforderlich.
Katalog und Preise
OpenClaw bevorzugt den öffentlichen Katalog hervorgehobener NVIDIA-Modelle, wenn die NVIDIA-Authentifizierung
konfiguriert ist, und speichert ihn 24 Stunden lang im Cache. Der integrierte auswählbare Ausweichkatalog ist eine
statische Momentaufnahme des Katalogs hervorgehobener NVIDIA-Modelle; veraltete, nur über exakte Referenzen verfügbare
Kompatibilitätseinträge werden in der Modellauswahl ausgeblendet. Die Kosten sind im Quellcode standardmäßig auf 0
gesetzt, da NVIDIA derzeit kostenlosen API-Zugriff auf die aufgeführten Modelle anbietet.
OpenAI-kompatibler Endpunkt
OpenClaw kommuniziert mit NVIDIA über den Adapter openai-completions und verwendet dabei die
standardmäßige Chat-Completions-Route unter /v1. Alle OpenAI-kompatiblen Werkzeuge sollten
mit der NVIDIA-Basis-URL ohne weitere Konfiguration funktionieren.
Reasoning-Parameter für Nemotron 3 Ultra
Die Ultra-Beispielanfrage von NVIDIA verwendet chat_template_kwargs.enable_thinking
und reasoning_budget für die Reasoning-Ausgabe. Der integrierte Ultra-Eintrag von OpenClaw
deaktiviert das Template-Reasoning standardmäßig für die normale Chat-Nutzung. Wenn Sie die
Reasoning-Ausgabe von NVIDIA aktivieren oder andere NVIDIA-spezifische Anfragefelder
erzwingen müssen, legen Sie modellspezifische Parameter fest und beschränken Sie Provider-spezifische Überschreibungen auf
das NVIDIA-Modell:
{ 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 wird mit bereits in der Anfrage vorhandenen chat_template_kwargs
zusammengeführt, anstatt das gesamte Objekt zu ersetzen.
params.extra_body ist die abschließende Überschreibung des OpenAI-kompatiblen Anfragekörpers
und überschreibt kollidierende Nutzlastschlüssel. Verwenden Sie diese Option daher nur für Felder, die NVIDIA
für den ausgewählten Endpunkt dokumentiert.
Langsame Antworten benutzerdefinierter Provider
Bei einigen von NVIDIA gehosteten benutzerdefinierten Modellen kann es länger dauern als die standardmäßigen etwa 120 Sekunden
des Leerlauf-Watchdogs für Modelle, bis sie den ersten Antwortblock ausgeben. Erhöhen Sie für benutzerdefinierte
NVIDIA-Provider-Einträge das Provider-Zeitlimit anstelle des Zeitlimits der gesamten
Agentenlaufzeit; timeoutSeconds gilt für HTTP-Anfragen des Providers und
erhöht die Obergrenze des Leerlauf-/Stream-Watchdogs für diesen Provider:
{ 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" }, }, }, }, },}