问题描述
在 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 文档。
环境信息
复现步骤
- 在网络受限的沙盒环境中
- 执行 ============================================
minimax-docx Setup & Initialization
2026-03-25 23:32:57
============================================
Platform: macos (arm64), Package Manager: brew
�[0;34m=== Checking .NET SDK ===�[0m
�[0;34m[INFO]�[0m 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 的用户都会遇到此问题。这是一个高优先级的基础设施问题。
问题描述
在 minimax-docx skill 的部署过程中,setup.sh 脚本会执行 ,需要从 下载 等 NuGet 包。
在某些受限网络环境(沙盒、内网)中, 域名会被 DNS 劫持到私有地址(如 ),导致 NuGet 包下载失败, 永远无法完成,进而安装脚本报 "Status: NOT READY"。
错误日志
受影响场景
即使终端用户的 VPN 正常,也无法绕过沙盒层的 DNS 劫持。
建议解决方案
方案一:提供 NuGet 国内镜像配置选项
在 中添加国内镜像源(如 nuget.org 的 Azure 中国镜像或其他可靠镜像),让用户在网络受限环境下可以选择替代源:
方案二:预先打包依赖(离线安装)
将 等核心依赖包预先下载好,放在 skill 仓库的 或 目录下:
setup.sh 检测到离线包存在时,优先使用本地包:
方案三:使用 Node.js 替代 .NET(文档生成场景)
对于纯文档生成场景(DOCX/Word),可以提供一套 Node.js + docx 的纯 JS 实现,不依赖 .NET 和 NuGet,彻底规避网络问题:
目前测试下来,Node.js + cnpm 的方案在沙盒环境中完全可用,已成功生成 Word 文档。
环境信息
复现步骤
minimax-docx Setup & Initialization
2026-03-25 23:32:57
============================================
Platform: macos (arm64), Package Manager: brew
�[0;34m=== Checking .NET SDK ===�[0m
�[0;34m[INFO]�[0m 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 的用户都会遇到此问题。这是一个高优先级的基础设施问题。