OpenClaw 설치의 가장 흔한 실패는 프로젝트 자체가 고장 난 것이 아니라 환경이 제대로 작동하지 않는 경우입니다. OpenClaw의 공식 오픈 소스 저장소는 https://github.com/openclaw/openclaw 있으며, 설치 문서는 https://docs.openclaw.ai/install/index 있습니다. 공식 설치 페이지는 매우 간단합니다: Node 24가 권장 버전이며, Node 22.14+도 사용할 수 있습니다; 윈도우는 네이티브로 설치할 수 있지만, 공식적으로 WSL2를 권장합니다.
가장 쉽게 밟을 수 있는 세 가지 지점을 살펴보겠습니다
첫 번째는 Node 버전이 너무 오래되어 설치 스크립트가 바로 멈추는 문제입니다; 둘째, 윈도우 환경은 WSL2를 사용하지 않으며, 이후 npm, 권한, 경로가 사소한 문제에 취약하다는 점입니다; 세 번째는 설치 후 'openclaw' 명령어를 찾을 수 없는데, 이는 프로그램이 설치되지 않아서가 아니라 PATH가 제대로 구성되지 않았기 때문일 가능성이 큽니다.
더 안정적인 접근법
처음 설치한다면 공식 설치 스크립트를 우선적으로 사용하고, 명령어가 뜨자마자 직접 철자를 외우지 마세요. 스크립트는 자동으로 시스템을 감지하고 노드를 설치하며 온보딩을 불러와, 많은 구석 구덩이를 줄일 수 있습니다. 이미 소스 코드 디렉터리에 있다면, git/install-cli 공식 경로도 지원되지만, 기본 조건은 Node와 Git이 정상이라는 전제입니다.
그래도 오류가 발생하면 이 순서대로 확인해 보세요
- 먼저 'node -v'를 실행하여 버전이 충분한지 확인하세요.
- 윈도우 사용자는 WSL2로 전환한 후 다시 설치하는 것을 선호합니다.
- 'npm 접두사 -g'를 실행하여 전역 bin 디렉터리가 PATH에 들어갔는지 확인하세요.
많은 사람들이 설치 실패를 'OpenClaw가 내 컴퓨터와 호환되지 않는다'고 해석하지만, 실제로는 설치 링크 내 준비가 안 된 링크일 뿐인 경우가 많습니다. Node, Git, WSL2, PATH의 기본을 모두 완료하면 설치 성공률이 훨씬 높아집니다.
