【免费下载链接】NemoClawRun agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVIDIA OpenShell with managed inference项目地址https://gitcode.com/gh_mirrors/ne/NemoClaw点击查看免费下载导读本文围绕 NemoClaw 仓库中scripts/vendor/openshell-sdk/README.md所描述的 OpenShell SDK 归档目录展开讲解该仓库如何将 NVIDIA OpenShell 的nvidia/openshell-sdk0.0.116以“受审归档”的形式固化进源码树实现无 GitHub 凭据、无构建工具链的离线安装并在每次安装前后通过 SHA-512 完整性校验、锁文件一致性校验与公开导出导入校验来保证依赖不被替换。读完本文你将掌握OpenShell SDK 在 NemoClaw 中的引入方式、prepare/check两阶段校验的底层实现、npm run dev:setup与npm run dev:doctor的使用场景以及升级该 SDK 时应遵循的安全操作规范。一、OpenShell SDK 归档是什么scripts/vendor/openshell-sdk/目录承载的是经过评审reviewed的nvidia/openshell-sdk0.0.116软件包包含三个文件nvidia-openshell-sdk-0.0.116.tgz评审通过的 npm 归档tarball本体LICENSE从上游源码复制而来的 Apache-2.0 许可文本README.md本目录的说明文档即本文所依据的原始文档。该归档与仓库根目录package-lock.json中锁定的 GitHub Packages 下载 URL 和 SHA-512 完整性值完全一致其源码对应 NVIDIA/OpenShell 仓库的v0.0.116标签commit 为d1155aa70042d3e2ee49dbfa15346b108b7c1d92。也就是说这个.tgz不是随手打包的产物而是与上游标签、锁定 URL、完整性校验值三方对齐的受审快照。从仓库证据看这一身份在ci/reviewed-npm-audit.json中有明确登记artifactName为nvidia-openshell-sdk-0.0.116.tgzpackageSpec为nvidia/openshell-sdk0.0.116tarballUrl指向 GitHub Packages 的下载地址。而package.json的optionalDependencies中将nvidia/openshell-sdk精确钉在0.0.116。二、为什么需要把 SDK 归档进仓库OpenShell SDK 从 GitHub Packages 私有/受限源分发普通用户尤其是无 GitHub 凭据的安装环境无法直接拉取。NemoClaw 的做法是在发布评审阶段从上游获取归档并校验把归档连同package.json、package-lock.json、受审依赖钉扎reviewed dependency pins一起提交进仓库安装流程installer 与npm run dev:setup验证该归档、离线预填充 npm 缓存再执行常规依赖安装。这样一来用户不再需要 GitHub 凭据也不需要 SDK 的构建工具链。同时归档目录不包含任何凭据或 npm 配置文件npm元数据中将 SDK 保留为可选依赖optional dependency使不使用 SDK 的隔离 CI 任务可以正常跳过而安装器会显式把它包含进来并验证两个公开导入。值得强调的安全边界是如果验证、安装或任一公开 SDK 导入失败安装流程会直接中止而不是带着损坏的依赖继续。npm run dev:doctor则提供了一种“只检查、不安装、不连接网关”的轻量诊断方式。三、从零安装三步命令与执行原理按 README 给出的方式从仓库检出目录直接安装源码依赖只需三条命令node scripts/lib/openshell-sdk-install.mts prepare npm ci --ignore-scripts --prefer-offline --includeoptional --nvidia:registryhttps://npm.pkg.github.com node scripts/lib/openshell-sdk-install.mts check三个步骤各司其职步骤作用失败后果prepare读取归档、校验 SHA-512 完整性将其预填充进 npm 缓存供离线安装使用安装中止npm ci ...按锁文件执行干净安装--ignore-scripts禁止生命周期脚本--prefer-offline优先使用缓存--includeoptional显式包含可选依赖--nvidia:registry...以命令作用域指定 GitHub Packages 源安装中止check校验已安装 SDK 的身份与公开导出确认其确实可被加载安装中止3.1prepare归档校验与缓存预填充prepare由scripts/lib/openshell-sdk-install.mts实现。它首先调用pinnedIdentity()从三处拉取并交叉核对身份package.json中的optionalDependencies/dependencies必须是形如0.0.116的精确版本钉扎package-lock.json的node_modules/nvidia/openshell-sdk条目version、integrity、resolved必须与受审身份一致ci/reviewed-npm-audit.json中的受审身份artifactName必须为nvidia-openshell-sdk-version.tgz完整性必须是sha512-前缀。三者任何一处不一致都会抛出诸如OpenShell SDK package.json, package-lock.json, and reviewed identity must agree的错误。随后prepare调用scripts/lib/reviewed-npm-archive.mts的readReviewedNpmArchiveFile读取归档它要求归档必须是非符号链接的普通文件防止恶意链接替换并按需限制文件大小上限然后实时计算sha512-完整性并与预期值比对不一致立即失败。校验通过后脚本通过npm config get cache解析 npm 缓存目录必须是绝对路径再由stageReviewedArchiveWithNpm将归档预填充进缓存——这一步就是“离线种子”的来源。3.2npm ci的细节含义命令中的几个标志值得展开--ignore-scripts跳过依赖包的生命周期脚本降低供应链攻击面--prefer-offline优先使用本地缓存配合上一步的预填充实现离线安装--includeoptionalnpm 默认会尝试安装 optionalDependencies这里显式声明确保nvidia/openshell-sdk这类可选依赖被真正装上--nvidia:registryhttps://npm.pkg.github.com命令作用域command-scoped的 registry 设置让 npm 12 能识别锁文件中 GitHub Packages 的 URL而不会改动用户的全局/项目 npm 配置。README 特别说明普通公开 npm 依赖在没有缓存时仍需 registry 访问。3.3check导入级验证check并不只是“看目录在不在”。从 openshell-sdk-install.mts 的实现可以看到用realpathSync解析node_modules/nvidia/openshell-sdk读取其package.json校验name与version分别解析nvidia/openshell-sdk与nvidia/openshell-sdk/raw两个入口的真实路径确认解析结果位于已安装的 SDK 目录内防止被其它位置的同名包劫持实际动态导入两个公开导出OpenShellClient要求其connect是函数与SandboxPolicySchema要求存在。只有这两类导出都可用check才会输出OpenShell SDK version: import OK否则报错并提示运行npm run dev:setup。四、通过 npm 脚本与安装器接入除了手工三条命令日常开发与安装场景会自动走同一套校验。4.1npm run dev:setuppackage.json中dev:setup: bash scripts/dev-setup.sh, dev:doctor: bash scripts/dev-setup.sh --doctorscripts/dev-setup.sh在第 413–417 行以固定顺序执行prepare→npm install --includedev --ignore-scripts --prefer-offline --includeoptional --nvidia:registry...→check随后才继续安装插件依赖、构建 CLI 等后续步骤。任何一步失败都return 1整个开发环境初始化随之终止。4.2npm run dev:doctordev:doctor走scripts/dev-setup.sh --doctor分支。它只运行check第 638 行 附近不安装任何东西、不连接网关用于快速诊断已安装的 SDK 是否缺失、不兼容或无法加载——非常适合排查“明明装了却 import 失败”的场景。4.3 安装器installerscripts/install.sh在多个安装路径中复用了同一模式先openshell-sdk-install.mts prepare再npm install --ignore-scripts --prefer-offline --includeoptional --nvidia:registryhttps://npm.pkg.github.com最后check例如第 3194、3281、3328、3744 行附近。这说明最终用户安装 CLI 时同样享受受审归档带来的无凭据离线安装体验。五、升级 SDK 的安全操作规程README 对升级路径给出了严格约束任何维护者都应遵守从评审过的 registry 归档获取新版本替换nvidia-openshell-sdk-version.tgz并同步更新package.json版本钉扎、package-lock.jsonURL 与完整性以及受审依赖钉扎如ci/reviewed-npm-audit.json中的身份记录不要用本地重新打包的归档顶替——即使源码相同重新压缩产生的字节也可能与评审通过的校验值不同从而破坏完整性链条每次更新后运行 SDK 安装包合约installation package contract即上文的三步验证流程确保新版本身份、导入与安装全部通过当被钉扎的 SDK 可通过公开 npm registry获取时应移除本归档与缓存预填充步骤让依赖回归常规公开分发。升级失败时最常见的错误信息是OpenShell SDK package.json pin has no reviewed identity或package.json, package-lock.json, and reviewed identity must agree它们都指向同一件事版本钉扎与受审身份没有同步更新。六、受审 npm 基础设施更广的校验视角prepare/check只是 NemoClaw 受审 npm 依赖体系中的一环。scripts/lib/reviewed-npm-archive.mts是这套体系的核心模块它提供的能力包括verifyReviewedNpmMetadata通过npm view spec dist.integrity与dist.tarball与受审身份比对确认 registry 元数据一致packReviewedNpmArchive在临时目录中重新npm pack并核对归档文件名、SHA-512 完整性verifyReviewedNpmLock校验锁文件 SHA-256 摘要、根依赖约束、顶层包条目以及全部锁定包的 registry 来源与完整性verifyReviewedNpmCache用NPM_CONFIG_OFFLINEtrue、NPM_CONFIG_USERCONFIG/dev/null等环境隔离下验证缓存归档verifyInstalledNpmLock核对磁盘上每个已安装包的名称、版本要求安装目录为非符号链接目录。可以看到OpenShell SDK 归档的校验逻辑sha512 完整性、非符号链接文件、与锁文件交叉核对正是这套通用受审 npm 工具的定制化应用。它保证了scripts/vendor/openshell-sdk不是仓库中孤立的一份 tarball而是被完整审计链路覆盖的供应链组件。七、常见问题与排查指引现象含义处理方式OpenShell SDK is missing, incompatible, or cannot load. Run: npm run dev:setupcheck阶段导入或身份校验失败运行npm run dev:setup重新走 prepare → install → check或先用npm run dev:doctor快速诊断OpenShell SDK archive integrity mismatch归档字节与受审 sha512 不符核对归档是否被替换必要时按升级规程从受审源重新获取... lockfile ... must agreepackage.json、package-lock.json、受审身份三方不一致同步更新版本钉扎、锁文件与ci/reviewed-npm-audit.jsonnpm view ...元数据不一致registry 上的 dist 信息与受审身份不符确认 registry 源GitHub Packages与受审tarballUrl一致结语scripts/vendor/openshell-sdk/这一看似简单的归档目录背后是一套“受审归档 三方身份核对 导入级验证 离线缓存预填充”的完整供应链安全机制。它让 NemoClaw 在依赖 GitHub Packages 受限分发的 OpenShell SDK 时既保证了用户无凭据可安装又通过 SHA-512 与公开导出校验杜绝了依赖被替换的风险。对于需要在自己的项目中引入受限 registry 依赖的开发者这套prepare→npm ci→check的模式与dev:doctor的轻量诊断思路都值得直接借鉴。赞分享【免费下载链接】NemoClawRun agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVIDIA OpenShell with managed inference项目地址https://gitcode.com/gh_mirrors/ne/NemoClaw点击查看免费下载相关推荐NemoClaw PR Review Advisor 技术指南在 OpenShell 沙箱中构建 SDK 驱动的只读 PR 审查流水线NemoClaw PR Review Advisor 技术指南在 OpenShell 沙箱中构建 SDK 驱动的只读 PR 审查流水线 本文深入解析 NemoNVIDIA NemoClaw 参考栈在 OpenShell 沙箱中安全运行 AI Agent 的安装、配置与贡献指南NVIDIA NemoClaw 参考栈在 OpenShell 沙箱中安全运行 AI Agent 的安装、配置与贡献指南 NemoClaw 是 NVIDIA 开gh_mirrors/n1/n安装脚本安全审计防篡改与校验机制gh_mirrors/n1/n安装脚本安全审计防篡改与校验机制 引言安装脚本的安全痛点与防护价值 在开源项目的使用流程中安装脚本Install Scri开发工具CLI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
