Setup Guide

NemoClaw Installation Guide

Last updated: April 1, 2026 · 15 min read

How to install NemoClaw

NemoClaw installs via a single curl | bash script on Linux and macOS with Docker. Windows users must first enable WSL2 and install the Docker Desktop backend before running the script. Minimum requirements are Docker Engine 24.0+ and 8 GB of RAM. After installation, connect an assistant with nemoclaw my-assistant connect and launch the UI with openclaw tui.

All Supported Platforms

Platform	Prerequisite	Install Command	Status
Linux	Docker Engine + 8 GB RAM	`curl -fsSL https://www.nvidia.com/nemoclaw.sh \| bash`	Primary
macOS (Apple Silicon)	Docker Desktop or Colima	`curl -fsSL https://www.nvidia.com/nemoclaw.sh \| bash`	Supported
Windows	WSL2 + Docker Desktop backend	`Run installer inside WSL2 terminal`	Supported
Ubuntu VM (Remote)	Ubuntu Server + 24 GB VRAM GPU	`curl -fsSL https://www.nvidia.com/nemoclaw.sh \| bash`	GPU Required
GitHub Codespaces	GitHub account	`Run installer in Codespace terminal`	Cloud

Alpha Warning: NemoClaw is pre-production alpha software. Do not deploy on systems handling sensitive production data. Review the known security gaps before any deployment.

Essential NemoClaw Commands

Command	Purpose
`curl -fsSL https://www.nvidia.com/nemoclaw.sh \| bash`	Install NemoClaw and all dependencies
`nemoclaw --version`	Verify successful installation and check version
`nemoclaw my-assistant connect`	Connect and initialize a named agent assistant
`openclaw tui`	Launch the OpenClaw interactive terminal UI
`nemoclaw status`	Check the status of all running agent sessions
`nemoclaw policy validate operator.yaml`	Validate an operator policy file before applying it
`nemoclaw logs --tail 100`	Stream the last 100 lines of the OpenShell audit log
`nemoclaw stop my-assistant`	Gracefully stop a running agent session

Install NemoClaw on Linux

Recommended

Prerequisites

✓ Docker Engine 24.0+
✓ 8 GB RAM minimum
✓ Ubuntu 22.04+ or Debian 12+

Step 1.Install Docker Engine

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

Step 2.Run the NemoClaw installer

curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

Step 3.Verify installation

nemoclaw --version

Step 4.Connect your first assistant

nemoclaw my-assistant connect

Step 5.Launch the OpenClaw terminal UI

openclaw tui

Install NemoClaw on macOS (Apple Silicon)

Supported

Prerequisites

✓ macOS 14 Sonoma+
✓ Docker Desktop 4.28+ or Colima 0.7+
✓ Xcode Command Line Tools

Step 1.Install Xcode developer tools

xcode-select --install

Step 2.Install Docker Desktop or Colima

# Option A: Docker Desktop (GUI)
brew install --cask docker

# Option B: Colima (lightweight)
brew install colima docker
colima start --cpu 4 --memory 8

Step 3.Run the NemoClaw installer

curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

Step 4.Connect an assistant

nemoclaw my-assistant connect

Install NemoClaw on GitHub Codespaces

Cloud

Prerequisites

✓ GitHub account
✓ Codespaces access (free tier available)
✓ Browser or VS Code

Step 1.Open a Codespace in the NemoClaw repo

# Fork the NVIDIA NemoClaw repository
# Click "Code" → "Codespaces" → "New codespace"

Step 2.Run the installer inside the Codespace terminal

curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

Step 3.Start a persistent agent session

nemoclaw my-assistant connect
openclaw tui

Installing NemoClaw on Windows?

Windows requires a dedicated setup path. You must first enable the Windows Subsystem for Linux (WSL2), install Ubuntu from the Microsoft Store, configure Docker Desktop to use the WSL2 backend, and then run the NemoClaw installer inside the WSL2 terminal. The full step-by-step guide covers every command in sequence.

Windows WSL2 Installation Guide →

Troubleshooting Common Install Errors

docker: command not found

Docker Engine is not installed or not in your PATH. Run the Docker install script and ensure /usr/local/bin is in your PATH.

nemoclaw: permission denied

The installer binary was downloaded without execute permissions. Run: chmod +x ~/.local/bin/nemoclaw

Error: insufficient memory — need 8192 MB, have X MB

Your Docker daemon's memory limit is too low. In Docker Desktop, go to Settings → Resources and increase memory to at least 8 GB.

connection refused on port 7867

The OpenShell runtime failed to start. Check your operator policy YAML for syntax errors using: nemoclaw policy validate operator.yaml

← Architecture

Architecture Docs

Windows Guide

NemoClaw on Windows →

Downloads

Download Scripts →