메인 콘텐츠로 건너뛰기

​
설치

​
권장: 설치 스크립트

가장 빠른 설치 방법입니다. OS를 감지하고, 필요하면 Node를 설치하고, OpenClaw를 설치한 뒤 온보딩을 실행합니다. 
curl -fsSL https://openclaw.ai/install.sh | bash
온보딩을 실행하지 않고 설치하려면: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
모든 플래그와 CI/자동화 옵션은 Installer internals를 참조하세요.

​
시스템 요구 사항

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

​
대체 설치 방법

​
로컬 prefix 설치기(install-cli.sh)

시스템 전체 Node 설치에 의존하지 않고 OpenClaw와 Node를 ~/.openclaw 같은 로컬 prefix 아래에 유지하고 싶다면 이 방법을 사용하세요: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
기본적으로 npm 설치를 지원하며, 같은 prefix 흐름 아래에서 git 체크아웃 설치도 지원합니다. 전체 참조: Installer internals.

​
npm, pnpm 또는 bun

이미 Node를 직접 관리하고 있다면: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
전역 설치된 libvips 때문에 sharp가 실패하는 경우:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
소스에서 설치

기여자이거나 로컬 체크아웃에서 실행하려는 경우: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
또는 link를 생략하고 리포지토리 내부에서 pnpm openclaw ...를 사용하세요. 전체 개발 워크플로는 Setup을 참조하세요.

​
GitHub main에서 설치

npm install -g github:openclaw/openclaw#main

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

Docker

컨테이너화되었거나 헤드리스인 배포.

Podman

Docker의 rootless 컨테이너 대안.

Nix

Nix flake를 통한 선언적 설치.

Ansible

자동화된 fleet 프로비저닝.

Bun

Bun 런타임을 통한 CLI 전용 사용.

​
설치 확인

openclaw --version      # CLI 사용 가능 여부 확인
openclaw doctor         # config 문제 확인
openclaw gateway status # 게이트웨이 실행 여부 확인
설치 후 관리형 시작을 원하면:
  • macOS: openclaw onboard --install-daemon 또는 openclaw gateway install을 통한 LaunchAgent
  • Linux/WSL2: 동일한 명령을 통한 systemd user 서비스
  • 네이티브 Windows: 먼저 Scheduled Task, 작업 생성이 거부되면 사용자별 Startup 폴더 로그인 항목으로 대체

​
호스팅 및 배포

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

VPS

모든 Linux VPS

Docker VM

공통 Docker 단계

Kubernetes

K8s

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

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

업데이트

OpenClaw를 최신 상태로 유지합니다.

마이그레이션

새 머신으로 이동합니다.

제거

OpenClaw를 완전히 제거합니다.

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

설치는 성공했지만 터미널에서 openclaw를 찾을 수 없는 경우: 
node -v           # Node가 설치되어 있나요?
npm prefix -g     # 전역 패키지는 어디에 설치되나요?
echo "$PATH"      # 전역 bin 디렉터리가 PATH에 있나요?
$(npm prefix -g)/bin이 $PATH에 없다면 셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에 추가하세요: 
export PATH="$(npm prefix -g)/bin:$PATH"
그런 다음 새 터미널을 여세요. 자세한 내용은 Node setup를 참조하세요.