OpenClaw NVIDIA NIM API 配置指南

本指南详细说明如何在 OpenClaw 中配置 NVIDIA NIM (NVIDIA Inference Microservices) 模型。

目录

• 配置文件位置
• 快速开始
• 配置结构说明
• 添加新模型步骤
• 可用模型列表
• 常见问题

---

配置文件位置

OpenClaw 的主配置文件位于：

~/.openclaw/openclaw.json

Windows 系统路径：

C:\Users\<用户名>\.openclaw\openclaw.json

---

快速开始

只需在 openclaw.json 中添加以下三处配置即可使用 NVIDIA NIM 模型：

{
  "env": {
    "NVIDIA_API_KEY": "nvapi-<your-api-key>"
  },
  "models": {
    "providers": {
      "nvidia": {
        "baseUrl": "https://integrate.api.nvidia.com/v1",
        "apiKey": "$env:NVIDIA_API_KEY",
        "models": [
          { "id": "openai/gpt-oss-120b", "name": "GPT-OSS-120B" }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "nvidia/openai/gpt-oss-120b"
      },
      "models": {
        "nvidia/openai/gpt-oss-120b": {
          "alias": "GPT-OSS-120B"
        }
      }
    }
  }
}

---

配置结构说明

1. API 密钥 (env)

{
  "env": {
    "NVIDIA_API_KEY": "nvapi-<your-api-key>"
  }
}

获取 Key: https://build.nvidia.com → 点击 "Get API Key"

2. 模型提供商 (models.providers.nvidia)

必填字段：

字段	说明	示例
baseUrl	NVIDIA NIM API 地址	https://integrate.api.nvidia.com/v1
apiKey	API Key 引用	$env:NVIDIA_API_KEY
models	模型列表数组	见下方

注意: baseUrl 和每个模型的 name 是必填字段，缺少会导致配置验证失败。

3. Agent 模型别名 (agents.defaults.models)

格式："nvidia/<模型id>": { "alias": "<简短名称>" }

---

添加新模型步骤

步骤 1: 获取模型 ID

在 NVIDIA NIM 确认模型 ID，例如 openai/gpt-oss-120b。

步骤 2: 添加到 models.providers.nvidia.models

{ "id": "openai/gpt-oss-120b", "name": "GPT-OSS-120B" }

最小配置只需要 id 和 name 两个字段。

步骤 3: 添加到 agents.defaults.models

"nvidia/openai/gpt-oss-120b": {
  "alias": "GPT-OSS-120B"
}

步骤 4: 重启 Gateway

openclaw gateway start

---

可用模型列表

大语言模型 (LLM)

模型 ID	名称	输入类型
openai/gpt-oss-120b	GPT-OSS-120B	text
qwen/qwen3.5-397b-a17b	Qwen3.5-397B	text, image
qwen/qwen3-coder-480b-a35b-instruct	Qwen3-Coder	text
moonshotai/kimi-k2.5	Kimi-K2.5	text, image
minimaxai/minimax-m2.5	MiniMax-M2.5	text, image
z-ai/glm5	GLM-5	text, image
z-ai/glm4.7	GLM-4.7	text, image
deepseek-ai/deepseek-v3.2	DeepSeek-V3.2	text
deepseek-ai/deepseek-v3.1-terminus	DeepSeek-V3.1	text
mistralai/mistral-large-3-675b-instruct-2512	Mistral-Large3	text
llama-3.1-nemotron-ultra-253b-v1	Nemotron-Ultra	text
stepfun-ai/step-3.5-flash	Step-3.5	text, image

查询最新模型: https://build.nvidia.com/explore/discover

---

常见问题

Q: 启动报错 models.providers.nvidia.baseUrl: expected string, received undefined

原因: models.providers.nvidia 缺少 baseUrl 字段。

修复: 添加 baseUrl:

"nvidia": {
  "baseUrl": "https://integrate.api.nvidia.com/v1",
  ...
}

Q: 启动报错 models.providers.nvidia.models.N.name: expected string, received undefined

原因: 模型列表中某个条目缺少 name 字段。

修复: 每个模型必须包含 id 和 name:

{ "id": "openai/gpt-oss-120b", "name": "GPT-OSS-120B" }

Q: 运行时报错 Unknown model: nvidia/openai/gpt-oss-120b

原因: 模型在 agents.defaults.models 中被引用，但未在 models.providers.nvidia.models 中注册。

修复: 确保两处都配置了该模型：

1. models.providers.nvidia.models 中添加 { "id": "openai/gpt-oss-120b", "name": "..." }
2. agents.defaults.models 中添加别名

Q: 如何切换默认模型？

修改 agents.defaults.model.primary:

"model": {
  "primary": "nvidia/qwen/qwen3.5-397b-a17b"
}

---

相关资源

• NVIDIA NIM 官网
• NVIDIA NIM API 文档
• OpenClaw 官网

License

MIT License