Install overview
Node.js
OpenClaw에는 **Node 22.22.3+, Node 24.15+ 또는 Node 25.9+**가 필요합니다. Node 24는 설치, CI 및 릴리스 워크플로의 기본 권장 런타임이며, Node 22는 활성 LTS 계열을 통해 계속 지원됩니다. Node 23은 지원되지 않습니다. 설치 프로그램 스크립트는 Node를 자동으로 감지하고 설치합니다. Node를 직접 설정하려는 경우(버전, PATH, 전역 설치) 이 페이지를 사용하십시오.
버전 확인
node -vv24.15.0 이상의 24.x가 권장 기본 버전입니다. v22.22.3 이상의 22.x는 지원되는 Node 22 LTS 경로이며, Node v25.9.0+도 지원됩니다. Node 23은 지원되지 않습니다. Node가 설치되어 있지 않거나 지원 범위를 벗어나는 경우 아래에서 설치 방법을 선택하십시오.
Node 설치
macOS
Homebrew(권장):
brew install node또는 nodejs.org에서 macOS 설치 프로그램을 다운로드하십시오.
Linux
Ubuntu / Debian:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt-get install -y nodejsFedora / RHEL:
sudo dnf install nodejs또는 버전 관리자를 사용하십시오(아래 참조).
Windows
winget(권장):
winget install OpenJS.NodeJS.LTSChocolatey:
choco install nodejs-lts또는 nodejs.org에서 Windows 설치 프로그램을 다운로드하십시오.
버전 관리자 사용(nvm, fnm, mise, asdf)
버전 관리자를 사용하면 Node 버전 간에 쉽게 전환할 수 있습니다. 널리 사용되는 옵션은 다음과 같습니다.
fnm 사용 예시:
fnm install 24fnm use 24문제 해결
openclaw: command not found
이는 거의 항상 npm의 전역 bin 디렉터리가 PATH에 없음을 의미합니다.
전역 npm 접두사 찾기
npm prefix -gPATH에 포함되어 있는지 확인
echo "$PATH"출력에서 <npm-prefix>/bin(macOS/Linux) 또는 <npm-prefix>(Windows)을(를) 찾으십시오.
셸 시작 파일에 추가
macOS / Linux
~/.zshrc 또는 ~/.bashrc에 다음을 추가하십시오.
export PATH="$(npm prefix -g)/bin:$PATH"그런 다음 새 터미널을 여십시오(또는 zsh에서는 rehash, bash에서는 hash -r을(를) 실행하십시오).
Windows
Settings → System → Environment Variables에서 npm prefix -g의 출력을 시스템 PATH에 추가하십시오.
npm install -g의 권한 오류(Linux)
EACCES 오류가 표시되면 npm의 전역 접두사를 사용자가 쓸 수 있는 디렉터리로 변경하십시오.
mkdir -p "$HOME/.npm-global"npm config set prefix "$HOME/.npm-global"export PATH="$HOME/.npm-global/bin:$PATH"영구적으로 적용하려면 export PATH=... 줄을 ~/.bashrc 또는 ~/.zshrc에 추가하십시오.
