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.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 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.x.x atau yang lebih tinggi adalah versi default yang direkomendasikan. v22.19.x atau yang lebih tinggi adalah jalur Node 22 LTS yang didukung (tingkatkan ke Node 24 jika memungkinkan). Build Node 23 sebelum v23.11.0 tidak didukung. Jika Node belum 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. Pilihan populer:

  • fnm - cepat, lintas platform
  • nvm - digunakan secara luas di macOS/Linux
  • mise - mendukung berbagai bahasa (Node, Python, Ruby, dan sebagainya)

Contoh dengan fnm:

bash
fnm install 24fnm use 24

Pemecahan masalah

openclaw: command not found

Hal ini hampir selalu berarti direktori bin global npm tidak ada dalam PATH Anda.

  • Temukan prefiks npm global Anda

    bash
    npm prefix -g

  • Periksa apakah direktori tersebut ada dalam PATH Anda

    bash
    echo "$PATH"

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

  • Tambahkan ke berkas awal 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 ditulisi 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 tersebut permanen.

    Terkait

    Was this useful?
    On this page

    On this page