--- read_when: - Sie möchten offene Modelle in OpenClaw kostenlos verwenden - Sie müssen `NVIDIA_API_KEY` einrichten - Sie möchten Nemotron 3 Ultra über NVIDIA verwenden summary: Verwenden Sie die OpenAI-kompatible API von NVIDIA in OpenClaw title: NVIDIA x-i18n: generated_at: "2026-07-12T02:04:41Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: b5ac7bcc19400a661b2f2861a1dd4d2306c94e445783929e342e9184003314e9 source_path: providers/nvidia.md workflow: 16 --- 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](https://build.nvidia.com/settings/api-keys). 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 Erstellen Sie unter [build.nvidia.com](https://build.nvidia.com/settings/api-keys) einen API-Schlüssel. ```bash export NVIDIA_API_KEY="nvapi-..." openclaw onboard --auth-choice nvidia-api-key ``` ```bash openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b ``` Übergeben Sie den Schlüssel für eine nicht interaktive Einrichtung direkt: ```bash openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..." ``` Durch `--nvidia-api-key` wird der Schlüssel im Shell-Verlauf und in der Ausgabe von `ps` gespeichert. Verwenden Sie nach Möglichkeit die Umgebungsvariable `NVIDIA_API_KEY`. ## Konfigurationsbeispiel ```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" }, }, }, } ``` ## 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`](https://build.nvidia.com/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 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. 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. 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. 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: ```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` 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. 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: ```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" }, }, }, }, }, } ``` NVIDIA-Modelle können derzeit kostenlos verwendet werden. Aktuelle Informationen zur Verfügbarkeit und zu den Ratenbegrenzungen finden Sie unter [build.nvidia.com](https://build.nvidia.com/). ## Verwandte Themen Auswahl von Providern und Modellreferenzen sowie Konfiguration des Failover-Verhaltens. Vollständige Konfigurationsreferenz für Agenten, Modelle und Provider.