Langsung ke konten utama
OpenClaw memerlukan Node 22.19+, Node 23.11+, atau Node 24+. Node 24 adalah runtime default dan yang direkomendasikan untuk instalasi, CI, dan alur kerja rilis. Node 22 tetap didukung melalui lini LTS aktif. skrip penginstal akan mendeteksi dan menginstal Node secara otomatis - halaman ini ditujukan saat Anda ingin menyiapkan Node sendiri dan memastikan semuanya tersambung dengan benar (versi, PATH, instalasi global).

​
Periksa versi Anda

node -v
Jika ini menampilkan v24.x.x atau lebih tinggi, Anda menggunakan default yang direkomendasikan. Jika ini menampilkan v22.19.x atau lebih tinggi, Anda menggunakan jalur Node 22 LTS yang didukung, tetapi kami tetap menyarankan peningkatan ke Node 24 saat memungkinkan. Versi Node 23 sebelum v23.11.0 tidak didukung. Jika Node belum terinstal atau versinya berada di luar rentang yang didukung, pilih metode instalasi di bawah.

​
Instal Node

Homebrew (direkomendasikan):
brew install node
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:
fnm install 24
fnm use 24
Pastikan pengelola versi Anda diinisialisasi di file startup shell Anda (~/.zshrc atau ~/.bashrc). Jika tidak, openclaw mungkin tidak ditemukan di 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

Find your global npm prefix

npm prefix -g
2

Check if it's on your PATH

echo "$PATH"
Cari <npm-prefix>/bin (macOS/Linux) atau <npm-prefix> (Windows) di output.
3

Add it to your shell startup file

Tambahkan ke ~/.zshrc atau ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Lalu buka terminal baru (atau jalankan rehash di zsh / hash -r di bash).

​
Error izin pada npm install -g (Linux)

Jika Anda melihat error EACCES, alihkan prefix global npm ke direktori yang dapat ditulis pengguna: 
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Tambahkan baris export PATH=... ke ~/.bashrc atau ~/.zshrc Anda agar permanen.

​
Terkait