Guia de Instalação

Coloque o NemoClaw para Funcionar

Escolha o método de instalação que preferir. Todos levam à mesma stack segura de agentes.

checklist Requisitos do Sistema

javascript Node.js 20+

v20+ (recomendado v22). Instalado automaticamente pelo script de instalação via nvm, se não estiver presente.

computer OS

Ubuntu 22.04+ (recomendado). macOS via Colima/Docker Desktop. Windows via WSL2 + Docker Desktop.

deployed_code Container Runtime

Docker (Linux), Colima ou Docker Desktop (macOS), Docker Desktop com backend WSL (Windows). Podman no macOS ainda não é suportado.

memory RAM

Mínimo 8 GB, recomendado 16 GB

hard_drive Disk

Mínimo 20 GB livres, recomendado 40 GB

extension GPU

Opcional. Necessário para inferência local com Nemotron (8GB+ de VRAM). Sem GPU, a inferência é direcionada pela NVIDIA Cloud API.

Scripts de uma linha que implantam a stack completa. Indicado para a maioria dos usuários. Guia completo na documentação arrow_forward

Linux / macOS / WSL

Ubuntu 22.04+, macOS (Apple Silicon), Windows WSL2

$ curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
Funciona em Linux (Ubuntu 22.04+), macOS (Apple Silicon via Colima/Docker Desktop) e Windows (WSL2 + Docker Desktop). O script instala automaticamente o Node.js e executa nemoclaw onboard.

verified Verifique Sua Instalação

Execute estes comandos para confirmar que o NemoClaw foi instalado corretamente.

1
$ nemoclaw list

Lista todos os sandboxes do NemoClaw. Se o comando for reconhecido, o CLI está instalado corretamente.

2
$ nemoclaw onboard

Assistente interativo de configuração: cria um sandbox, define a inferência (Nemotron local ou NVIDIA Cloud API) e aplica as políticas de segurança.

settings Configuração Inicial

Após a instalação, o assistente de onboard orienta você em cada etapa. Veja o que cada passo faz.

1

Escolha Seus Modelos

Selecione entre Nemotron 3 Super 120B (local, privacidade total), Nemotron 3 Nano 4B (edge) ou modelos em nuvem (OpenAI, Anthropic). O Privacy Router cuida da seleção automática em tempo de execução.

2

Configure as Políticas de Privacidade

Defina quais categorias de dados ficam locais e quais podem seguir para modelos em nuvem. O padrão é privacidade máxima — tudo fica local.

3

Defina as Políticas de Rede

Configure as regras de tráfego de saída. O padrão é bloquear tudo. Libere domínios e APIs específicos que seu agente precisa acessar.

4

Teste Seu Sandbox

Rode um agente de teste dentro do sandbox OpenShell. Confirme que o isolamento, as políticas de rede e o roteamento de modelos estão funcionando.

.env — Toda a configuração fica armazenada em ~/.nemoclaw/config.yaml. Você pode editar esse arquivo diretamente. Consulte o guia de início rápido em /docs/get-started/quickstart para mais detalhes.

system_update_alt Atualizando o NemoClaw

Mantenha o NemoClaw atualizado para garantir as últimas correções de segurança e novos recursos. Guia de atualização e migração arrow_forward

npm
$ npm update -g nemoclaw
pnpm
$ pip install --upgrade nemoclaw
Git
$ cd NemoClaw && git pull && pip install -e .
Docker
$ docker pull ghcr.io/nvidia/nemoclaw:latest && docker restart nemoclaw

Confira o changelog em github.com/NVIDIA/NemoClaw/releases para ver as novidades de cada versão.

delete_forever Desinstalando o NemoClaw

Caso precise remover o NemoClaw do seu sistema, siga os passos referentes ao método de instalação utilizado. Passos detalhados para desinstalação arrow_forward

npm
$ npm uninstall -g nemoclaw
pnpm
$ pip uninstall nemoclaw
Git (Source)
$ rm -rf ~/NemoClaw
Docker
$ docker stop nemoclaw && docker rm nemoclaw && docker rmi ghcr.io/nvidia/nemoclaw:latest

Remover dados do usuário (opcional)

Isso apaga todos os seus blueprints, configurações de sandbox e dados de modelos. Faça backup de tudo que precisar antes de prosseguir.

macOS/Linux $ rm -rf ~/.nemoclaw
Windows PS> rmdir /s /q %USERPROFILE%\.nemoclaw

build Resolução de Problemas

Problemas frequentes e como resolvê-los. Mais dicas de resolução de problemas arrow_forward

Precisa de Ajuda?

Participe das Discussões no GitHub para obter suporte com instalação e resolução de problemas.

Fique Atualizado

Receba novidades sobre lançamentos do NemoClaw, alertas de segurança e notícias do ecossistema. Nada de spam — cancele quando quiser.