Pasang

Persyaratan sistem

• Node 24 (direkomendasikan) atau Node 22.19+ - 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 onboarding.

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

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

Untuk menginstal tanpa menjalankan onboarding:

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/otomasi, lihat Internal penginstal.

Metode instalasi alternatif

Penginstal prefiks lokal (install-cli.sh)

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

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

Ini mendukung instalasi npm secara default, ditambah instalasi git-checkout dalam alur prefiks yang sama. Referensi lengkap: Internal penginstal.

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

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 link dan gunakan pnpm openclaw ... dari dalam repo. 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

Container dan manajer paket

Verifikasi instalasi

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

Jika Anda ingin startup 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 fallback item login folder Startup per pengguna jika pembuatan tugas ditolak

Hosting dan deployment

Deploy OpenClaw di server cloud atau VPS:

Perbarui, migrasikan, atau hapus instalasi

Pemecahan masalah: openclaw tidak ditemukan

Jika instalasi berhasil tetapi openclaw tidak ditemukan di terminal Anda:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

Jika $(npm prefix -g)/bin tidak ada di $PATH Anda, tambahkan ke file startup shell Anda (~/.zshrc atau ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

Lalu buka terminal baru. Lihat Penyiapan Node untuk detail selengkapnya.