메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
시스템 요구 사항

  • Node 24(권장) 또는 Node 22.16+ - 설치 스크립트가 이를 자동으로 처리합니다
  • macOS, Linux 또는 Windows - 네이티브 Windows와 WSL2가 모두 지원되며, WSL2가 더 안정적입니다. Windows를 참조하세요.
  • 소스에서 빌드하는 경우에만 pnpm이 필요합니다

​
권장: 설치 스크립트

가장 빠른 설치 방법입니다. OS를 감지하고, 필요한 경우 Node를 설치하며, OpenClaw를 설치한 뒤 온보딩을 시작합니다. 
curl -fsSL https://openclaw.ai/install.sh | bash
온보딩을 실행하지 않고 설치하려면: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
모든 플래그와 CI/자동화 옵션은 설치 프로그램 내부 구조를 참조하세요.

​
대체 설치 방법

​
로컬 prefix 설치 프로그램(install-cli.sh)

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

​
npm, pnpm 또는 bun

Node를 직접 관리하고 있다면: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
전역으로 설치된 libvips 때문에 sharp가 실패하는 경우:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
소스에서 설치

기여자 또는 로컬 체크아웃에서 실행하려는 사용자를 위한 방법: 
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에서 설치

npm install -g github:openclaw/openclaw#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: 먼저 Scheduled Task를 사용하고, 작업 생성이 거부되면 사용자별 Startup 폴더 로그인 항목으로 대체

​
호스팅 및 배포

클라우드 서버 또는 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

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

업데이트

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

마이그레이션

새 머신으로 이동하세요.

제거

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 설정을 참조하세요.