SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场nemoclaw-user-deploy-remote

nemoclaw-user-deploy-remote

部署与运维

查看项目

更新于 10-14 07:31

技能介绍

本技能说明如何将 NemoClaw 部署到远程 GPU 实例，主要针对通过 Brev 提供远程 VM 的使用方式。核心信息是：nemoclaw deploy 命令已废弃，首选路径是先单独准备远程主机，在该主机上运行标准 NemoClaw 安装程序，然后运行 nemoclaw onboard。

一、前置条件

  • 已安装并完成认证的 Brev CLI。
  • 你希望在 onboard 期间使用的推理后端的提供商凭据。
  • 当远程 vLLM 或 Hugging Face 工作流需要访问受限模型时，需导出 HF_TOKEN 或 HUGGING_FACE_HUB_TOKEN。
  • 若计划使用已废弃的 nemoclaw deploy 包装器，则需在本地安装 NemoClaw；否则在准备好远程主机后直接在该主机上安装 NemoClaw。

二、快速开始 如果 Brev 实例已启动并已完成 onboard 且带有沙箱，可直接使用标准沙箱聊天流程： $ nemoclaw my-assistant connect $ openclaw tui 这会先进入沙箱 shell，并立即打开 OpenClaw 聊天 UI。如果 VM 是全新的，需要先在该主机上运行标准安装程序并运行 nemoclaw onboard，再尝试 nemoclaw my-assistant connect。如果你从本地机器连接且仍需准备远程 VM，可以使用 nemoclaw deploy <instance-name> 作为下述旧版兼容路径。

三、部署实例 警告：nemoclaw deploy 命令已废弃。优先单独准备远程主机，然后在该主机上运行标准 NemoClaw 安装程序与 nemoclaw onboard。 创建 Brev 实例并运行旧版兼容流程： $ nemoclaw deploy <instance-name> 将 <instance-name> 替换为远程实例名称，例如 my-gpu-box。远程 VM 上创建的沙箱使用 NEMOCLAW_SANDBOX_NAME，未设置时默认使用 my-assistant。沙箱名称必须为小写、以字母开头、仅包含字母、数字和内部连字符，并以字母或数字结尾。deploy 包装器在准备 Brev 实例、打开 SSH 或启动远程安装程序之前会校验沙箱名称。 旧版兼容流程在 VM 上执行以下步骤：

  • 若存在 GPU，安装 Docker 和 NVIDIA Container Toolkit。
  • 安装 OpenShell CLI。
  • 运行 nemoclaw onboard（安装向导），创建网关、注册提供商并启动沙箱。
  • 当 cloudflared 可用时，启动可选的主机辅助服务（如 cloudflared 隧道）。频道消息在 onboard 期间配置，并通过 OpenShell 管理的进程运行，而不是通过 nemoclaw tunnel start。 默认情况下，兼容包装器请求 Brev 在 gcp 上准备资源；如需其他 Brev 云提供商，可通过 NEMOCLAW_BREV_PROVIDER 覆盖。如果导出 HF_TOKEN 或 HUGGING_FACE_HUB_TOKEN，包装器会将这些值转发到 VM，以便远程安装拉取受限的 Hugging Face 模型仓库。

四、连接到远程沙箱 部署完成后，deploy 命令会在远程沙箱内打开交互式 shell。会话关闭后要重新连接，请再次运行： $ nemoclaw deploy <instance-name>

五、监控远程沙箱 SSH 到实例并运行 OpenShell TUI 以监控活动并批准网络请求： $ ssh <instance-name> 'cd ~/nemoclaw && set -a && . .env && set +a && openshell term'

六、验证推理 在远程沙箱内运行测试代理提示： $ openclaw agent --agent main -m "Hello from the remote sandbox" --session-id test

七、远程 Dashboard 访问 NemoClaw Dashboard 会在构建时根据烘焙进沙箱镜像的允许列表验证浏览器来源。默认允许列表仅包含 http://127.0.0.1:18789。当从远程浏览器访问 Dashboard（例如通过 Brev 公共 URL 或 SSH 端口转发）时，在运行设置前将 CHAT_UI_URL 设置为浏览器将使用的来源： $ export CHAT_UI_URL="https://openclaw0-<id>.brevlab.com" $ nemoclaw deploy <instance-name> 对于 SSH 端口转发，来源通常是 http://127.0.0.1:18789（默认值），因此无需额外配置。 警告：在 Brev 上，请在可启动环境配置中设置 CHAT_UI_URL，以便在安装程序构建沙箱镜像时可用。如果在无头主机上未设置 CHAT_UI_URL，兼容包装器会打印警告。 NEMOCLAW_DISABLE_DEVICE_AUTH 也在镜像构建时评估。当 CHAT_UI_URL 指向非回环来源时，NemoClaw 会在生成的沙箱配置中禁用 OpenClaw 设备配对，因为仅通过浏览器的远程用户无法完成基于终端的配对。任何能访问所配置 Dashboard 来源的设备都可在未配对的情况下连接，因此请避免将该来源暴露在可访问互联网或共享网络的部署中。

