OpenClaw配置NVIDIA Build指南

2026-02-13 2026-05-15 约 1000 字预计阅读 2 分钟

核心配置原理

OpenClaw 通过配置 models.providers来接入 NVIDIA Build 平台。由于 NVIDIA Build 提供了 OpenAI 兼容的 API 端点，你可以直接将其配置为一个自定义提供商。

步骤 1：获取 NVIDIA API Key

访问 build.nvidia.com。
注册并登录账号。
点击右上角头像，进入 API Keys 页面。
点击 Generate API Key，复制生成的密钥（格式通常为 nvapi-xxxxx）。

步骤 2：修改 OpenClaw 配置文件

编辑配置文件 ~/.openclaw/openclaw.json（如果不存在，请运行 openclaw onboard初始化）。
或者在 web UI 界面：Config -> Settings ->选 RAW -> 编辑 -> Save

将以下 JSON 配置添加到文件的 models.providers部分：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
{
  "models": {
    "mode": "merge",
    "providers": {
      "nvidia-build": {
        "baseUrl": "https://integrate.api.nvidia.com/v1",
        "apiKey": "YOUR_NVIDIA_API_KEY_HERE", // 替换为你的密钥
        "api": "openai-completions",
        "models": [
          // 用户指定的模型
          {
            "id": "moonshotai/kimi-k2.5",
            "name": "Kimi K2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 8192
          },
          {
            "id": "z-ai/glm4.7",
            "name": "GLM 4.7",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 131072,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-ai/deepseek-v3.2",
            "name": "DeepSeek V3.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 131072,
            "maxTokens": 8192
          },
          // 推荐的顶级模型 1：Mixtral 8x22B Instruct
          {
            "id": "mistralai/mixtral-8x22b-instruct",
            "name": "Mixtral 8x22B Instruct",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 65536,
            "maxTokens": 8192
          },
          // 推荐的顶级模型 2：Nemotron 4 340B Instruct
          {
            "id": "nvidia/nemotron-4-340b-instruct",
            "name": "Nemotron 4 340B Instruct",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 4096,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "models": {
        // 设置默认使用的模型（可选）
        "nvidia-build/moonshotai/kimi-k2.5": {
          "alias": "kimi"
        }
      }
    }
  }
}

步骤 3：重启 OpenClaw 服务

保存配置文件后，重启 OpenClaw 网关以加载新的配置：

1
openclaw gateway restart

步骤 4：验证配置

运行以下命令查看模型列表，确认配置成功：

1
openclaw models list

你应该能看到列表中包含了 nvidia-build/moonshotai/kimi-k2.5等模型。

Mixtral 8x22B Instruct：MoE 架构，推理能力强，性价比高，适合通用任务。
Nemotron 4 340B Instruct：NVIDIA 自家旗舰模型，参数规模巨大，擅长复杂推理和指令遵循。

关键配置参数解释

baseUrl：NVIDIA Build 的 API 端点地址。
api：必须设置为 openai-completions，因为 NVIDIA Build 兼容 OpenAI API 格式。
id：必须与 NVIDIA Build 平台上的模型 ID 完全一致（包含组织前缀，如 moonshotai/）。
contextWindow：模型支持的上下文长度（token 数）。

注意事项

API Key 安全：请妥善保管你的 NVIDIA API Key，避免泄露。
模型可用性：部分模型可能需要特定的权限或配额，请确保你的 NVIDIA 账号有对应模型的访问权限。

原文链接： https://www.17you.com/programming/openclaw%E9%85%8D%E7%BD%AE%E5%85%8D%E8%B4%B9nvidia%E5%A4%A7%E6%A8%A1%E5%9E%8B/ 已复制！

编程和技术

寻找技术支持帮助和技术合伙人一起搞事。

请点击联系我

OpenClaw配置NVIDIA Build指南

核心配置原理

步骤 1：获取 NVIDIA API Key

步骤 2：修改 OpenClaw 配置文件

步骤 3：重启 OpenClaw 服务

步骤 4：验证配置

关键配置参数解释

注意事项

相关内容

目录