Instal

# Persyaratan sistem

• Node 24 (direkomendasikan) atau Node 22.14+ - skrip penginstal menanganinya secara otomatis
• macOS, Linux, atau Windows - Windows native dan WSL2 didukung; WSL2 lebih stabil. Lihat Windows.
• pnpm hanya diperlukan jika Anda membangun dari source

# Direkomendasikan: skrip penginstal

Cara tercepat untuk menginstal. Ini mendeteksi OS Anda, menginstal Node jika diperlukan, menginstal OpenClaw, dan meluncurkan 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/otomatisasi, lihat Internal penginstal.

# Metode instal alternatif

# Penginstal prefix lokal (install-cli.sh)

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

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

Ini mendukung instal npm secara default, plus instal git-checkout di bawah alur prefix yang sama. Referensi lengkap: Internal penginstal.

Sudah terinstal? Beralih antara instal 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@latest
openclaw onboard --install-daemon

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

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# Dari source

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

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

# Instal dari GitHub main

npm install -g github:openclaw/openclaw#main

# Container dan manajer paket

# Verifikasi instalasi

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

Jika Anda menginginkan 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 task ditolak

# Hosting dan deployment

Deploy OpenClaw di server cloud atau VPS:

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

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