Skip to main content

설치

이미 Getting Started를 완료하셨나요? 그렇다면 준비가 끝났습니다 — 이 페이지는 대체 설치 방법, 플랫폼별 지침, 그리고 유지 관리에 관한 내용입니다.

시스템 요구 사항

  • Node 22+ (설치 스크립트가 누락된 경우 설치합니다)
  • macOS, Linux 또는 Windows
  • 소스에서 빌드하는 경우에만 pnpm 필요
Windows 에서는 WSL2에서 OpenClaw 를 실행하는 것을 강력히 권장합니다.

설치 방법

설치 스크립트는 OpenClaw 를 설치하는 권장 방법입니다. Node 감지, 설치, 온보딩을 한 단계로 처리합니다.

Installer script

CLI 를 다운로드하고 npm 을 통해 전역으로 설치한 다음 온보딩 마법사를 실행합니다.
이미 Node 22+ 가 설치되어 있고 설치를 직접 관리하고 싶다면 다음을 사용하십시오.
기여자이거나 로컬 체크아웃에서 실행하려는 경우에 적합합니다.

기타 설치 방법

Docker

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

Podman

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

Nix

Nix 를 통한 선언적 설치.

Ansible

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

Bun

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

설치 후

모든 것이 정상적으로 작동하는지 확인하십시오.
사용자 정의 런타임 경로가 필요한 경우 다음을 사용하세요:
  • 홈 디렉터리 기반 내부 경로에는 OPENCLAW_HOME
  • 변경 가능한 상태 위치에는 OPENCLAW_STATE_DIR
  • 설정 파일 위치에는 OPENCLAW_CONFIG_PATH
우선순위와 전체 세부 정보는 Environment vars를 참조하세요.

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

빠른 진단:
$(npm prefix -g)/bin (macOS/Linux) 또는 $(npm prefix -g) (Windows) 가 $PATH포함되어 있지 않다면, 셸에서 전역 npm 바이너리(openclaw 포함)를 찾을 수 없습니다.해결 방법 — 셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에 이를 추가하십시오.
Windows 에서는 npm prefix -g 의 출력 값을 PATH 에 추가하십시오.그런 다음 새 터미널을 열거나(zsh 에서는 rehash, bash 에서는 hash -r 를 실행하십시오).

업데이트 / 제거

Updating

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

Migrating

새 머신으로 이동합니다.

Uninstall

OpenClaw 를 완전히 제거합니다.