Instalasi

Persyaratan sistem

• Node 22.19+, 23.11+, atau 24+ - Node 24 adalah target bawaan; 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 proses orientasi awal.

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

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

Untuk menginstal tanpa menjalankan proses 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 Internal penginstal.

Metode instalasi alternatif

Penginstal dengan prefiks lokal (install-cli.sh)

Gunakan ini saat 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 bawaan, penginstal ini mendukung instalasi npm, serta instalasi dari checkout git dalam alur prefiks yang sama. Referensi lengkap: 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 repositori. Lihat Penyiapan untuk alur kerja pengembangan lengkap.

Instal dari checkout utama 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 berjalan

Jika Anda menginginkan proses awal 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 terlebih dahulu, dengan item masuk folder Startup per pengguna sebagai cadangan jika pembuatan tugas ditolak

Hosting dan penerapan

Terapkan OpenClaw di 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 terapkan 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 terinstal?npm prefix -g     # Di mana paket global berada?echo "$PATH"      # Apakah direktori bin global ada di PATH?