문제 해결
이 페이지에서는 NemoClaw를 설치, 온보드, 실행할 때 자주 발생하는 문제와 해결 방법을 다룹니다.
팁: 문제가 여기 나열되지 않았다면 NemoClaw Discord 채널에서 커뮤니티에 질문하세요. GitHub에서 이슈를 생성할 수도 있습니다.
설치
설치 후 nemoclaw을 찾을 수 없음
nvm이나 fnm으로 Node.js를 관리하는 경우, 설치 프로그램이 현재 셸의 PATH를 업데이트하지 않을 수 있습니다.
source ~/.bashrc(zsh는 source ~/.zshrc)를 실행하거나 새 터미널 창을 여세요.
지원되지 않는 플랫폼에서 설치 실패
NemoClaw는 Linux Ubuntu 22.04 LTS 이상이 필요합니다. 지원되는 Linux 배포판에서 실행 중인지 확인하세요.
Node.js 버전이 오래됨
NemoClaw는 Node.js 20 이상이 필요합니다. nvm 사용 시:
$ nvm install 20
$ nvm use 20Docker가 실행 중이 아님
Docker 데몬을 시작합니다:
$ sudo systemctl start dockernpm install 권한 오류
sudo로 npm을 실행하지 마세요. 대신 소유한 디렉토리를 사용하도록 npm을 설정합니다:
$ mkdir -p ~/.npm-global
$ npm config set prefix ~/.npm-global
$ export PATH=~/.npm-global/bin:$PATH포트가 이미 사용 중
NemoClaw gateway는 기본적으로 포트 18789를 사용합니다. 충돌 프로세스를 확인하고 종료하세요:
$ lsof -i :18789
$ kill <PID>온보드
cgroup v2 오류
Ubuntu 24.04, DGX Spark, WSL2에서 Spark 설정 스크립트를 실행하세요:
$ sudo nemoclaw setup-spark
$ nemoclaw onboard잘못된 샌드박스 이름
RFC 1123 서브도메인 규칙을 따라야 합니다. my-assistant나 dev1 같은 이름을 사용하세요.
DGX에서 샌드박스 생성 실패
nemoclaw onboard를 다시 실행하세요. 마법사가 이전 포트 포워드를 자동 정리합니다.
Colima 소켓 감지 안 됨 (macOS)
Colima가 실행 중인지 확인하세요:
$ colima status런타임
샌드박스가 중지됨으로 표시
nemoclaw onboard를 실행하여 샌드박스를 재생성하세요.
샌드박스 안에서 status가 “not running”
예상된 동작입니다. 호스트에서 openshell sandbox list를 실행하세요.
추론 요청 타임아웃
openclaw nemoclaw status로 프로바이더와 엔드포인트를 확인하세요. NVIDIA API key가 유효한지도 검증하세요.
에이전트가 외부 호스트에 연결 불가
TUI를 열어 차단된 요청을 확인하고 승인하세요:
$ openshell term블루프린트 실행 실패
$ openclaw nemoclaw logs --run-id <id>