English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

Node.js

OpenClaw memerlukan Node 22.16 atau yang lebih baru. Node 24 adalah runtime default dan direkomendasikan untuk instalasi, CI, dan alur kerja rilis. Node 22 tetap didukung melalui jalur LTS aktif. skrip penginstal akan mendeteksi dan menginstal Node secara otomatis - halaman ini ditujukan saat Anda ingin menyiapkan Node sendiri dan memastikan semuanya terhubung dengan benar (versi, PATH, instalasi global).

Periksa versi Anda

node -v

Jika ini mencetak v24.x.x atau lebih tinggi, Anda menggunakan default yang direkomendasikan. Jika ini mencetak v22.16.x atau lebih tinggi, Anda menggunakan jalur Node 22 LTS yang didukung, tetapi kami tetap menyarankan peningkatan ke Node 24 saat memungkinkan. Jika Node belum terinstal atau versinya terlalu lama, pilih metode instalasi di bawah ini.

Instal Node

macOS

Homebrew (direkomendasikan):

brew install node

Atau unduh penginstal macOS dari nodejs.org.

Linux

Ubuntu / Debian:

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

Fedora / RHEL:

sudo dnf install nodejs

Atau gunakan manajer versi (lihat di bawah).

Windows

winget (direkomendasikan):

winget install OpenJS.NodeJS.LTS

Chocolatey:

choco install nodejs-lts

Atau unduh penginstal Windows dari nodejs.org.

Using a version manager (nvm, fnm, mise, asdf)

Manajer 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

Pemecahan masalah

openclaw: command not found

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

  • Find your global npm prefix

    npm prefix -g

  • Check if it's on your PATH

    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

    Windows

    Tambahkan output dari npm prefix -g ke PATH sistem Anda melalui Settings → System → Environment Variables.

    • Kesalahan izin pada npm install -g (Linux)

    Jika Anda melihat kesalahan EACCES, ubah 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