Skip to main content
OpenClaw에는 **Node 22.22.3+, Node 24.15+ 또는 Node 25.9+**가 필요합니다. Node 24는 설치, CI 및 릴리스 워크플로의 기본 권장 런타임이며, Node 22는 활성 LTS 계열을 통해 계속 지원됩니다. Node 23은 지원되지 않습니다. 설치 프로그램 스크립트는 Node를 자동으로 감지하고 설치합니다. Node를 직접 설정하려는 경우(버전, PATH, 전역 설치) 이 페이지를 사용하십시오.

​
버전 확인

v24.15.0 이상의 24.x가 권장 기본 버전입니다. v22.22.3 이상의 22.x는 지원되는 Node 22 LTS 경로이며, Node v25.9.0+도 지원됩니다. Node 23은 지원되지 않습니다. Node가 설치되어 있지 않거나 지원 범위를 벗어나는 경우 아래에서 설치 방법을 선택하십시오.

​
Node 설치

Homebrew(권장):
또는 nodejs.org에서 macOS 설치 프로그램을 다운로드하십시오.
버전 관리자를 사용하면 Node 버전 간에 쉽게 전환할 수 있습니다. 널리 사용되는 옵션은 다음과 같습니다.
  • fnm - 빠르고 여러 플랫폼을 지원함
  • nvm - macOS/Linux에서 널리 사용됨
  • mise - 다중 언어 지원(Node, Python, Ruby 등)
fnm 사용 예시:
셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에서 버전 관리자를 초기화하십시오. 이 단계를 건너뛰면 PATH에 Node의 bin 디렉터리가 포함되지 않아 새 터미널 세션에서 openclaw을(를) 찾지 못할 수 있습니다.

​
문제 해결

​
openclaw: command not found

이는 거의 항상 npm의 전역 bin 디렉터리가 PATH에 없음을 의미합니다.
1

전역 npm 접두사 찾기

2

PATH에 포함되어 있는지 확인

출력에서 <npm-prefix>/bin(macOS/Linux) 또는 <npm-prefix>(Windows)을(를) 찾으십시오.
3

셸 시작 파일에 추가

~/.zshrc 또는 ~/.bashrc에 다음을 추가하십시오.
그런 다음 새 터미널을 여십시오(또는 zsh에서는 rehash, bash에서는 hash -r을(를) 실행하십시오).

​
npm install -g의 권한 오류(Linux)

EACCES 오류가 표시되면 npm의 전역 접두사를 사용자가 쓸 수 있는 디렉터리로 변경하십시오.
영구적으로 적용하려면 export PATH=... 줄을 ~/.bashrc 또는 ~/.zshrc에 추가하십시오.

​
관련 문서