Skip to main content

Documentation Index

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

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

NVIDIA 在 https://integrate.api.nvidia.com/v1 提供 OpenAI 兼容 API,可免费使用开放模型。使用来自 build.nvidia.com 的 API key 进行身份验证。

入门指南

1

获取你的 API key

build.nvidia.com 创建 API key。
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
如果你传入 --nvidia-api-key 而不是环境变量,该值会落入 shell 历史记录和 ps 输出。尽可能优先使用 NVIDIA_API_KEY 环境变量。
对于非交互式设置,你也可以直接传入密钥:
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-super-120b-a12b" },
    },
  },
}

内置目录

模型引用名称上下文最大输出
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 环境变量后,提供商会自动启用。除了该密钥之外,不需要显式提供商配置。
内置目录是静态的。由于 NVIDIA 目前为列出的模型提供免费 API 访问,源代码中的费用默认值为 0
NVIDIA 使用标准的 /v1 completions 端点。任何 OpenAI 兼容工具都应能与 NVIDIA base URL 开箱即用地配合使用。
一些由 NVIDIA 托管的自定义模型在发出首个响应分块之前,可能会比默认模型空闲看门狗等待更长时间。对于自定义 NVIDIA 提供商条目,请提高提供商超时时间,而不是提高整个智能体运行时超时时间:
{
  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 模型目前可免费使用。请查看 build.nvidia.com 获取最新的可用性和速率限制详情。

相关内容

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

智能体、模型和提供商的完整配置参考。