설치

시스템 요구 사항

• Node 22.19+, 23.11+ 또는 24+ - Node 24가 기본 대상이며, 설치 프로그램 스크립트가 이를 자동으로 처리합니다.
• macOS, Linux 또는 Windows - Windows 사용자는 네이티브 Windows Hub 앱, PowerShell CLI 설치 프로그램 또는 WSL2 Gateway로 시작할 수 있습니다. Windows를 참조하세요.
• 소스에서 빌드하는 경우에만 pnpm이 필요합니다.

권장: 설치 프로그램 스크립트

가장 빠른 설치 방법입니다. 운영 체제를 감지하고, 필요한 경우 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@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      # CLI를 사용할 수 있는지 확인openclaw doctor         # 구성 문제 확인openclaw gateway status # Gateway가 실행 중인지 확인

설치 후 관리형 시작을 사용하려면:

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

호스팅 및 배포

클라우드 서버 또는 VPS에 OpenClaw를 배포하세요. 전체 제공업체 선택 목록(DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi 등)은 Linux 서버를 참조하거나, Render에 선언적으로 배포하세요.

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

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

거의 항상 PATH 문제입니다. npm의 전역 바이너리 디렉터리가 셸의 PATH에 포함되어 있지 않은 것입니다. Windows 경로를 포함한 전체 해결 방법은 Node.js 문제 해결을 참조하세요.

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