설치

권장: 설치 프로그램 스크립트

가장 빠른 설치 방법입니다. OS를 감지하고, 필요한 경우 Node를 설치하고, OpenClaw를 설치하고, 온보딩을 시작합니다.

macOS / Linux / WSL2

    curl -fsSL https://openclaw.ai/install.sh | bash
    ```


  **Windows (PowerShell)**

```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



온보딩 실행 없이 설치하려면:

**macOS / Linux / WSL2**
�OC_CODE_1�
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```



모든 플래그 및 CI/자동화 옵션은 [설치 프로그램 내부](/install/installer)를 참조하십시오.

## 시스템 요구 사항

- **Node 24** (권장) 또는 Node 22.14+ — 설치 프로그램 스크립트가 자동으로 처리
- **macOS, Linux 또는 Windows** — 네이티브 Windows와 WSL2 모두 지원됨. WSL2가 더 안정적입니다. [Windows](/platforms/windows) 참조.
- `pnpm`은 소스에서 빌드하는 경우에만 필요

## 대안 설치 방법

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

시스템 전체 Node 설치에 의존하지 않고 `~/.openclaw`와 같은 로컬 접두사 아래에 OpenClaw와 Node를 유지하려는 경우 사용합니다:

```bash
curl -fsSL https://openclaw.ai/install-cli.sh | bash

기본적으로 npm 설치를 지원하며 동일한 접두사 흐름 아래에서 git 체크아웃 설치도 지원합니다. 전체 참조: 설치 프로그램 내부.

npm, pnpm 또는 bun

이미 Node를 직접 관리하는 경우:

npm

    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```


  **pnpm**

```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g
    openclaw onboard --install-daemon
    ```

    ::: info NOTE
pnpm은 빌드 스크립트가 있는 패키지에 대해 명시적인 승인이 필요합니다. 첫 번째 설치 후 `pnpm approve-builds -g`를 실행합니다.
:::


  **bun**
�OC_CODE_4�
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest�OC_CODE_5�
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon�OC_CODE_6�
npm install -g github:openclaw/openclaw#main�OC_CODE_7�
openclaw --version      # CLI 사용 가능 여부 확인
openclaw doctor         # 구성 문제 확인
openclaw gateway status # Gateway가 실행 중인지 확인�OC_CODE_8�
node -v           # Node가 설치되었나요?
npm prefix -g     # 전역 패키지는 어디에 있나요?
echo "$PATH"      # 전역 bin 디렉터리가 PATH에 있나요?�OC_CODE_9�
export PATH="$(npm prefix -g)/bin:$PATH"

그런 다음 새 터미널을 엽니다. 자세한 내용은 Node 설정을 참조하십시오.