Langsung ke konten utama

​
Node.js

OpenClaw memerlukan Node 22.14 atau yang lebih baru. Node 24 adalah runtime default dan yang direkomendasikan untuk instalasi, CI, dan alur kerja rilis. Node 22 tetap didukung melalui jalur LTS aktif. Skrip installer akan mendeteksi dan menginstal Node secara otomatis — halaman ini ditujukan untuk saat Anda ingin menyiapkan Node sendiri dan memastikan semuanya terhubung 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.14.x atau lebih tinggi, Anda berada di jalur Node 22 LTS yang didukung, tetapi kami tetap merekomendasikan upgrade ke Node 24 saat memungkinkan. Jika Node belum terinstal atau versinya terlalu lama, pilih salah satu metode instalasi di bawah.

​
Instal Node

Homebrew (direkomendasikan):
brew install node
Atau unduh installer macOS dari nodejs.org.
Version manager memungkinkan Anda berpindah antarversi Node dengan mudah. Opsi yang populer:
  • fnm — cepat, lintas platform
  • nvm — banyak digunakan di macOS/Linux
  • mise — multibahasa (Node, Python, Ruby, dll.)
Contoh dengan fnm:
fnm install 24
fnm use 24
Pastikan version manager 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

Temukan prefix npm global Anda

npm prefix -g
2

Periksa apakah prefix itu ada di PATH Anda

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

Tambahkan ke file startup shell Anda

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).

​
Kesalahan izin pada npm install -g (Linux)

Jika Anda melihat kesalahan EACCES, ubah prefix global npm ke direktori yang dapat ditulisi oleh 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 agar permanen.

​
Terkait