NVIDIA

NVIDIA는 build.nvidia.com에서 발급한 API 키로 인증하는 OpenAI 호환 API https://integrate.api.nvidia.com/v1을 통해 오픈 모델을 무료로 제공합니다. OpenClaw는 NVIDIA 제공자의 기본 모델로 장문 컨텍스트 에이전트 작업을 위한 NVIDIA의 총 550B/활성 55B 추론 모델인 Nemotron 3 Ultra를 사용합니다.

시작하기

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

openclaw models set nvidia/nvidia/nemotron-3-ultra-550b-a55b

비대화형 설정에서는 키를 직접 전달합니다.

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

구성 예시

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

주요 카탈로그

NVIDIA API 키가 구성되어 있으면 설정 및 모델 선택 경로에서 https://assets.ngc.nvidia.com/products/api-catalog/featured-models.json에 있는 NVIDIA의 공개 주요 모델 카탈로그를 가져와 결과를 24시간 동안 캐시합니다(처음 32개 항목을 무료 텍스트 입력 행으로 가져옴). 따라서 build.nvidia.com의 새로운 주요 모델은 OpenClaw 릴리스를 기다리지 않고 설정 및 모델 선택 화면에 표시됩니다. 실시간 피드를 사용할 수 있으면 NVIDIA 설정 중 처음 반환된 모델이 미리 선택된 옵션이 됩니다.

가져오기에는 assets.ngc.nvidia.com에 대한 고정 HTTPS 호스트 정책이 적용됩니다. NVIDIA API 키가 구성되지 않았거나 피드를 사용할 수 없거나 형식이 잘못된 경우 OpenClaw는 아래의 번들 카탈로그와 번들 기본값으로 대체합니다.

Nemotron 3 Ultra

Nemotron 3 Ultra는 OpenClaw의 기본 NVIDIA 모델입니다. NVIDIA의 nvidia/nemotron-3-ultra-550b-a55b 빌드 페이지에는 이 모델이 100만 토큰 컨텍스트 사양을 갖춘 무료 엔드포인트로 표시되어 있습니다.

번들 Ultra 행은 기본적으로 chat_template_kwargs: { enable_thinking: false, force_nonempty_content: true }를 전송하므로, 일반 채팅 출력에서 추론 텍스트가 노출되지 않고 표시되는 답변에 내용이 유지됩니다.

가장 뛰어난 기능의 NVIDIA 기본 모델이 필요하면 Ultra를 사용하세요. 더 작은 Nemotron 3 옵션을 원하면 Super를 계속 선택하고, NVIDIA 카탈로그에서 호스팅되는 타사 모델의 컨텍스트, 지연 시간 또는 동작이 더 적합하면 해당 모델 중 하나를 선택하세요.

번들 대체 카탈로그

선택 가능한 번들 행은 NVIDIA의 주요 모델 카탈로그를 스냅샷으로 저장한 것입니다. 사용 중단된 호환성 행은 정확한 참조로 계속 확인할 수 있지만 모델 선택기에는 표시되지 않습니다.

전체 호환성 카탈로그에는 기존 구성을 위해 배포된 다음 참조도 유지됩니다. 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. 이러한 모델은 정확한 참조로 계속 사용할 수 있지만 온보딩이나 모델 선택기에는 표시되지 않습니다.

고급 구성

{  agents: {    defaults: {      models: {        "nvidia/nvidia/nemotron-3-ultra-550b-a55b": {          params: {            chat_template_kwargs: { enable_thinking: true },            extra_body: { reasoning_budget: 16384 },          },        },      },    },  },}

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

관련 항목