메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

NVIDIA는 오픈 모델을 무료로 사용할 수 있는 OpenAI 호환 API를 https://integrate.api.nvidia.com/v1에서 제공합니다. build.nvidia.com에서 발급한 API 키로 인증하세요.

시작하기

1

API 키 가져오기

build.nvidia.com에서 API 키를 생성합니다.
2

키 내보내기 및 온보딩 실행

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

NVIDIA 모델 설정

openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
env var 대신 --nvidia-api-key를 전달하면 값이 셸 기록과 ps 출력에 남습니다. 가능한 경우 NVIDIA_API_KEY 환경 변수를 사용하는 것이 좋습니다.
비대화형 설정의 경우 키를 직접 전달할 수도 있습니다.
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."

Config 예시

{
  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-super-120b-a12b" },
    },
  },
}

기본 제공 카탈로그

모델 ref이름컨텍스트최대 출력
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B262,1448,192
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192
nvidia/minimaxai/minimax-m2.5Minimax M2.5196,6088,192
nvidia/z-ai/glm5GLM 5202,7528,192

고급 구성

NVIDIA_API_KEY 환경 변수가 설정되어 있으면 provider가 자동으로 활성화됩니다. 키 외에는 명시적인 provider 구성이 필요하지 않습니다.
번들 카탈로그는 정적입니다. NVIDIA가 현재 나열된 모델에 대해 무료 API 액세스를 제공하므로 소스의 비용 기본값은 0입니다.
NVIDIA는 표준 /v1 completions endpoint를 사용합니다. 모든 OpenAI 호환 도구는 NVIDIA 기본 URL로 바로 작동해야 합니다.
일부 NVIDIA 호스팅 사용자 지정 모델은 첫 응답 청크를 내보내기 전에 기본 모델 idle watchdog보다 더 오래 걸릴 수 있습니다. 사용자 지정 NVIDIA provider 항목의 경우 전체 agent 런타임 timeout을 높이지 말고 provider timeout을 높이세요.
{
  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 모델은 현재 무료로 사용할 수 있습니다. 최신 사용 가능 여부와 rate-limit 세부 정보는 build.nvidia.com에서 확인하세요.

관련 항목

모델 선택

provider, 모델 ref, failover 동작 선택.

구성 참조

agent, 모델, provider에 대한 전체 config 참조.