ContextQMD
Back to Nemoclaw

page: "Deploy NemoClaw to a Remote GPU Instance with Brev

docs/deployment/deploy-to-remote-gpu.md

latest2.6 KB
Original Source
<!-- SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. SPDX-License-Identifier: Apache-2.0 -->

Deploy NemoClaw to a Remote GPU Instance

Run NemoClaw on a remote GPU instance through Brev. The deploy command provisions the VM, installs dependencies, and connects you to a running sandbox.

Prerequisites

Deploy the Instance

:::{warning} The nemoclaw deploy command is experimental and may not work as expected. :::

Create a Brev instance and run the NemoClaw setup:

console
$ nemoclaw deploy <instance-name>

Replace <instance-name> with a name for your remote instance, for example my-gpu-box.

The deploy script performs the following steps on the VM:

  1. Installs Docker and the NVIDIA Container Toolkit if a GPU is present.
  2. Installs the OpenShell CLI.
  3. Runs the nemoclaw setup to create the gateway, register providers, and launch the sandbox.
  4. Starts auxiliary services, such as the Telegram bridge and cloudflared tunnel.

Connect to the Remote Sandbox

After deployment finishes, the deploy command opens an interactive shell inside the remote sandbox. To reconnect after closing the session, run the deploy command again:

console
$ nemoclaw deploy <instance-name>

Monitor the Remote Sandbox

SSH to the instance and run the OpenShell TUI to monitor activity and approve network requests:

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

Verify Inference

Run a test agent prompt inside the remote sandbox:

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

GPU Configuration

The deploy script uses the NEMOCLAW_GPU environment variable to select the GPU type. The default value is a2-highgpu-1g:nvidia-tesla-a100:1. Set this variable before running nemoclaw deploy to use a different GPU configuration:

console
$ export NEMOCLAW_GPU="a2-highgpu-1g:nvidia-tesla-a100:2"
$ nemoclaw deploy <instance-name>