#23·skills

[minimax-docx] 部署问题:api.nuget.org 在沙盒/内网环境下无法访问,导致安装失败

Author: PangTianHuaCreated Mar 25, 2026Updated Jul 13, 2026

问题描述

在 minimax-docx skill 的部署过程中,setup.sh 脚本会执行 ,需要从 下载 等 NuGet 包。

在某些受限网络环境(沙盒、内网)中, 域名会被 DNS 劫持到私有地址(如 ),导致 NuGet 包下载失败, 永远无法完成,进而安装脚本报 "Status: NOT READY"。

错误日志

受影响场景

  • OpenClaw 的 exec 沙盒环境(Sandbox):DNS 被劫持,api.nuget.org → 172.19.0.x
  • Claude Code(运行在相同基础设施上):同样无法访问 api.nuget.org
  • 任何使用相同沙盒 DNS 的 AI Agent 环境

即使终端用户的 VPN 正常,也无法绕过沙盒层的 DNS 劫持。

建议解决方案

方案一:提供 NuGet 国内镜像配置选项

在 中添加国内镜像源(如 nuget.org 的 Azure 中国镜像或其他可靠镜像),让用户在网络受限环境下可以选择替代源:

方案二:预先打包依赖(离线安装)

将 等核心依赖包预先下载好,放在 skill 仓库的 或 目录下:

setup.sh 检测到离线包存在时,优先使用本地包:

方案三:使用 Node.js 替代 .NET(文档生成场景)

对于纯文档生成场景(DOCX/Word),可以提供一套 Node.js + docx 的纯 JS 实现,不依赖 .NET 和 NuGet,彻底规避网络问题:

目前测试下来,Node.js + cnpm 的方案在沙盒环境中完全可用,已成功生成 Word 文档。

环境信息

  • OS: macOS (Apple Silicon)
  • .NET SDK: 8.0.404 ✅ 已安装
  • 问题定位: DNS 劫持导致 api.nuget.org 不可达
  • 相关 issue: #22 #20 #19 等安装/部署相关问题

复现步骤

  1. 在网络受限的沙盒环境中
  2. 执行 ============================================ minimax-docx Setup & Initialization 2026-03-25 23:32:57

    Platform: macos (arm64), Package Manager: brew

=== Checking .NET SDK === [INFO] Installing .NET SDK... ==> Fetching downloads for: dotnet-sdk ==> Installing Cask dotnet-sdk ==> Running installer for dotnet-sdk with sudo (which may request your password)... ==> Purging files for version 10.0.201 of Cask dotnet-sdk 3. 观察 阶段失败,报 NU1301 错误

影响范围

所有在受限网络环境下(企业内网、AI Agent 沙盒等)安装 minimax-docx 的用户都会遇到此问题。这是一个高优先级的基础设施问题。