메인 콘텐츠로 건너뛰기

​
Install

시작하기를 이미 완료하셨나요? 그렇다면 준비가 완료되었습니다. 이 페이지는 대체 설치 방법, 플랫폼별 지침 및 유지보수를 위한 것입니다.

​
시스템 요구 사항

  • Node 24 권장 (호환성을 위해 Node 22 LTS, 현재 22.16+도 계속 지원되며, 설치 방법 스크립트는 없을 경우 Node 24를 설치합니다)
  • macOS, Linux 또는 Windows
  • 소스에서 빌드할 경우에만 pnpm
Windows에서 OpenClaw를 실행하려면 WSL2를 강력히 권장합니다.

​
설치 방법

설치 스크립트는 OpenClaw를 설치하는 데 권장되는 방법입니다. Node 감지, 설치 및 온보딩을 한 번에 처리합니다.
VPS/클라우드 호스트의 경우, 가능한 한 타사 “1-클릭” 마켓플레이스 이미지는 피하세요. 깨끗한 기본 OS 이미지(예: Ubuntu LTS)를 선호하고, 설치 스크립트로 직접 OpenClaw를 설치하세요.

설치 스크립트

CLI를 다운로드하여 npm을 통해 전역 설치하고 온보딩 마법사를 실행합니다.
curl -fsSL https://openclaw.ai/install.sh | bash
이것으로 완료입니다. 스크립트가 Node 감지, 설치 및 온보딩을 처리합니다.온보딩을 건너뛰고 이진 파일만 설치하려면:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
모든 플래그, 환경 변수 및 CI/자동화 옵션에 대한 자세한 내용은 Installer internals를 참조하세요.
Node를 직접 관리한다면 Node 24를 권장합니다. OpenClaw는 호환성을 위해 Node 22 LTS(22.16+)도 계속 지원합니다:
npm install -g openclaw@latest
openclaw onboard --install-daemon
macOS의 Homebrew를 통해 일반적으로 libvips가 전역 설치되어 있고 sharp 설치에 실패하는 경우, 미리 빌드된 바이너리로 강제 설치:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
sharp: Please add node-gyp to your dependencies 라는 메시지가 표시되면, 빌드 도구(macOS: Xcode CLT + npm install -g node-gyp)를 설치하거나 위의 환경 변수를 사용하십시오.
기여자 또는 로컬 체크아웃에서 실행하려는 모든 사람을 위해.
1

클론 및 빌드

OpenClaw 저장소를 클론하고 빌드합니다:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

CLI 링크

openclaw 명령어를 전역적으로 사용할 수 있도록 합니다:
pnpm link --global
또는, 링크를 건너뛰고 리포지토리 내에서 pnpm openclaw ...를 통해 명령어를 실행합니다.
3

온보딩 실행

openclaw onboard --install-daemon
더 깊은 개발 워크플로우는 Setup를 참조하십시오.

​
다른 설치 방법

Docker

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

Podman

루트리스 컨테이너: setup-podman.sh를 한 번 실행한 후 시작 스크립트를 실행하세요.

Nix

Nix를 통한 선언적 설치.

Ansible

자동화된 플릿 프로비저닝.

Bun

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

​
설치 후

모든 것이 제대로 작동하는지 확인하세요: 
openclaw doctor         # 설정 문제 확인
openclaw status         # 게이트웨이 상태
openclaw dashboard      # 브라우저 UI 열기
사용자 지정 런타임 경로가 필요한 경우, 다음을 사용하세요:
  • OPENCLAW_HOME 내부 경로에 대한 홈 디렉토리 기반 경로
  • OPENCLAW_STATE_DIR 가변 상태 위치
  • OPENCLAW_CONFIG_PATH 구성 파일 위치
우선순위 및 자세한 내용에 대해 Environment vars를 참조하세요.

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

빠른 진단:
node -v
npm -v
npm prefix -g
echo "$PATH"
$(npm prefix -g)/bin (macOS/Linux) 또는 $(npm prefix -g) (Windows)이 $PATH에 없다면, 쉘이 전역 npm 바이너리(예: openclaw)를 찾을 수 없습니다.수정 방법 — 쉘 시작 파일(~/.zshrc 또는 ~/.bashrc)에 추가하세요:
export PATH="$(npm prefix -g)/bin:$PATH"
Windows에서는 npm prefix -g의 출력을 PATH에 추가하세요.그런 다음 새 터미널을 열거나 zsh에서 rehash, bash에서 hash -r을 실행하세요.

​
업데이트 / 제거

업데이트

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

마이그레이션

새 머신으로 이동합니다.

제거

OpenClaw를 완전히 제거합니다.