메인 콘텐츠로 건너뛰기

​
설치

​
권장: 설치 스크립트

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

​
시스템 요구 사항

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

​
대체 설치 방법

​
로컬 프리픽스 설치 프로그램(install-cli.sh)

시스템 전체 Node 설치에 의존하지 않고, ~/.openclaw 같은 로컬 프리픽스 아래에 OpenClaw와 Node를 유지하려는 경우 이 방법을 사용하세요. 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
기본적으로 npm 설치를 지원하며, 동일한 프리픽스 흐름에서 git 체크아웃 설치도 지원합니다. 전체 참조는 설치 프로그램 내부 동작을 확인하세요.

​
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 build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
또는 링크를 생략하고 저장소 내부에서 pnpm openclaw ...를 사용해도 됩니다. 전체 개발 워크플로는 Setup을 참조하세요.

​
GitHub main에서 설치

npm install -g github:openclaw/openclaw#main

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

Docker

컨테이너화된 또는 헤드리스 배포.

Podman

Docker의 루트리스 컨테이너 대안.

Nix

Nix flake를 통한 선언적 설치.

Ansible

자동화된 대규모 프로비저닝.

Bun

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

​
설치 확인

openclaw --version      # CLI를 사용할 수 있는지 확인
openclaw doctor         # 구성 문제 확인
openclaw gateway status # Gateway가 실행 중인지 확인
설치 후 관리형 시작을 원한다면:
  • macOS: openclaw onboard --install-daemon 또는 openclaw gateway install을 통한 LaunchAgent
  • Linux/WSL2: 동일한 명령을 통한 systemd 사용자 서비스
  • 기본 Windows: 먼저 예약된 작업, 작업 생성이 거부되면 사용자별 시작 프로그램 폴더 로그인 항목으로 대체

​
호스팅 및 배포

클라우드 서버 또는 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을 참조하세요.