Skip to main content
OpenClaw memerlukan Node 22.22.3+, Node 24.15+, atau Node 25.9+. Node 24 adalah runtime default dan yang direkomendasikan untuk instalasi, CI, dan alur kerja rilis; Node 22 tetap didukung melalui lini LTS aktif. Node 23 tidak didukung. Skrip penginstal mendeteksi dan menginstal Node secara otomatis — gunakan halaman ini jika Anda ingin menyiapkan Node sendiri (versi, PATH, instalasi global).

​
Periksa versi Anda

v24.15.0 atau 24.x yang lebih baru adalah default yang direkomendasikan. v22.22.3 atau 22.x yang lebih baru adalah jalur Node 22 LTS yang didukung; Node v25.9.0+ juga didukung. Node 23 tidak didukung. Jika Node tidak tersedia atau berada di luar rentang yang didukung, pilih metode instalasi di bawah ini.

​
Instal Node

Homebrew (direkomendasikan):
Atau unduh penginstal macOS dari nodejs.org.
Pengelola versi memungkinkan Anda beralih antarversi Node dengan mudah. Opsi populer:
  • fnm - cepat, lintas platform
  • nvm - banyak digunakan di macOS/Linux
  • mise - poliglot (Node, Python, Ruby, dll.)
Contoh dengan fnm:
Inisialisasi pengelola versi di berkas startup shell Anda (~/.zshrc atau ~/.bashrc). Jika langkah ini dilewati, openclaw mungkin tidak ditemukan dalam sesi terminal baru karena PATH tidak akan menyertakan direktori bin Node.

​
Pemecahan masalah

​
openclaw: command not found

Ini hampir selalu berarti direktori bin global npm tidak ada di PATH Anda.
1

Temukan prefiks npm global Anda

2

Periksa apakah direktori tersebut ada di PATH Anda

Cari <npm-prefix>/bin (macOS/Linux) atau <npm-prefix> (Windows) dalam output.
3

Tambahkan direktori tersebut ke berkas startup shell Anda

Tambahkan ke ~/.zshrc atau ~/.bashrc:
Kemudian buka terminal baru (atau jalankan rehash di zsh / hash -r di bash).

​
Kesalahan izin pada npm install -g (Linux)

Jika Anda melihat kesalahan EACCES, ubah prefiks global npm ke direktori yang dapat ditulis oleh pengguna:
Tambahkan baris export PATH=... ke ~/.bashrc atau ~/.zshrc agar perubahan ini permanen.

​
Terkait