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
- The Brev CLI installed and authenticated.
- An NVIDIA API key from build.nvidia.com.
- NemoClaw installed locally. Follow the Quickstart install steps.
Deploy the Instance
Warning: The
nemoclaw deploycommand is experimental and may not work as expected.
Create a Brev instance and run the NemoClaw setup:
$ 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:
- Installs Docker and the NVIDIA Container Toolkit if a GPU is present.
- Installs the OpenShell CLI.
- Runs the nemoclaw setup to create the gateway, register providers, and launch the sandbox.
- 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:
$ nemoclaw deploy <instance-name>
Monitor the Remote Sandbox
SSH to the instance and run the OpenShell TUI to monitor activity and approve network requests:
$ 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:
$ 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:
$ export NEMOCLAW_GPU="a2-highgpu-1g:nvidia-tesla-a100:2"
$ nemoclaw deploy <instance-name>
Related Topics
- Set Up the Telegram Bridge to interact with the remote agent through Telegram.
- Monitor Sandbox Activity for sandbox monitoring tools.
- Commands for the full
deploycommand reference.