설치
이미 Getting Started를 완료하셨나요? 그렇다면 준비가 끝났습니다 — 이 페이지는 대체 설치 방법, 플랫폼별 지침, 그리고 유지 관리에 관한 내용입니다.시스템 요구 사항
Windows 에서는 WSL2에서 OpenClaw 를 실행하는 것을 강력히 권장합니다.
설치 방법
Installer script
Installer script
CLI 를 다운로드하고 npm 을 통해 전역으로 설치한 다음 온보딩 마법사를 실행합니다.
npm / pnpm
npm / pnpm
이미 Node 22+ 가 설치되어 있고 설치를 직접 관리하고 싶다면 다음을 사용하십시오.
From source
From source
기여자이거나 로컬 체크아웃에서 실행하려는 경우에 적합합니다.
기타 설치 방법
Docker
컨테이너화 또는 헤드리스 배포.
Podman
루트리스 컨테이너:
setup-podman.sh를 한 번 실행한 후, 런치 스크립트를 실행하세요.Nix
Nix 를 통한 선언적 설치.
Ansible
자동화된 대규모 프로비저닝.
Bun
Bun 런타임을 통한 CLI 전용 사용.
설치 후
모든 것이 정상적으로 작동하는지 확인하십시오.- 홈 디렉터리 기반 내부 경로에는
OPENCLAW_HOME - 변경 가능한 상태 위치에는
OPENCLAW_STATE_DIR - 설정 파일 위치에는
OPENCLAW_CONFIG_PATH
문제 해결: openclaw 을(를) 찾을 수 없음
PATH diagnosis and fix
PATH diagnosis and fix
빠른 진단:Windows 에서는
$(npm prefix -g)/bin (macOS/Linux) 또는 $(npm prefix -g) (Windows) 가 $PATH 에 포함되어 있지 않다면, 셸에서 전역 npm 바이너리(openclaw 포함)를 찾을 수 없습니다.해결 방법 — 셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에 이를 추가하십시오.npm prefix -g 의 출력 값을 PATH 에 추가하십시오.그런 다음 새 터미널을 열거나(zsh 에서는 rehash, bash 에서는 hash -r 를 실행하십시오).업데이트 / 제거
Updating
OpenClaw 를 최신 상태로 유지합니다.
Migrating
새 머신으로 이동합니다.
Uninstall
OpenClaw 를 완전히 제거합니다.