⚡

NeMoRelay安装Skill nemo-relay-install

本技能用于安装 NVIDIA NeMo Relay，支持 CLI、Python/Node.js/Rust 语言包以及 LangChain、OpenClaw、Hermes 等受维护框架集成。涵盖安装路径选择、验证、Codex Desktop 连续性保护和 doctor 诊断。关键词：NeMo Relay、安装、CLI、语言包、框架集成、智能体工具、Codex Desktop、透明运行、doctor 诊断

智能体工具 0 次安装 0 次浏览 更新于 9/7/2026
名称 nemo-relay-install
描述 在选择或运行针对 CLI、Python、Node.js、Rust、OpenClaw、Hermes 或受维护框架集成的 NeMo Relay 安装时使用此技能，适用于运行时配置或快速开始设置之前。
开源协议 Apache-2.0 metadata:
作者 NVIDIA Corporation and Affiliates

安装 NeMo Relay

根据用户的预期结果选择包或可执行文件。安装并完成基本可用性检查后即停止。不要配置运行时行为、编写 plugins.toml、创建作用域、注册中间件，或在本技能中构建第一个应用示例。将安装与首次使用时的接入配置分开。

选择安装路径

如果用户要求安装 NeMo Relay 但未标识目标或预期结果，请在给出命令前先问一个简短澄清问题：

您需要哪种安装路径：用于编码代理/本地网关使用的 CLI、用于 Python/Node.js/Rust 应用的语言包，还是用于 LangChain、LangGraph、Deep Agents、OpenClaw 或 Hermes 的框架集成？

当用户已经指定 CLI、语言、框架、工具、源代码检出或目标项目文件（如 pyproject.toml、package.json 或 Cargo.toml）时，不要询问。

按从最不特定到最应用特定的顺序使用：

  1. CLI：用于通用的“试用 Relay”请求、临时编码代理运行、本地网关或明确的持久主机插件设置。阅读 CLI 安装。
  2. 受维护集成：当用户已经使用 OpenClaw、Hermes、LangChain、LangGraph 或 Deep Agents 时。阅读 受维护集成安装。
  3. 语言包：当 Python、Node.js 或 Rust 应用直接拥有其工具或模型调用点时。阅读 语言包安装。
  4. 源代码检出：仅用于贡献者或未发布的更改。遵循仓库开发指南，而不是已发布包的命令。

对于“试用 Relay”请求，默认使用 CLI 和临时透明运行。不要将持久主机插件安装设为默认。

保护 Codex Desktop 连续性

在持久 Codex 安装之前，确定用户是否正在从 Codex Desktop 操作。持久 nemo-relay install codex 会更改活动的 Codex 提供方，并可能使当前或较旧的 Desktop 线程在重启后看起来缺失，因为上游提供方过滤错误。线程不会被删除。

对于 Codex Desktop 用户：

  1. 首先推荐临时透明运行。
  2. 如果用户仍想要持久安装，请阅读 CLI 安装 中的 Codex Desktop 部分。
  3. 预览安装和建议的恢复说明位置。
  4. 在写入恢复说明或全局 Codex 配置之前获得确认。
  5. 在运行持久安装程序之前，将 assets/codex-desktop-recovery.md 作为 NEMO_RELAY_CODEX_DESKTOP_RECOVERY.md 生成到用户工作区根目录。
  6. 在用户获得恢复文件路径之前，不要重启 Codex Desktop。

不要直接检查、复制、删除、编辑或重写 Codex 会话文件、私有应用程序配置或 SQLite 状态，以规避可见性 bug。受支持的 nemo-relay 安装、卸载和 doctor 命令可以管理 Relay 生成的提供方和钩子配置。

安装并验证

  1. 在任何更改前检查目标清单、环境、操作系统、架构和现有安装。
  2. 仅加载所选路径的参考文档。
  3. 保留项目现有的包管理器和虚拟环境。
  4. 使用最新的兼容版本，除非用户或项目要求确切版本。
  5. 在运行远程安装程序或更改项目清单之前，显示确切的安装命令。
  6. 仅运行所选路径的基本可用性检查。
  7. 报告安装了什么、安装在哪里以及验证结果。然后停止。

主要文档化的语言路径是 Rust、Python 和 Node.js。将 Go 和原生 FFI 视为源代码优先的高级面积，而非普通包安装。不要将第一个作用域、订阅者、网关、插件配置或 LLM 调用视为安装验证。

使用 Doctor 检查 CLI 就绪性和配置问题

了解 nemo-relay doctor，但在正确范围内使用：

  • 当用户安装 CLI 并报告配置、网关、代理就绪性、插件、导出器或模型定价问题时，运行 nemo-relay doctor。
  • 当结构化输出将帮助代理以编程方式检查检查项时，使用 nemo-relay doctor --json。
  • 仅对持久主机插件安装使用 nemo-relay doctor --plugin claude-code、nemo-relay doctor --plugin codex 或 nemo-relay doctor --plugin all。
  • 不要要求对透明运行进行插件 doctor。透明运行设置不需要持久主机插件状态。
  • 不要使用 doctor 作为 Python、Node.js 或 Rust 包依赖已安装的证明。使用语言包管理器/导入检查来验证这些。

当 doctor 报告失败时，总结失败的检查及其建议的具体补救措施。不要循环重新安装每个包，除非失败的检查指向损坏或缺失的安装。

安装后交接

根据用户的直接结果选择下一个工作流程：

  • 对于第一个工作作用域、工具调用、LLM 调用或试用插件设置，请使用 nemo-relay-get-started。
  • 对于本地 CLI 主机插件工作流，使用 NeMo Relay CLI 文档或主机特定设置，而非应用程序运行时设置。
  • 对于运行时配置、插件文件、可观测性或自适应行为，使用匹配的插件或工具技能。

常见错误

避免这些安装范围内的错误：

  • 当用户只需要已发布包时，使用仓库开发设置。
  • 在用户需要应用绑定时安装 CLI，或用户只需要本地 nemo-relay 可执行文件时安装绑定。
  • 将持久主机插件安装视为尝试 Relay 的默认方式，而不是从临时透明运行开始。
  • 固定旧版本，除非用户或项目明确要求该版本。
  • 在安装步骤已验证之前，继续深入 plugins.toml、中间件注册、作用域或快速开始示例。

要参考的公共文档

使用这些公共入口点确认当前安装指南：