docs(BIZ-76): Metapi NVIDIA网关切换配置指南归档

Co-authored-by: multica-agent <github@multica.ai>
2026-07-03 15:03:10 +08:00
parent 3071a29313
commit 929f13b11f
1 changed files with 71 additions and 0 deletions
@@ -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 |