OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Install overview

Node.js

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

bash
node -v

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

macOS

Homebrew (direkomendasikan):

bash
brew install node

Atau unduh penginstal macOS dari nodejs.org.

Linux

Ubuntu / Debian:

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

Fedora / RHEL:

bash
sudo dnf install nodejs

Atau gunakan pengelola versi (lihat di bawah).

Windows

winget (direkomendasikan):

powershell
winget install OpenJS.NodeJS.LTS

Chocolatey:

powershell
choco install nodejs-lts

Atau unduh penginstal Windows dari nodejs.org.

Menggunakan pengelola versi (nvm, fnm, mise, asdf)

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:

bash
fnm install 24fnm use 24

Pemecahan masalah

openclaw: command not found

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

  • Temukan prefiks npm global Anda

    bash
    npm prefix -g

  • Periksa apakah direktori tersebut ada di PATH Anda

    bash
    echo "$PATH"

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

  • Tambahkan direktori tersebut ke berkas startup shell Anda

    macOS / Linux

    Tambahkan ke ~/.zshrc atau ~/.bashrc:

    bash
    export PATH="$(npm prefix -g)/bin:$PATH"

    Kemudian 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 prefiks global npm ke direktori yang dapat ditulis oleh pengguna:

    bash
    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 perubahan ini permanen.

    Terkait

    Was this useful?
    On this page

    On this page