一键部署 OpenClaw|OpenClaw一键部署脚本|OpenClaw一键安装

Node.js 22+ 설치

OpenClaw은 Node.js 22 이상이 필요합니다. 플랫폼을 선택하여 다운로드하세요:

Windows 64-bit (.msi) Windows ARM64 (.msi) macOS (.pkg) Linux x64 (.tar.xz)

Windows 사용자 참고: .msi 설치 프로그램은 PATH 환경 변수를 자동으로 구성합니다. 설치 후 터미널에서 node 명령을 찾을 수 없는 경우, Node.js 설치 경로(기본값 C:\Program Files\nodejs\)를 시스템 PATH에 수동으로 추가한 후 터미널을 다시 여세요.

패키지 매니저로도 설치할 수 있습니다:

Windows (winget)

winget install OpenJS.NodeJS.LTS

macOS (Homebrew)

brew install node@22

Linux (Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs

Node.js 설치 확인

터미널을 열고 다음 명령어로 버전을 확인하세요:

node --version

출력은 v22.x.x 이상이어야 합니다

OpenClaw 전역 설치

npm으로 원커맨드 설치:

npm install -g openclaw

설치 확인

OpenClaw이 올바르게 설치되었는지 확인:

openclaw --version

API Key 설정

처음 실행 시 AI 모델 API Key 설정을 안내합니다:

openclaw init

Anthropic Claude, OpenAI GPT, 로컬 Ollama 등 지원

OpenClaw 시작

준비 완료 — AI 어시스턴트를 시작하세요:

openclaw start

기본적으로 http://localhost:3000에서 관리 패널이 시작됩니다

Docker 설치

Docker Engine 20.10+ 또는 Docker Desktop이 설치되어 있는지 확인하세요:

Windows Docker Desktop macOS Docker Desktop (Intel) macOS Docker Desktop (Apple Silicon)

Linux 사용자는 명령어로 설치 가능:

curl -fsSL https://get.docker.com | sh

이미지 풀

Docker Hub에서 최신 OpenClaw 이미지를 풀합니다:

docker pull openclaw/openclaw:latest

설정 파일 생성

로컬에 설정 디렉토리와 파일을 생성합니다:

mkdir -p ~/.openclaw && touch ~/.openclaw/config.json5

config.json5에서 API Key와 채널 정보를 설정하세요

컨테이너 시작

설정 디렉토리를 마운트하여 Docker 컨테이너를 실행:

docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw --restart unless-stopped openclaw/openclaw:latest

로그 확인

컨테이너가 정상적으로 실행 중인지 확인:

docker logs -f openclaw

Docker Compose 권장 구성

프로덕션 환경에서는 Docker Compose를 사용하여 멀티 서비스를 쉽게 관리하세요:

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    ports:
      - "3000:3000"
    volumes:
      - ./config:/root/.openclaw
    restart: unless-stopped

docker-compose.yml로 저장하고 docker compose up -d로 시작

Node.js 22+ 및 Git 설치

소스 빌드에는 Node.js 22+와 Git이 필요합니다.

Node.js Windows Node.js macOS Git Windows

환경 확인

Node.js, Git, npm이 올바르게 설치되었는지 확인:

node --version && git --version && npm --version

저장소 클론

GitHub에서 OpenClaw 소스 코드를 클론:

git clone https://github.com/openclaw/openclaw.git

의존성 설치 및 빌드

프로젝트 디렉토리로 이동하여 의존성을 설치하고 빌드:

cd openclaw && npm install && npm run build

설정 및 시작

설정을 초기화하고 서비스를 시작:

npm run init && npm start

기본적으로 http://localhost:3000에서 관리 패널이 시작됩니다

시스템 요구사항

운영체제

Windows 10+, macOS 12+, Ubuntu 20.04+

Node.js 22+

npm 설치 및 소스 빌드에 필수

2GB+ 메모리

최소 2GB RAM, 4GB 이상 권장

API Key

Anthropic 또는 OpenAI 등의 모델 API Key 필요 (또는 로컬 Ollama 사용)

네트워크 연결

AI 모델 API 접근 필요 (로컬 모델 제외)

디스크 공간

최소 500MB 여유 공간

OpenClaw 시작하기

무료 오픈소스. 명령어 하나로 설치. WhatsApp, Telegram, Discord 등에 연결 가능.

전체 튜토리얼 카테고리

OpenClaw 원클릭 배포