八、首次运行就绪预算 在远程 GPU 主机上，第一次 nemoclaw onboard 通常执行生命周期中最慢的工作：沙箱镜像在本地构建并上传到 OpenShell 网关，在就绪等待开始之前，可能通过 VM 链路传输数百 MiB。创建后的就绪等待默认是 180 秒（NEMOCLAW_SANDBOX_READY_TIMEOUT），该值面向热缓存、工作站级别的 onboard，在以下情况可能被超出：

  • DGX Station 首次运行大型量化模型（70B+ 参数规模、NVFP4 权重）。
  • 本地镜像构建缓存为冷的云 VM，且上传经过公网。
  • 首次运行 onboard Brave Web Search 预设的主机（出站策略栈会增加启动工作）。 在重新运行 onboard 之前提高预算： $ export NEMOCLAW_SANDBOX_READY_TIMEOUT=600 $ nemoclaw onboard 如果 onboard 以 Sandbox '<name>' was created but did not become ready within 180s 结束，onboard 会先删除部分创建的沙箱，因此下一次提高预算的尝试会从干净状态开始。关于 onboard 更早期运行的推理探测预算，参见 NEMOCLAW_LOCAL_INFERENCE_TIMEOUT（使用 nemoclaw-user-configure-inference 技能）。

九、代理配置 NemoClaw 通过默认指向 10.200.0.1:3128 的网关代理路由沙箱流量。如果你的网络需要不同的代理，请在 onboard 前设置 NEMOCLAW_PROXY_HOST 和 NEMOCLAW_PROXY_PORT： $ export NEMOCLAW_PROXY_HOST=proxy.example.com $ export NEMOCLAW_PROXY_PORT=8080 $ nemoclaw onboard 这些值会在构建时烘焙进沙箱镜像。它们也会在创建沙箱期间转发到运行时容器，因此 /tmp/nemoclaw-proxy-env.sh 使用的 host 和 port 与镜像构建时一致。host 仅接受字母数字字符、点、连字符和冒号。port 必须为数字（0-65535）。onboard 之后更改代理需要重新运行 nemoclaw onboard。

十、GPU 配置 deploy 脚本使用 NEMOCLAW_GPU 环境变量来选择 GPU 类型。默认值为 a2-highgpu-1g:nvidia-tesla-a100:1。在运行 nemoclaw deploy 之前设置该变量以使用不同的 GPU 配置： $ export NEMOCLAW_GPU="a2-highgpu-1g:nvidia-tesla-a100:2" $ nemoclaw deploy <instance-name>

十一、参考文档

  • 当用户询问如何在 NemoClaw 下安装、构建或配置 OpenClaw 插件时，加载 references/install-openclaw-plugins.md。它解释了 OpenClaw 插件与 agent 技能的区别，并展示当前基于 Dockerfile 的工作流，用于将插件烘焙进 NemoClaw 沙箱。
  • 当用户想在不安装 CLI 的情况下尝试 NemoClaw，或询问如何在 Brev 上开始时，加载 references/brev-web-ui.md。它引导用户使用 Brev Web UI 部署 NemoClaw。
  • 当审查沙箱镜像安全控制、审计能力丢弃或查找运行时资源限制时，加载 references/sandbox-hardening.md。它包含沙箱容器镜像加固参考，涵盖 Docker 能力和进程限制。

十二、相关技能

  • nemoclaw-user-manage-sandboxes：设置消息频道，通过 OpenShell 管理的频道消息连接 Telegram、Discord 或 Slack。
  • nemoclaw-user-monitor-sandbox：监控沙箱活动，提供沙箱监控工具。
  • nemoclaw-user-reference：命令，提供完整的 deploy 命令参考。

限制与注意事项：nemoclaw deploy 已废弃，首选单独准备远程主机后运行标准安装程序与 onboard。CHAT_UI_URL 在非回环来源时会禁用设备配对，存在安全风险。代理更改需重新运行 onboard。具体 GPU 型号、云提供商与凭据由用户自行配置，本技能未提供更细的计费或平台条款信息。