Install

특별한 이유가 없다면 설치 프로그램을 사용하세요. CLI를 설정하고 온보딩을 실행합니다.

빠른 설치 (권장)

curl -fsSL https://openclaw.bot/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

다음 단계 (온보딩을 건너뛴 경우):

openclaw onboard --install-daemon

시스템 요구 사항

  • Node >=22
  • macOS, Linux 또는 WSL2를 통한 Windows
  • 소스에서 빌드하는 경우에만 pnpm

설치 경로 선택

1) 설치 스크립트 (권장)

npm을 통해 openclaw를 전역으로 설치하고 온보딩을 실행합니다.

curl -fsSL https://openclaw.bot/install.sh | bash

설치 프로그램 플래그:

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --help

세부사항: 설치 프로그램 내부.

비대화형 (온보딩 건너뛰기):

curl -fsSL https://openclaw.bot/install.sh | bash -s -- --no-onboard

2) 전역 설치 (수동)

Node가 이미 있는 경우:

npm install -g openclaw@latest

libvips가 전역으로 설치되어 있고(Homebrew를 통한 macOS에서 일반적) 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) 위의 SHARP_IGNORE_GLOBAL_LIBVIPS=1 해결 방법을 사용하여 네이티브 빌드를 건너뛰세요.

또는:

pnpm add -g openclaw@latest

그런 다음:

openclaw onboard --install-daemon

3) 소스에서 (기여자/개발자)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 첫 실행 시 UI 의존성 자동 설치
pnpm build
openclaw onboard --install-daemon

팁: 아직 전역 설치가 없는 경우, pnpm openclaw ...를 통해 저장소 명령을 실행하세요.

4) 기타 설치 옵션

설치 후

  • 온보딩 실행: openclaw onboard --install-daemon
  • 빠른 확인: openclaw doctor
  • Gateway 상태 확인: openclaw status + openclaw health
  • 대시보드 열기: openclaw dashboard

설치 방법: npm vs git (설치 프로그램)

설치 프로그램은 두 가지 방법을 지원합니다:

  • npm (기본값): npm install -g openclaw@latest
  • git: GitHub에서 클론/빌드하고 소스 체크아웃에서 실행

CLI 플래그

# 명시적 npm
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method npm

# GitHub에서 설치 (소스 체크아웃)
curl -fsSL https://openclaw.bot/install.sh | bash -s -- --install-method git

일반적인 플래그:

  • --install-method npm|git
  • --git-dir <path> (기본값: ~/openclaw)
  • --no-git-update (기존 체크아웃 사용 시 git pull 건너뛰기)
  • --no-prompt (프롬프트 비활성화; CI/자동화에 필요)
  • --dry-run (실행될 내용 출력; 변경하지 않음)
  • --no-onboard (온보딩 건너뛰기)

환경 변수

동등한 환경 변수 (자동화에 유용):

  • OPENCLAW_INSTALL_METHOD=git|npm
  • OPENCLAW_GIT_DIR=...
  • OPENCLAW_GIT_UPDATE=0|1
  • OPENCLAW_NO_PROMPT=1
  • OPENCLAW_DRY_RUN=1
  • OPENCLAW_NO_ONBOARD=1
  • SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 (기본값: 1; 시스템 libvips에 대한 sharp 빌드 방지)

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

빠른 진단:

node -v
npm -v
npm prefix -g
echo "$PATH"

$(npm prefix -g)/bin (macOS/Linux) 또는 $(npm prefix -g) (Windows)가 echo "$PATH" 내에 없으면, 셸이 전역 npm 바이너리(openclaw 포함)를 찾을 수 없습니다.

수정: 셸 시작 파일에 추가하세요 (zsh: ~/.zshrc, bash: ~/.bashrc):

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

Windows에서는 npm prefix -g의 출력을 PATH에 추가하세요.

그런 다음 새 터미널을 열거나 (zsh에서 rehash 또는 bash에서 hash -r).

업데이트 / 제거

← 문서로 돌아가기