OpenClaw 通过 NVIDIA 的 OpenAI 兼容 API 提供免费开放模型访问，只需配置 NVIDIA_API_KEY 环境变量即可自动启用。使用 openclaw onboard --auth-choice nvidia-api-key 完成交互式设置，或直接通过 --nvidia-api-key 传递（注意 shell 历史安全风险）。内置模型包括 Nemotron、Kimi K2.5、Minimax M2.5 和 GLM5，默认上下文 262K token，输出 8K token。若自定义 NVIDIA 模型响应慢，可单独提升 provider timeout（300 秒），无需提高整个 agent 超时。

OpenClaw 接入 NVIDIA API 配置教程

NVIDIA 在 https://integrate.api.nvidia.com/v1 提供了与 OpenAI 兼容的 API，允许你免费使用多种开放模型。只需要一个 API Key 即可开始。

起步

获取 API Key

在 [build.nvidia.com](https://build.nvidia.com/settings/api-keys) 创建一个 API Key。

导出 Key 并运行 onboard

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

设置 NVIDIA 模型

```bash
openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b
```

WARNING

如果通过 --nvidia-api-key 参数传递 Key，该值会出现在 shell 历史和 ps 输出中，存在安全风险。优先使用 NVIDIA_API_KEY 环境变量。

如果是非交互式环境，也可以直接传递 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" },
    },
  },
}

内置模型列表

Model ref	Name	上下文	最大输出
nvidia/nvidia/nemotron-3-super-120b-a12b	NVIDIA Nemotron 3 Super 120B	262,144	8,192
nvidia/moonshotai/kimi-k2.5	Kimi K2.5	262,144	8,192
nvidia/minimaxai/minimax-m2.5	Minimax M2.5	196,608	8,192
nvidia/z-ai/glm5	GLM 5	202,752	8,192

高级配置

自动启用规则

设置 `NVIDIA_API_KEY` 环境变量后，该 provider 会自动启用，无需显式补充 provider 配置。

模型目录与定价

OpenClaw 内置的模型目录是静态的，价格默认设为 `0`，因为 NVIDIA 目前对列表中的模型提供免费 API 访问。

OpenAI 兼容端点

NVIDIA 使用标准 `/v1` completions 端点，任何与 OpenAI 兼容的工具都可以直接使用 NVIDIA 的 base URL。

自定义模型响应慢怎么解决

某些在 NVIDIA 上部署的自定义模型可能超过默认的 model idle watchdog 时间才能发出第一个响应 chunk。此时应该单独提升 provider 的超时，而不是提高整个 agent 运行时超时：

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

TIP

NVIDIA 模型当前免费使用。请查看 build.nvidia.com 了解最新可用性和速率限制。

常见问题

为什么 openclaw onboard --auth-choice nvidia-api-key 后没有自动设置模型？

onboard 只配置认证凭据，模型需要在 onboard 后手动设置，例如 openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b。也可以在 JSON 配置中直接指定 agents.defaults.model.primary。

NVIDIA API Key 报 401 或无法连接怎么办？

确认 Key 在 build.nvidia.com 有效，并使用环境变量 NVIDIA_API_KEY 导出。如果通过 --nvidia-api-key 传递，检查是否有特殊字符导致 shell 解析问题。另请确保 baseUrl 为 https://integrate.api.nvidia.com/v1。

自定义 NVIDIA 模型超时怎么办？

对于响应慢的自定义模型，按照“自定义模型响应慢怎么解决”中的配置，单独设置 timeoutSeconds: 300，并确保该 provider 的 apiKey 指向 NVIDIA_API_KEY。不要全局增加 agent 超时。