메인 콘텐츠로 건너뛰기

​
시스템 요구 사항

  • Node 24(권장) 또는 Node 22.19+ - 설치 스크립트가 이를 자동으로 처리합니다
  • macOS, Linux 또는 Windows - Windows 사용자는 네이티브 Windows Hub 앱, PowerShell CLI 설치 프로그램 또는 WSL2 Gateway로 시작할 수 있습니다. Windows를 참조하세요.
  • pnpm은 소스에서 빌드하는 경우에만 필요합니다

​
권장: 설치 스크립트

가장 빠른 설치 방법입니다. OS를 감지하고, 필요한 경우 Node를 설치하며, OpenClaw를 설치하고 온보딩을 시작합니다.
Windows 데스크톱 사용자는 설정, 트레이 상태, 채팅, 노드 모드, 로컬 MCP 모드가 포함된 네이티브 Windows Hub 컴패니언 앱도 설치할 수 있습니다.
curl -fsSL https://openclaw.ai/install.sh | bash
온보딩을 실행하지 않고 설치하려면: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
모든 플래그와 CI/자동화 옵션은 설치 프로그램 내부 구조를 참조하세요.

​
대체 설치 방법

​
로컬 접두사 설치 프로그램(install-cli.sh)

시스템 전체 Node 설치에 의존하지 않고 OpenClaw와 Node를 ~/.openclaw 같은 로컬 접두사 아래에 유지하려는 경우 사용하세요. 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
기본적으로 npm 설치를 지원하며, 같은 접두사 흐름에서 git-checkout 설치도 지원합니다. 전체 참조: 설치 프로그램 내부 구조. 이미 설치했나요? openclaw update --channel dev 및 openclaw update --channel stable로 패키지 설치와 git 설치 사이를 전환하세요. 업데이트를 참조하세요.

​
npm, pnpm 또는 bun

이미 Node를 직접 관리하고 있다면: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
호스팅된 설치 프로그램은 OpenClaw 패키지 설치에 대해 min-release-age 같은 npm 최신성 필터를 해제합니다. npm으로 수동 설치하는 경우에는 자체 npm 정책이 계속 적용됩니다.

​
소스에서 설치

기여자 또는 로컬 체크아웃에서 실행하려는 사용자는 다음을 사용하세요. 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
또는 링크를 건너뛰고 저장소 안에서 pnpm openclaw ...를 사용하세요. 전체 개발 워크플로는 설정을 참조하세요.

​
GitHub main 체크아웃에서 설치

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

​
컨테이너와 패키지 관리자

Docker

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

Podman

Docker의 루트리스 컨테이너 대안.

Nix

Nix flake를 통한 선언적 설치.

Ansible

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

Bun

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

​
설치 확인

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw gateway status # verify the Gateway is running
설치 후 관리형 시작을 원한다면:
  • macOS: openclaw onboard --install-daemon 또는 openclaw gateway install을 통한 LaunchAgent
  • Linux/WSL2: 같은 명령을 통한 systemd 사용자 서비스
  • 네이티브 Windows: 먼저 예약된 작업을 사용하고, 작업 생성이 거부되면 사용자별 시작 폴더 로그인 항목으로 대체

​
호스팅 및 배포

클라우드 서버 또는 VPS에 OpenClaw를 배포하세요.

VPS

모든 Linux VPS.

Docker VM

공유 Docker 단계.

Kubernetes

K8s 배포.

Fly.io

Fly.io에 배포.

Hetzner

Hetzner 배포.

GCP

Google Cloud 배포.

Azure

Azure 배포.

Railway

Railway 배포.

Render

Render 배포.

Northflank

Northflank 배포.

​
업데이트, 마이그레이션 또는 제거

Updating

OpenClaw를 최신 상태로 유지하세요.

Migrating

새 머신으로 이동하세요.

Uninstall

OpenClaw를 완전히 제거하세요.

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

설치가 성공했지만 터미널에서 openclaw를 찾을 수 없다면: 
node -v           # Node installed?
npm prefix -g     # Where are global packages?
echo "$PATH"      # Is the global bin dir in PATH?
$(npm prefix -g)/bin이 $PATH에 없다면 셸 시작 파일(~/.zshrc 또는 ~/.bashrc)에 추가하세요. 
export PATH="$(npm prefix -g)/bin:$PATH"
그런 다음 새 터미널을 여세요. 자세한 내용은 Node 설정을 참조하세요.