설치

시스템 요구 사항

• Node 24(권장) 또는 Node 22.19+ - 설치 스크립트가 이를 자동으로 처리합니다
• macOS, Linux 또는 Windows - Windows 사용자는 네이티브 Windows Hub 앱, PowerShell CLI 설치 프로그램 또는 WSL2 Gateway로 시작할 수 있습니다. 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-checkout 설치도 지원합니다. 전체 참조: 설치 프로그램 내부 구조.

이미 설치했나요? openclaw update --channel dev 및 openclaw update --channel stable로 패키지 설치와 git 설치 사이를 전환하세요. 업데이트를 참조하세요.

npm, pnpm 또는 bun

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

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

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

소스에서 설치

기여자 또는 로컬 체크아웃에서 실행하려는 사용자는 다음을 사용하세요.

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

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

GitHub main 체크아웃에서 설치

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

컨테이너와 패키지 관리자

설치 확인

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

• macOS: openclaw onboard --install-daemon 또는 openclaw gateway install을 통한 LaunchAgent
• Linux/WSL2: 같은 명령을 통한 systemd 사용자 서비스
• 네이티브 Windows: 먼저 예약된 작업을 사용하고, 작업 생성이 거부되면 사용자별 시작 폴더 로그인 항목으로 대체

호스팅 및 배포

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

업데이트, 마이그레이션 또는 제거

문제 해결: openclaw를 찾을 수 없음

설치가 성공했지만 터미널에서 openclaw를 찾을 수 없다면:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

$(npm prefix -g)/bin이 $PATH에 없다면 셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에 추가하세요.

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

그런 다음 새 터미널을 여세요. 자세한 내용은 Node 설정을 참조하세요.