English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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 akan mendeteksi dan menginstal Node secara otomatis - halaman ini ditujukan saat Anda ingin menyiapkan Node sendiri dan memastikan semuanya tersambung dengan benar (versi, PATH, instalasi global).

Periksa versi Anda

bash
node -v

Jika ini menampilkan v24.x.x atau lebih tinggi, Anda menggunakan default yang direkomendasikan. Jika ini menampilkan v22.19.x atau lebih tinggi, Anda menggunakan jalur Node 22 LTS yang didukung, tetapi kami tetap menyarankan peningkatan ke Node 24 saat memungkinkan. Versi Node 23 sebelum v23.11.0 tidak didukung. Jika Node belum terinstal atau versinya berada di luar rentang yang didukung, pilih metode instalasi di bawah.

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.

Using a version manager (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.

  • Find your global npm prefix

    bash
    npm prefix -g

  • Check if it's on your PATH

    bash
    echo "$PATH"

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

  • Add it to your shell startup file

    macOS / Linux

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

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

    • Error izin pada npm install -g (Linux)

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

    Terkait

    Was this useful?
    On this page

    On this page