Install overview
Instal
Persyaratan sistem
- Node 24 (direkomendasikan) atau Node 22.16+ - skrip penginstal menanganinya secara otomatis
- macOS, Linux, atau Windows - Windows native dan WSL2 didukung; WSL2 lebih stabil. Lihat Windows.
pnpmhanya 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.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexUntuk menginstal tanpa menjalankan onboarding:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardUntuk 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 tingkat sistem:
curl -fsSL https://openclaw.ai/install-cli.sh | bashPenginstal ini mendukung instalasi npm secara default, ditambah instalasi git-checkout di bawah 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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonPemecahan masalah: kesalahan build sharp (npm)
Jika sharp gagal karena libvips yang terinstal secara global:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestDari 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-daemonAtau 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#mainContainer dan manajer paket
Deployment ter-container atau headless.
Alternatif container rootless untuk Docker.
Instalasi deklaratif melalui Nix flake.
Penyediaan fleet otomatis.
Penggunaan hanya CLI melalui runtime Bun.
Verifikasi instalasi
openclaw --version # konfirmasi CLI tersediaopenclaw doctor # periksa masalah konfigurasiopenclaw gateway status # verifikasi Gateway berjalanJika Anda ingin startup terkelola setelah instalasi:
- macOS: LaunchAgent melalui
openclaw onboard --install-daemonatauopenclaw 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
Jaga OpenClaw tetap terbaru.
Pindah ke mesin baru.
Hapus OpenClaw sepenuhnya.
Pemecahan masalah: openclaw tidak ditemukan
Jika instalasi berhasil tetapi openclaw tidak ditemukan di terminal Anda:
node -v # Node terinstal?npm prefix -g # Di mana paket global berada?echo "$PATH" # Apakah direktori bin global ada di 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 lebih lanjut.