Comandos

O NemoClaw oferece duas interfaces de comando. Os comandos do plugin rodam sob o namespace openclaw nemoclaw dentro do CLI do OpenClaw. O binário standalone nemoclaw lida com configuração no host, implantação e gerenciamento de serviços. Ambas as interfaces são instaladas quando você executa npm install -g nemoclaw.

Comandos do Plugin

openclaw nemoclaw launch

Inicialize o OpenClaw dentro de um sandbox OpenShell. Se o NemoClaw detectar uma instalação existente no host, launch para a menos que você passe --force.

$ openclaw nemoclaw launch [--force] [--profile <profile>]

--force Ignora o aviso de ergonomia e força o bootstrap orientado por plugin. Sem esta flag, o NemoClaw recomenda usar openshell sandbox create diretamente para novas instalações.

--profile <profile> Perfil do blueprint a usar. Padrão: default.

nemoclaw <name> connect

Abre um shell interativo dentro do sandbox do OpenClaw. Use após o launch para conectar e conversar com o agente através do TUI ou CLI.

$ nemoclaw my-assistant connect

Se a visualização do TUI não for adequada para respostas muito longas, use o formato CLI:

$ openclaw agent --agent main --local -m "<prompt>" --session-id <id>

Esta é a solução recomendada quando você precisa da resposta completa impressa diretamente no terminal.

openclaw nemoclaw status

Exibe a saúde do sandbox, estado de execução do blueprint e configuração de inferência.

$ openclaw nemoclaw status [--json]

--json Saída em JSON para consumo programático.

Ao executar dentro de um sandbox OpenShell ativo, o comando status detecta o contexto do sandbox e reporta “active (inside sandbox)” em vez de falsos negativos. O estado do sandbox no nível do host e a configuração de inferência não são inspecionáveis de dentro do sandbox. Execute openshell sandbox list no host para verificar o estado subjacente do sandbox.

openclaw nemoclaw logs

Transmite logs de execução do blueprint e do sandbox.

$ openclaw nemoclaw logs [-f] [-n <count>] [--run-id <id>]

-f, --follow Acompanha a saída de log, similar ao tail -f.

-n, --lines <count> Número de linhas a exibir. Padrão: 50.

--run-id <id> Mostra logs de uma execução de blueprint específica em vez da mais recente.

Comando Slash /nemoclaw

O comando slash /nemoclaw está disponível dentro da interface de chat do OpenClaw para ações rápidas:

Comandos Standalone do Host

O binário nemoclaw lida com operações no host que rodam fora do contexto do plugin do OpenClaw.

nemoclaw onboard

Executa o assistente de configuração interativo. O assistente cria um gateway OpenShell, registra provedores de inferência, compila a imagem do sandbox e cria o sandbox. Use este comando para novas instalações e para recriar um sandbox após alterações na política ou configuração.

$ nemoclaw onboard

A primeira execução solicita sua API key NVIDIA e a salva em ~/.nemoclaw/credentials.json.

O assistente solicita um nome para o sandbox. Os nomes devem seguir as regras de subdomínio RFC 1123: apenas caracteres alfanuméricos minúsculos e hífens, e devem começar e terminar com um caractere alfanumérico. Letras maiúsculas são automaticamente convertidas para minúsculas.

Antes de criar o gateway, o assistente executa verificações de pré-voo. Em sistemas com cgroup v2 (Ubuntu 24.04, DGX Spark, WSL2), ele verifica se o Docker está configurado com "default-cgroupns-mode": "host" e fornece instruções de correção se a configuração estiver faltando.

nemoclaw list

Lista todos os sandboxes registrados com seus modelos, provedores e presets de política.

$ nemoclaw list

nemoclaw deploy

Aviso: O comando nemoclaw deploy é experimental e pode não funcionar como esperado.

Implanta o NemoClaw em uma instância GPU remota através do Brev. O script de implantação instala Docker, NVIDIA Container Toolkit se uma GPU estiver presente, e OpenShell na VM, depois executa a configuração do NemoClaw e conecta ao sandbox.

$ nemoclaw deploy <instance-name>

nemoclaw <name> connect

Conecta a um sandbox pelo nome.

$ nemoclaw my-assistant connect

nemoclaw <name> status

Mostra o status, saúde e configuração de inferência do sandbox.

$ nemoclaw my-assistant status

nemoclaw <name> logs

Visualiza logs do sandbox. Use --follow para transmitir a saída em tempo real.

$ nemoclaw my-assistant logs [--follow]

nemoclaw <name> destroy

Para o contêiner NIM e exclui o sandbox. Isso remove o sandbox do registro.

$ nemoclaw my-assistant destroy

nemoclaw <name> policy-add

Adiciona um preset de política a um sandbox. Presets estendem a política de rede de linha de base com endpoints adicionais.

$ nemoclaw my-assistant policy-add

nemoclaw <name> policy-list

Lista os presets de política disponíveis e mostra quais estão aplicados ao sandbox.

$ nemoclaw my-assistant policy-list

openshell term

Abre o TUI do OpenShell para monitorar a atividade do sandbox e aprovar requisições de saída de rede. Execute no host onde o sandbox está rodando.

$ openshell term

Para uma instância Brev remota, conecte via SSH à instância e execute openshell term lá, ou use um port-forward para o gateway.

nemoclaw start

Inicia serviços auxiliares, como a ponte Telegram e o túnel cloudflared.

$ nemoclaw start

Requer TELEGRAM_BOT_TOKEN para a ponte Telegram.

nemoclaw stop

Para todos os serviços auxiliares.

$ nemoclaw stop

nemoclaw status

Mostra a lista de sandboxes e o status dos serviços auxiliares.

$ nemoclaw status

nemoclaw setup-spark

Configura o NemoClaw no DGX Spark. Este comando aplica as correções de cgroup v2 e Docker necessárias para o Ubuntu 24.04. Execute com sudo no host Spark. Após as correções serem concluídas, o script solicita que você execute nemoclaw onboard para continuar a configuração.

$ sudo nemoclaw setup-spark