시스템 요구 사항
- Node 22.22.3+, 24.15+ 또는 25.9+ - Node 24가 기본 대상이며, 설치 프로그램 스크립트가 이를 자동으로 처리합니다.
- macOS, Linux 또는 Windows - Windows 사용자는 네이티브 Windows Hub 앱, PowerShell CLI 설치 프로그램 또는 WSL2 Gateway로 시작할 수 있습니다. Windows를 참조하십시오.
pnpm은 소스에서 빌드하는 경우에만 필요합니다.
권장 방법: 설치 프로그램 스크립트
가장 빠른 설치 방법입니다. OS를 감지하고, 필요한 경우 Node를 설치하며, OpenClaw를 설치한 후 온보딩을 시작합니다.Windows 데스크톱 사용자는 설정, 트레이 상태, 채팅, 노드 모드 및 로컬 MCP 모드가 포함된 네이티브 Windows Hub 컴패니언 앱을 설치할 수도 있습니다.
- macOS / Linux / WSL2
- Windows (PowerShell)
- macOS / Linux / WSL2
- Windows (PowerShell)
대체 설치 방법
로컬 접두사 설치 프로그램(install-cli.sh)
시스템 전체 Node 설치에 의존하지 않고 OpenClaw와 Node를
~/.openclaw 같은 로컬 접두사 아래에 유지하려는 경우 사용하십시오.
openclaw update --channel dev 및 openclaw update --channel stable을 사용하여
패키지 설치와 git 설치 간에 전환하십시오. 업데이트를
참조하십시오.
npm, pnpm 또는 bun
Node를 직접 관리하고 있다면 다음을 사용하십시오.- npm
- pnpm
- bun
호스팅된 설치 프로그램은 OpenClaw 패키지를 설치할 때
min-release-age 같은
npm 최신성 필터를 해제합니다. npm으로 수동 설치하는 경우에는 자체
npm 정책이 계속 적용됩니다.소스에서 설치
기여자 또는 로컬 체크아웃에서 실행하려는 사용자는 다음을 사용하십시오.pnpm openclaw ...을 사용하십시오. 전체 개발 워크플로는 설정을 참조하십시오.
GitHub main 체크아웃에서 설치
컨테이너 및 패키지 관리자
Docker
컨테이너 기반 또는 헤드리스 배포입니다.
Podman
Docker를 대체하는 루트리스 컨테이너입니다.
Nix
Nix flake를 통한 선언적 설치입니다.
Ansible
자동화된 전체 시스템 프로비저닝입니다.
Bun
선택적 종속성 설치 프로그램 및 패키지 스크립트 실행기입니다.
설치 확인
- macOS:
openclaw onboard --install-daemon또는openclaw gateway install을 통한 LaunchAgent - Linux/WSL2: 동일한 명령을 통한 systemd 사용자 서비스
- 네이티브 Windows: 우선 Scheduled Task를 사용하며, 작업 생성이 거부되면 사용자별 Startup 폴더 로그인 항목으로 대체
호스팅 및 배포
클라우드 서버 또는 VPS에 OpenClaw를 배포하십시오. 전체 제공업체 선택기 (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi 등)는 Linux 서버를 참조하거나, Render에서 선언적으로 배포하십시오.VPS
제공업체를 선택합니다.
Docker VM
공유 Docker 단계입니다.
Kubernetes
K8s 배포입니다.
업데이트, 마이그레이션 또는 제거
업데이트
OpenClaw를 최신 상태로 유지합니다.
마이그레이션
새 시스템으로 이동합니다.
제거
OpenClaw를 완전히 제거합니다.
문제 해결: openclaw을 찾을 수 없음
거의 항상 PATH 문제입니다. npm의 전역 바이너리 디렉터리가 셸의 PATH에 포함되어 있지 않습니다. Windows 경로를 포함한 전체 해결 방법은 Node.js 문제 해결을 참조하십시오.