NVIDIA NemoClaw의 WSL2 GPU 연동 버그 해결 및 OpenClaw 보안 샌드박스 구축 가이드

실용적 조언

WSL2 환경에서는 자동 온보딩 대신 OpenShell CLI를 사용하여 수동으로 게이트웨이와 샌드박스를 구성하라.
NVIDIA NIM을 사용할 때 환경 변수에서 Anthropic 관련 키를 제거하여 설정 충돌을 방지하라.
샌드박스 내부에서 OpenClaw 온보딩 시 커스텀 프로바이더를 통해 로컬 추론 엔드포인트(https://inference.local/v1)를 지정하라.

섹션별 상세

NemoClaw는 OpenClaw를 위한 보안 및 샌드박스 계층으로, Landlock, seccomp, 네트워크 네임스페이스를 결합하여 강력한 격리 환경을 제공한다. 이를 통해 AI 에이전트의 파일 시스템 접근과 네트워크 송출을 정책적으로 제어하며 추론 라우팅을 관리한다.

WSL2 환경에서 `nemoclaw onboard` 명령어를 실행하면 `nvidia-smi`를 감지하여 게이트웨이와 샌드박스에 `--gpu` 옵션을 강제로 적용한다. 그러나 Docker Desktop이 k3s 클러스터로 GPU를 전달하는 과정에서 오류가 발생하여 샌드박스가 정상적으로 생성되지 않는 문제가 확인됐다.

해당 문제를 해결하기 위해 `nemoclaw onboard`를 우회하고 OpenShell CLI를 직접 사용하는 워크아라운드가 유효하다. 게이트웨이 시작 시 `--gpu` 옵션을 제외하고, NVIDIA NIM을 프로바이더로 등록한 뒤 샌드박스를 수동으로 생성하여 내부 추론 엔드포인트를 연결하는 방식이다.

bash

openshell gateway start --name nemoclaw # no --gpu
openshell provider create --name nvidia-nim --type nvidia --credential NVIDIA_API_KEY=nvapi-xxx
openshell inference set --provider nvidia-nim --model nvidia/nemotron-3-super-120b-a12b
openshell sandbox create --name my-sandbox --from openclaw

nemoclaw onboard 버그를 우회하기 위해 OpenShell CLI를 사용하여 수동으로 게이트웨이와 샌드박스를 설정하는 명령어

환경 변수 설정 시 `ANTHROPIC_API_KEY`가 존재하면 OpenClaw가 NVIDIA 설정을 무시하고 Claude 모델을 우선적으로 사용하는 동작이 발견됐다. 또한 호스트의 OpenShell 게이트웨이와 샌드박스 내부의 OpenClaw 게이트웨이가 별도로 존재하므로 설정 시 혼동하지 않도록 주의가 필요하다.

용어 해설

랜드락(Landlock): — Linux 커널에서 프로세스가 접근할 수 있는 파일 시스템 범위를 제한하는 비특권 접근 제어 메커니즘이다. 샌드박스 내의 AI 에이전트가 허용되지 않은 파일에 접근하는 것을 방지하여 보안을 강화하는 역할을 한다.
시컴프(seccomp): — 프로세스가 실행할 수 있는 시스템 호출(system call)을 필터링하여 커널 공격 표면을 줄이는 Linux 보안 기능이다. NemoClaw 아키텍처에서 샌드박스의 실행 권한을 최소화하는 핵심 요소로 사용된다.
네트워크 네임스페이스(Network Namespace): — Linux 커널에서 네트워크 스택을 논리적으로 격리하여 독립적인 네트워크 환경을 제공하는 기술이다. 샌드박스 내부의 AI 에이전트가 외부 인터넷에 직접 연결되지 못하게 차단하고 지정된 프록시를 통해서만 통신하도록 강제한다.
엔비디아 NIM(NVIDIA NIM): — NVIDIA가 제공하는 추론 마이크로서비스로, 최적화된 AI 모델을 컨테이너 형태로 배포하고 실행할 수 있게 돕는다. NemoClaw 환경에서 Nemotron과 같은 대규모 언어 모델을 효율적으로 구동하기 위한 백엔드 프로바이더로 활용된다.
k3s: — 리소스가 제한된 환경이나 에지 컴퓨팅을 위해 설계된 경량화된 Kubernetes 배포판이다. NemoClaw의 샌드박스 환경을 관리하기 위한 오케스트레이션 도구로 내부적으로 사용된다.

언급된 도구

NemoClaw추천

AI 에이전트를 위한 보안 및 샌드박스 계층

OpenShell추천

NemoClaw의 게이트웨이 및 인프라 관리 도구

k3s중립

샌드박스 환경 구동을 위한 경량 Kubernetes

언급된 리소스

문서WSL2-WORKAROUND.md

GitHubNemoClaw Issue #208

튜토리얼NemoClaw Quickstart Lab