Przejdź do głównej treści
NVIDIA udostępnia API zgodne z OpenAI pod adresem https://integrate.api.nvidia.com/v1 dla otwartych modeli za darmo. Uwierzytelnij się kluczem API z build.nvidia.com. OpenClaw domyślnie ustawia dostawcę NVIDIA na Nemotron 3 Ultra, model rozumowania NVIDIA o 550B łącznie / 55B aktywnych parametrów, przeznaczony do długokontekstowej pracy agentowej.

​
Pierwsze kroki

1

Uzyskaj klucz API

Utwórz klucz API na build.nvidia.com.
2

Wyeksportuj klucz i uruchom onboarding

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

Ustaw model NVIDIA

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b
Jeśli przekażesz --nvidia-api-key zamiast zmiennej środowiskowej, wartość trafi do historii powłoki i wyniku ps. Gdy to możliwe, preferuj zmienną środowiskową NVIDIA_API_KEY.
W przypadku konfiguracji nieinteraktywnej możesz też przekazać klucz bezpośrednio: 
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

​
Przykład konfiguracji

{
  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 wyróżnionych modeli

Gdy skonfigurowany jest klucz API NVIDIA, ścieżki konfiguracji OpenClaw i wyboru modelu próbują użyć publicznego katalogu wyróżnionych modeli NVIDIA z https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json i buforują rankingowy wynik przez 24 godziny. Dzięki temu nowe wyróżnione modele z build.nvidia.com pojawiają się w powierzchniach konfiguracji i wyboru modelu bez czekania na wydanie OpenClaw. Gdy kanał na żywo jest dostępny, pierwszy zwrócony model jest domyślną opcją pokazywaną podczas konfiguracji NVIDIA. Pobieranie używa stałej polityki hosta HTTPS dla assets.ngc.nvidia.com. Jeśli nie skonfigurowano klucza API NVIDIA albo jeśli ten publiczny katalog jest niedostępny lub nieprawidłowo sformatowany, OpenClaw wraca do dołączonego katalogu i dołączonej wartości domyślnej poniżej.

​
Nemotron 3 Ultra

Nemotron 3 Ultra jest domyślnym modelem NVIDIA w OpenClaw. Strona build NVIDIA dla nvidia/nemotron-3-ultra-550b-a55b wymienia go jako dostępny darmowy endpoint ze specyfikacją kontekstu 1M tokenów. Dołączony katalog zapisuje maksymalne wyjście 16 384 tokenów, aby odpowiadać bieżącemu przykładowemu żądaniu NVIDIA zgodnemu z OpenAI dla hostowanego endpointu. Użyj Ultra jako domyślnej opcji NVIDIA o najwyższych możliwościach. Pozostaw wybrany Super, gdy chcesz mniejszą opcję Nemotron 3, albo wybierz jeden z modeli firm trzecich hostowanych w katalogu NVIDIA, gdy ich kontekst, opóźnienie lub zachowanie pasują lepiej. Dołączony wiersz Ultra domyślnie wysyła chat_template_kwargs.enable_thinking: false i force_nonempty_content: true, aby zwykłe wyjście czatu pozostawało w widocznej odpowiedzi zamiast ujawniać tekst rozumowania.

​
Dołączony katalog awaryjny

Odwołanie do modeluNazwaKontekstMaks. wyjścieUwagi
nvidia/nvidia/nemotron-3-ultra-550b-a55bNVIDIA Nemotron 3 Ultra 550B1,000,00016,384Domyślny
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B1,048,5768,192Wyróżniona opcja awaryjna
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192Wyróżniona opcja awaryjna
nvidia/minimaxai/minimax-m2.7Minimax M2.7196,6088,192Wyróżniona opcja awaryjna
nvidia/z-ai/glm-5.1GLM 5.1202,7528,192Wyróżniona opcja awaryjna
nvidia/minimaxai/minimax-m2.5MiniMax M2.5196,6088,192Przestarzały, zgodność aktualizacji
nvidia/z-ai/glm5GLM-5202,7528,192Przestarzały, zgodność aktualizacji

​
Konfiguracja zaawansowana

Dostawca włącza się automatycznie, gdy ustawiona jest zmienna środowiskowa NVIDIA_API_KEY. Poza kluczem nie jest wymagana jawna konfiguracja dostawcy.
OpenClaw preferuje publiczny katalog wyróżnionych modeli NVIDIA, gdy skonfigurowane jest uwierzytelnianie NVIDIA, i buforuje go przez 24 godziny. Dołączony katalog awaryjny jest statyczny i zachowuje przestarzałe wysłane odwołania ze względu na zgodność aktualizacji. Koszty domyślnie wynoszą 0 w źródle, ponieważ NVIDIA obecnie oferuje darmowy dostęp API do wymienionych modeli.
NVIDIA używa standardowego endpointu uzupełnień /v1. Każde narzędzie zgodne z OpenAI powinno działać od razu z bazowym adresem URL NVIDIA.
Przykładowe żądanie Ultra od NVIDIA używa chat_template_kwargs.enable_thinking i reasoning_budget dla wyjścia rozumowania. Dołączony wiersz Ultra w OpenClaw domyślnie wyłącza myślenie szablonu na potrzeby zwykłego czatu. Jeśli musisz włączyć wyjście rozumowania NVIDIA albo wymusić inne pola żądania specyficzne dla NVIDIA, ustaw parametry dla modelu i ogranicz nadpisania specyficzne dla dostawcy do modelu NVIDIA:
{
  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 jest końcowym nadpisaniem treści żądania zgodnego z OpenAI, więc używaj go tylko dla pól dokumentowanych przez NVIDIA dla wybranego endpointu.
Niektóre niestandardowe modele hostowane przez NVIDIA mogą potrzebować więcej czasu niż domyślny watchdog bezczynności modelu, zanim wyemitują pierwszy fragment odpowiedzi. W przypadku niestandardowych wpisów dostawcy NVIDIA zwiększ limit czasu dostawcy zamiast zwiększać limit czasu całego środowiska uruchomieniowego agenta:
{
  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" },
        },
      },
    },
  },
}
Modele NVIDIA są obecnie darmowe w użyciu. Sprawdź build.nvidia.com pod kątem najnowszej dostępności i szczegółów limitów szybkości.

​
Powiązane

Wybór modelu

Wybieranie dostawców, odwołań do modeli i zachowania przełączania awaryjnego.

Dokumentacja konfiguracji

Pełna dokumentacja konfiguracji agentów, modeli i dostawców.