설치

# 시스템 요구 사항

• Node 24(권장) 또는 Node 22.14+ - 설치 스크립트가 이를 자동으로 처리합니다
• macOS, Linux 또는 Windows - 네이티브 Windows와 WSL2가 모두 지원되며, WSL2가 더 안정적입니다. Windows를 참고하세요.
• 소스에서 빌드하는 경우에만 pnpm이 필요합니다

# 권장: 설치 스크립트

가장 빠른 설치 방법입니다. OS를 감지하고, 필요한 경우 Node를 설치하고, OpenClaw를 설치한 뒤 온보딩을 시작합니다.

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

온보딩을 실행하지 않고 설치하려면:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

모든 플래그와 CI/자동화 옵션은 설치 관리자 내부 구조를 참고하세요.

# 대체 설치 방법

# 로컬 프리픽스 설치 관리자(install-cli.sh)

시스템 전체 Node 설치에 의존하지 않고 OpenClaw와 Node를 ~/.openclaw 같은 로컬 프리픽스 아래에 유지하려는 경우 사용하세요:

curl -fsSL https://openclaw.ai/install-cli.sh | bash

기본적으로 npm 설치를 지원하며, 동일한 프리픽스 흐름에서 git 체크아웃 설치도 지원합니다. 전체 참조 문서: 설치 관리자 내부 구조.

이미 설치했나요? openclaw update --channel dev와 openclaw update --channel stable로 패키지 설치와 git 설치를 전환할 수 있습니다. 업데이트를 참고하세요.

# npm, pnpm 또는 bun

이미 Node를 직접 관리하고 있다면:

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

bun add -g openclaw@latest
openclaw onboard --install-daemon

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# 소스에서 설치

기여자 또는 로컬 체크아웃에서 실행하려는 사용자를 위한 방법입니다:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

또는 링크를 건너뛰고 저장소 내부에서 pnpm openclaw ...를 사용하세요. 전체 개발 워크플로는 설정을 참고하세요.

# GitHub main에서 설치

npm install -g github:openclaw/openclaw#main

# 컨테이너 및 패키지 관리자

# 설치 확인

openclaw --version      # CLI를 사용할 수 있는지 확인
openclaw doctor         # 구성 문제 확인
openclaw gateway status # Gateway가 실행 중인지 확인

설치 후 관리형 시작을 원한다면:

• macOS: openclaw onboard --install-daemon 또는 openclaw gateway install을 통한 LaunchAgent
• Linux/WSL2: 동일한 명령을 통한 systemd 사용자 서비스
• 네이티브 Windows: 우선 Scheduled Task를 사용하고, 작업 생성이 거부되면 사용자별 Startup 폴더 로그인 항목으로 대체

# 호스팅 및 배포

클라우드 서버 또는 VPS에 OpenClaw를 배포하세요:

node -v           # Node가 설치되어 있나요?
npm prefix -g     # 전역 패키지는 어디에 있나요?
echo "$PATH"      # 전역 bin 디렉터리가 PATH에 있나요?

export PATH="$(npm prefix -g)/bin:$PATH"