nemoclaw-user-deploy-remote

将 NemoClaw 部署到远程 GPU 实例

注意事项

• nemoclaw deploy 命令已弃用。
• 在 Brev 上，在可启动环境配置中设置 CHAT_UI_URL，以便安装程序构建沙盒映像时能够使用该变量。

前置条件

• 已安装并完成身份验证的 Brev CLI。
• 用于入门设置期间所选推理后端的提供商凭据。
• 如果远程 vLLM 或 Hugging Face 工作流需要访问受限模型，请导出 HF_TOKEN 或 HUGGING_FACE_HUB_TOKEN。
• 如果计划使用已弃用的 nemoclaw deploy 封装命令，请在本地安装 NemoClaw。否则，在远程主机完成配置后，直接在该主机上安装 NemoClaw。

通过 Brev 在远程 GPU 实例上运行 NemoClaw。 推荐的方式是先配置虚拟机，在该主机上运行标准 NemoClaw 安装程序，然后运行 nemoclaw onboard。

快速开始

如果 Brev 实例已启动，并且已完成入门设置并创建沙盒，请从标准沙盒聊天流程开始：

$ nemoclaw my-assistant connect
$ openclaw tui

这会先让你进入沙盒 Shell，然后立即打开 OpenClaw 聊天 UI。 如果虚拟机是全新的，请先在该主机上运行标准安装程序，然后运行 nemoclaw onboard，再尝试运行 nemoclaw my-assistant connect。

如果你要从本地计算机连接，并且仍需配置远程虚拟机，仍可使用 nemoclaw deploy <instance-name>，按照下文所述的旧版兼容流程进行操作。

部署实例

警告：

nemoclaw deploy 命令已弃用。 建议单独配置远程主机，然后在该主机上运行标准 NemoClaw 安装程序和 nemoclaw onboard。

创建 Brev 实例并运行旧版兼容流程：

$ nemoclaw deploy <instance-name>

将 <instance-name> 替换为远程实例的名称，例如 my-gpu-box。 远程虚拟机上创建的沙盒使用 NEMOCLAW_SANDBOX_NAME 指定的名称；如果未设置该变量，则使用 my-assistant。 沙盒名称必须全部小写，以字母开头，只能包含字母、数字和内部连字符，并以字母或数字结尾。 部署封装命令会在配置 Brev 实例、建立 SSH 连接或启动远程安装程序之前验证沙盒名称。

旧版兼容流程会在虚拟机上执行以下步骤：

1. 如果存在 GPU，则安装 Docker 和 NVIDIA Container Toolkit。
2. 安装 OpenShell CLI。
3. 运行 nemoclaw onboard（设置向导），以创建网关、注册提供商并启动沙盒。
4. 如果 cloudflared 可用，则启动可选的主机辅助服务（例如 cloudflared 隧道）。通道消息传递会在入门设置期间进行配置，并通过 OpenShell 管理的进程运行，而不是通过 nemoclaw tunnel start 运行。

默认情况下，兼容封装命令会请求 Brev 在 gcp 上配置实例。如果需要其他 Brev 云提供商，请通过 NEMOCLAW_BREV_PROVIDER 覆盖此设置。 如果导出了 HF_TOKEN 或 HUGGING_FACE_HUB_TOKEN，封装命令会将这些值转发到虚拟机，以便远程设置能够拉取受限的 Hugging Face 模型仓库。

连接到远程沙盒

部署完成后，部署命令会在远程沙盒内打开一个交互式 Shell。 关闭会话后，如需重新连接，请再次运行该命令：

$ nemoclaw deploy <instance-name>

监控远程沙盒

通过 SSH 连接到实例，然后运行 OpenShell TUI 以监控活动并批准网络请求：

$ ssh <instance-name> 'cd ~/nemoclaw && set -a && . .env && set +a && openshell term'

验证推理

在远程沙盒内运行测试 Agent 提示词：

$ openclaw agent --agent main -m "Hello from the remote sandbox" --session-id test

远程仪表板访问

NemoClaw 仪表板会将浏览器来源与构建沙箱映像时写入的允许列表进行校验。默认情况下，允许列表仅包含 http://127.0.0.1:18789。从远程浏览器访问仪表板时（例如通过 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 设备配对，因为仅使用浏览器的远程用户无法完成基于终端的配对。 任何能够访问已配置仪表板来源的设备都可以无需配对而连接，因此请避免在可通过互联网访问或共享网络的部署中公开该来源。

首次运行就绪等待时限

在远程 GPU 主机上，首次运行 nemoclaw onboard 通常是整个生命周期中最耗时的操作：沙箱映像会在本地构建并上传到 OpenShell 网关，上传过程可能会通过虚拟机的网络连接传输数百 MiB，之后才会开始等待就绪。 创建后的就绪等待时限默认为 180 秒（NEMOCLAW_SANDBOX_READY_TIMEOUT），该时限适用于缓存预热后的工作站级别部署，以下情况可能会超出此时限：

• 首次在 DGX Station 上运行大型量化模型（参数规模为 70B 及以上，使用 NVFP4 权重）。
• 本地映像构建缓存为空，且通过公共网络上传的云虚拟机。
• 首次部署 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 使用的主机和端口与映像构建时相同。 主机仅允许使用字母数字字符、点、连字符和冒号。 端口必须为数字（0-65535）。 onboard 之后更改代理需要重新运行 nemoclaw onboard。

GPU 配置

部署脚本使用 NEMOCLAW_GPU 环境变量选择 GPU 类型。 默认值为 a2-highgpu-1g:nvidia-tesla-a100:1。 如需使用不同的 GPU 配置，请在运行 nemoclaw deploy 之前设置此变量：

$ 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 网页界面部署 NemoClaw。
• 审查沙盒镜像安全控制、审计能力移除情况或查询运行时资源限制时，请加载 references/sandbox-hardening.md。该文档包含沙盒容器镜像加固参考资料，涵盖 Docker 能力和进程限制。

相关技能

• nemoclaw-user-manage-sandboxes — 设置消息渠道（使用 nemoclaw-user-manage-sandboxes 技能），通过 OpenShell 管理的渠道消息功能连接 Telegram、Discord 或 Slack
• nemoclaw-user-monitor-sandbox — 监控沙盒活动（使用 nemoclaw-user-monitor-sandbox 技能），了解沙盒监控工具
• nemoclaw-user-reference — 命令（使用 nemoclaw-user-reference 技能），查看完整的 deploy 命令参考