설치 가이드

NemoClaw 설치하기

편한 방법으로 설치하세요. 어떤 방법이든 같은 보안 스택이 설치됩니다.

checklist 시스템 요구사항

javascript Node.js 20+

v20+(v22 권장). 없으면 설치 스크립트가 nvm으로 자동 설치.

computer OS

Ubuntu 22.04+(권장). macOS는 Colima/Docker Desktop. Windows는 WSL2 + Docker Desktop.

deployed_code Container Runtime

Docker(Linux), Colima 또는 Docker Desktop(macOS), Docker Desktop WSL 백엔드(Windows). macOS Podman은 아직 미지원.

memory RAM

최소 8 GB, 16 GB 권장

hard_drive Disk

최소 20 GB 여유 공간, 40 GB 권장

extension GPU

선택. 로컬 Nemotron 추론에 8GB+ VRAM GPU 필요. GPU 없으면 NVIDIA Cloud API로 추론.

원라이너로 전체 스택 배포. 대부분의 분에게 추천. 전체 문서 보기 arrow_forward

Linux / macOS / WSL

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

$ curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
Linux(Ubuntu 22.04+), macOS(Apple Silicon, Colima/Docker Desktop), Windows(WSL2 + Docker Desktop)에서 동작합니다. 스크립트가 Node.js를 자동 설치하고 nemoclaw onboard를 실행합니다.

verified 설치 확인

아래 명령어로 NemoClaw가 제대로 설치됐는지 확인.

1
$ nemoclaw list

NemoClaw 샌드박스를 나열합니다. 명령어가 인식되면 CLI 설치 완료.

2
$ nemoclaw onboard

대화형 설정 마법사: 샌드박스 생성, 추론 설정(로컬 Nemotron 또는 NVIDIA Cloud API), 보안 정책 적용.

settings 초기 설정

설치 후 온보드 마법사가 설정을 안내합니다. 각 단계 설명은 아래.

1

모델 선택

Nemotron 3 Super 120B(로컬, 완전한 프라이버시), Nemotron 3 Nano 4B(엣지), 클라우드 모델(OpenAI, Anthropic) 중 선택. 실행 시 Privacy Router가 자동 전환.

2

프라이버시 정책 설정

어떤 데이터를 로컬에 유지하고, 어떤 데이터를 클라우드로 보낼지 정의. 기본값은 최대 프라이버시 — 전부 로컬.

3

네트워크 정책 설정

아웃바운드 네트워크 규칙 설정. 기본값은 전면 차단. 에이전트가 접근할 도메인과 API를 개별 허용.

4

샌드박스 테스트

OpenShell 샌드박스에서 테스트 에이전트 실행. 격리, 네트워크 정책, 모델 라우팅이 정상인지 확인.

.env — 모든 설정은 ~/.nemoclaw/config.yaml에 저장. 직접 편집도 가능합니다. 자세한 내용은 /docs/get-started/quickstart 참고.

system_update_alt NemoClaw 업그레이드

최신 보안 패치와 기능을 받으려면 항상 최신 상태로. 업그레이드·마이그레이션 가이드 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

버전별 변경사항은 github.com/NVIDIA/NemoClaw/releases에서 확인.

delete_forever NemoClaw 제거

시스템에서 NemoClaw를 제거하려면 설치 방식에 맞게. 제거 방법 상세 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

사용자 데이터 삭제 (선택)

모든 Blueprint, 샌드박스 설정, 모델 데이터가 삭제됩니다. 필요한 건 먼저 백업하세요.

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

build 문제 해결

자주 발생하는 문제와 해결 방법. 문제 해결 더 보기 arrow_forward

도움이 필요하신가요?

GitHub Discussions에서 설치 지원과 문제 해결 도움을 받으세요.

소식 받기

NemoClaw 새 버전, 보안 공지, 에코시스템 소식을 전해드립니다. 스팸 없고 언제든 구독 취소 가능.