From 929f13b11f554662ecb3a2351d462f833e23fb5a Mon Sep 17 00:00:00 2001
From: bizwings <vincent@bizwingsinc.com>
Date: Fri, 3 Jul 2026 15:03:10 +0800
Subject: [PATCH] =?UTF-8?q?docs(BIZ-76):=20Metapi=20NVIDIA=E7=BD=91?=
 =?UTF-8?q?=E5=85=B3=E5=88=87=E6=8D=A2=E9=85=8D=E7=BD=AE=E6=8C=87=E5=8D=97?=
 =?UTF-8?q?=E5=BD=92=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: multica-agent <github@multica.ai>
---
 docs/Metapi_NVIDIA网关切换配置指南.md | 71 +++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 docs/Metapi_NVIDIA网关切换配置指南.md

diff --git a/docs/Metapi_NVIDIA网关切换配置指南.md b/docs/Metapi_NVIDIA网关切换配置指南.md
new file mode 100644
index 0000000..7f85638
--- /dev/null
+++ b/docs/Metapi_NVIDIA网关切换配置指南.md
@@ -0,0 +1,71 @@
+# OpenClaw NVIDIA 网关切换至 Metapi — 配置修改指南
+
+> 交付人：严维序（opengineer） | 交付日期：2026-07-03 | 关联Issue：BIZ-76
+
+## 当前状态
+
+你的 `openclaw.json` 中有 **12 个 NVIDIA 独立提供者**，每个直连 `https://integrate.api.nvidia.com/v1`，使用各自的 `nvapi-*` API Key。
+
+Metapi 已部署在 http://192.168.1.99:4000，内部聚合了全部 12 个 NVIDIA 账号，通过代理令牌 `sk-bizwings-metapi-proxy` 对外提供统一的 `/v1` 端点，自动负载均衡。
+
+## 方案 A：逐项修改（保留 12 个提供者结构）
+
+对每个 NVIDIA 提供者做两处替换：
+
+### 1. 修改 `baseUrl`
+```
+"baseUrl": "https://integrate.api.nvidia.com/v1"
+→ "baseUrl": "http://192.168.1.99:4000/v1"
+```
+
+### 2. 修改 `apiKey`
+```
+"apiKey": "nvapi-xxx..."
+→ "apiKey": "sk-bizwings-metapi-proxy"
+```
+
+## 方案 B：合并为单个提供者（推荐，精简配置）
+
+将 12 个 NVIDIA 提供者合并为 1 个：
+
+```json
+{
+  "id": "nvidia-metapi",
+  "name": "NVIDIA via Metapi",
+  "kind": "openai",
+  "baseUrl": "http://192.168.1.99:4000/v1",
+  "apiKey": "sk-bizwings-metapi-proxy",
+  "models": {
+    "deepseek-ai/deepseek-v4-flash": {},
+    "deepseek-ai/deepseek-v4-pro": {},
+    "z-ai/glm-5.1": {},
+    "z-ai/glm-5.2": {},
+    "qwen/qwen3.5-397b-a17b": {},
+    "nvidia/llama-3.3-nemotron-super-49b-v1": {},
+    "nvidia/mississippi": {}
+  }
+}
+```
+
+Metapi 已部署信息：
+- 访问地址：http://192.168.1.99:4000
+- 管理员令牌：`bizwings-metapi-admin`
+- 代理令牌：`sk-bizwings-metapi-proxy`
+- 端口：4000
+
+## 12 个 NVIDIA 账户清单
+
+| # | 账号 | 状态 |
+|---|------|------|
+| 1 | NVIDIA-NIM-default | ✅ active |
+| 2 | NVIDIA-NIM-98053 | ✅ active |
+| 3 | NVIDIA-NIM-liuweicheng84 | ✅ active |
+| 4 | NVIDIA-NIM-vx18088980513 | ✅ active |
+| 5 | NVIDIA-NIM-vx64391942 | ✅ active |
+| 6 | NVIDIA-NIM-cgtest1 | ✅ active |
+| 7 | NVIDIA-NIM-cgtest2 | ✅ active |
+| 8 | NVIDIA-NIM-cgtest3 | ✅ active |
+| 9 | NVIDIA-NIM-15876517651 | ✅ active |
+| 10 | NVIDIA-NIM-19584586741 | ✅ active |
+| 11 | NVIDIA-NIM-18874954146 | ✅ active |
+| 12 | NVIDIA-NIM-2405483110 | ✅ active |