Instalasi

Persyaratan sistem

• Node 22.22.3+, 24.15+, atau 25.9+ - Node 24 adalah target default; skrip penginstal menanganinya secara otomatis.
• macOS, Linux, atau Windows - Pengguna Windows dapat memulai dengan aplikasi Windows Hub native, penginstal CLI PowerShell, atau Gateway WSL2. Lihat Windows.
• pnpm hanya diperlukan jika Anda membangun dari sumber.

Direkomendasikan: skrip penginstal

Cara tercepat untuk menginstal. Skrip ini mendeteksi OS Anda, menginstal Node jika diperlukan, menginstal OpenClaw, dan menjalankan orientasi awal.

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

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

Untuk menginstal tanpa menjalankan orientasi awal:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Untuk semua flag dan opsi CI/otomatisasi, lihat Cara kerja internal penginstal.

Metode instalasi alternatif

Penginstal prefiks lokal (install-cli.sh)

Gunakan ini jika Anda ingin menyimpan OpenClaw dan Node di bawah prefiks lokal seperti ~/.openclaw, tanpa bergantung pada instalasi Node di seluruh sistem:

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

Secara default, penginstal ini mendukung instalasi npm, serta instalasi checkout git dalam alur prefiks yang sama. Referensi lengkap: Cara kerja internal penginstal.

Sudah terinstal? Beralihlah antara instalasi paket dan git dengan openclaw update --channel dev dan openclaw update --channel stable. Lihat Pembaruan.

npm, pnpm, atau bun

Jika Anda sudah mengelola Node sendiri:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Dari sumber

Untuk kontributor atau siapa pun yang ingin menjalankan dari checkout lokal:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

Atau lewati penautan dan gunakan pnpm openclaw ... dari dalam repo. Lihat Penyiapan untuk alur kerja pengembangan lengkap.

Instal dari checkout main GitHub

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

Kontainer dan pengelola paket

Verifikasi instalasi

openclaw --version      # pastikan CLI tersediaopenclaw doctor         # periksa masalah konfigurasiopenclaw gateway status # pastikan Gateway sedang berjalan

Jika Anda menginginkan proses mulai terkelola setelah instalasi:

• macOS: LaunchAgent melalui openclaw onboard --install-daemon atau openclaw gateway install
• Linux/WSL2: layanan pengguna systemd melalui perintah yang sama
• Windows native: Scheduled Task sebagai pilihan pertama, dengan item masuk folder Startup per pengguna sebagai cadangan jika pembuatan tugas ditolak

Hosting dan deployment

Deploy OpenClaw pada server cloud atau VPS. Lihat Server Linux untuk pemilih penyedia lengkap (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi, dan lainnya), atau lakukan deployment secara deklaratif di Render.

Perbarui, migrasikan, atau hapus instalasi

Pemecahan masalah: openclaw tidak ditemukan

Hampir selalu merupakan masalah PATH: direktori bin global npm tidak ada di PATH shell Anda. Lihat Pemecahan masalah Node.js untuk perbaikan lengkap, termasuk jalur Windows.

node -v           # Node sudah terinstal?npm prefix -g     # Di mana paket global berada?echo "$PATH"      # Apakah direktori bin global ada di PATH?