Langsung ke konten utama

​
Node.js

OpenClaw membutuhkan Node 22 atau yang lebih baru. Skrip instalasi akan mendeteksi dan menginstal Node secara otomatis — halaman ini ditujukan bagi Anda yang ingin menyiapkan Node sendiri dan memastikan semuanya terhubung dengan benar (versi, PATH, instalasi global).

​
Periksa versi Anda

node -v
Jika perintah ini mencetak v22.x.x atau lebih tinggi, Anda sudah siap. Jika Node belum terinstal atau versinya terlalu lama, pilih salah satu metode instalasi di bawah ini.

​
Instal Node

Homebrew (direkomendasikan):
brew install node
Atau unduh installer macOS dari nodejs.org.
Pengelola versi memungkinkan Anda berpindah antar versi Node dengan mudah. Opsi populer:
  • fnm — cepat, lintas platform
  • nvm — digunakan secara luas di macOS/Linux
  • mise — poliglot (Node, Python, Ruby, dll.)
Contoh menggunakan fnm:
fnm install 22
fnm use 22
Pastikan pengelola versi Anda telah diinisialisasi di file startup shell Anda (~/.zshrc atau ~/.bashrc). Jika tidak, perintah openclaw mungkin tidak ditemukan di sesi terminal baru karena PATH tidak menyertakan direktori biner Node.

​
Pemecahan Masalah

​
openclaw: command not found

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

Cari prefix npm global Anda

npm prefix -g
2

Periksa apakah jalur tersebut ada di PATH

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

Tambahkan ke file startup shell Anda

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

​
Error izin (permissions) pada npm install -g (Linux)

Jika Anda melihat error EACCES, ubah prefix global npm ke direktori yang dapat ditulis 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 Anda agar perubahan bersifat permanen.