OpenClawDocs
Di halaman ini

Di halaman ini

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

Runtimes

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?