Internal installer

OpenClaw menyediakan tiga script installer, yang disajikan dari openclaw.ai.

Script	Platform	Fungsinya
`install.sh`	macOS / Linux / WSL	Menginstal Node jika diperlukan, menginstal OpenClaw via npm (default) atau git, dan dapat menjalankan onboarding.
`install-cli.sh`	macOS / Linux / WSL	Menginstal Node + OpenClaw ke prefix lokal (`~/.openclaw`) dengan mode npm atau checkout git. Tidak memerlukan root.
`install.ps1`	Windows (PowerShell)	Menginstal Node jika diperlukan, menginstal OpenClaw via npm (default) atau git, dan dapat menjalankan onboarding.

Perintah cepat

install.sh
install-cli.sh
install.ps1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Jika instalasi berhasil tetapi openclaw tidak ditemukan di terminal baru, lihat Pemecahan masalah Node.js.

install.sh

Direkomendasikan untuk sebagian besar instalasi interaktif di macOS/Linux/WSL.

Alur (install.sh)

Deteksi OS

Mendukung macOS dan Linux (termasuk WSL). Jika macOS terdeteksi, Homebrew akan diinstal jika belum ada.

Pastikan Node.js 24 secara default

Memeriksa versi Node dan menginstal Node 24 jika diperlukan (Homebrew di macOS, script setup NodeSource di Linux apt/dnf/yum). OpenClaw tetap mendukung Node 22 LTS, saat ini 22.14+, untuk kompatibilitas.

Pastikan Git

Menginstal Git jika belum ada.

Instal OpenClaw

metode npm (default): instalasi npm global
metode git: clone/update repo, instal dependensi dengan pnpm, build, lalu instal wrapper di ~/.local/bin/openclaw

Tugas pasca-instalasi

Menyegarkan layanan gateway yang sedang dimuat dengan upaya terbaik (openclaw gateway install --force, lalu restart)
Menjalankan openclaw doctor --non-interactive pada upgrade dan instalasi git (upaya terbaik)
Mencoba onboarding bila sesuai (TTY tersedia, onboarding tidak dinonaktifkan, dan pemeriksaan bootstrap/konfigurasi lolos)
Secara default menetapkan SHARP_IGNORE_GLOBAL_LIBVIPS=1

Deteksi source checkout

Jika dijalankan di dalam checkout OpenClaw (package.json + pnpm-workspace.yaml), script menawarkan:

gunakan checkout (git), atau
gunakan instalasi global (npm)

Jika tidak ada TTY yang tersedia dan tidak ada metode instalasi yang ditetapkan, script akan default ke npm dan menampilkan peringatan. Script keluar dengan kode 2 untuk pemilihan metode yang tidak valid atau nilai --install-method yang tidak valid.

Contoh (install.sh)

Default
Lewati onboarding
Instalasi git
GitHub main via npm
Dry run

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --version main

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Referensi flag

Flag	Deskripsi
`--install-method npm\|git`	Pilih metode instalasi (default: `npm`). Alias: `--method`
`--npm`	Pintasan untuk metode npm
`--git`	Pintasan untuk metode git. Alias: `--github`
`--version <version\|dist-tag\|spec>`	Versi npm, dist-tag, atau spesifikasi package (default: `latest`)
`--beta`	Gunakan dist-tag beta jika tersedia, jika tidak kembali ke `latest`
`--git-dir <path>`	Direktori checkout (default: `~/openclaw`). Alias: `--dir`
`--no-git-update`	Lewati `git pull` untuk checkout yang sudah ada
`--no-prompt`	Nonaktifkan prompt
`--no-onboard`	Lewati onboarding
`--onboard`	Aktifkan onboarding
`--dry-run`	Cetak tindakan tanpa menerapkan perubahan
`--verbose`	Aktifkan output debug (`set -x`, log npm level notice)
`--help`	Tampilkan penggunaan (`-h`)

Referensi variabel environment

Variable	Description
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_VERSION=latest\|next\|main\|<semver>\|<spec>`	Versi npm, dist-tag, atau spesifikasi package
`OPENCLAW_BETA=0\|1`	Gunakan beta jika tersedia
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout
`OPENCLAW_GIT_UPDATE=0\|1`	Aktif/nonaktifkan update git
`OPENCLAW_NO_PROMPT=1`	Nonaktifkan prompt
`OPENCLAW_NO_ONBOARD=1`	Lewati onboarding
`OPENCLAW_DRY_RUN=1`	Mode dry run
`OPENCLAW_VERBOSE=1`	Mode debug
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Level log npm
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	Kontrol perilaku sharp/libvips (default: `1`)

install-cli.sh

Dirancang untuk lingkungan tempat Anda ingin semuanya berada di bawah prefix lokal (default ~/.openclaw) dan tanpa dependensi Node sistem. Mendukung instalasi npm secara default, plus instalasi checkout git dalam alur prefix yang sama.

Alur (install-cli.sh)

Instal runtime Node lokal

Mengunduh tarball Node LTS yang didukung dan dipin (versinya tertanam dalam script dan diperbarui secara independen) ke <prefix>/tools/node-v<version> dan memverifikasi SHA-256.

Pastikan Git

Jika Git tidak ada, mencoba menginstalnya via apt/dnf/yum di Linux atau Homebrew di macOS.

Instal OpenClaw di bawah prefix

metode npm (default): menginstal di bawah prefix dengan npm, lalu menulis wrapper ke <prefix>/bin/openclaw
metode git: clone/update checkout (default ~/openclaw) dan tetap menulis wrapper ke <prefix>/bin/openclaw

Segarkan layanan gateway yang sedang dimuat

Jika layanan gateway sudah dimuat dari prefix yang sama, script menjalankan openclaw gateway install --force, lalu openclaw gateway restart, dan memeriksa kesehatan gateway dengan upaya terbaik.

Contoh (install-cli.sh)

Default
Prefix + versi kustom
Instalasi git
Output JSON untuk otomasi
Jalankan onboarding

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Referensi flag

Flag	Deskripsi
`--prefix <path>`	Prefix instalasi (default: `~/.openclaw`)
`--install-method npm\|git`	Pilih metode instalasi (default: `npm`). Alias: `--method`
`--npm`	Pintasan untuk metode npm
`--git`, `--github`	Pintasan untuk metode git
`--git-dir <path>`	Direktori checkout git (default: `~/openclaw`). Alias: `--dir`
`--version <ver>`	Versi atau dist-tag OpenClaw (default: `latest`)
`--node-version <ver>`	Versi Node (default: `22.22.0`)
`--json`	Keluarkan event NDJSON
`--onboard`	Jalankan `openclaw onboard` setelah instalasi
`--no-onboard`	Lewati onboarding (default)
`--set-npm-prefix`	Di Linux, paksa prefix npm ke `~/.npm-global` jika prefix saat ini tidak dapat ditulisi
`--help`	Tampilkan penggunaan (`-h`)

Referensi variabel environment

Variable	Description
`OPENCLAW_PREFIX=<path>`	Prefix instalasi
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_VERSION=<ver>`	Versi atau dist-tag OpenClaw
`OPENCLAW_NODE_VERSION=<ver>`	Versi Node
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout git untuk instalasi git
`OPENCLAW_GIT_UPDATE=0\|1`	Aktif/nonaktifkan update git untuk checkout yang sudah ada
`OPENCLAW_NO_ONBOARD=1`	Lewati onboarding
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Level log npm
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	Kontrol perilaku sharp/libvips (default: `1`)

install.ps1

Alur (install.ps1)

Pastikan lingkungan PowerShell + Windows

Memerlukan PowerShell 5+.

Pastikan Node.js 24 secara default

Jika belum ada, mencoba instalasi via winget, lalu Chocolatey, lalu Scoop. Node 22 LTS, saat ini 22.14+, tetap didukung untuk kompatibilitas.

Instal OpenClaw

metode npm (default): instalasi npm global menggunakan -Tag yang dipilih
metode git: clone/update repo, instal/build dengan pnpm, dan instal wrapper di %USERPROFILE%\.local\bin\openclaw.cmd

Tugas pasca-instalasi

Menambahkan direktori bin yang diperlukan ke PATH pengguna jika memungkinkan
Menyegarkan layanan gateway yang sedang dimuat dengan upaya terbaik (openclaw gateway install --force, lalu restart)
Menjalankan openclaw doctor --non-interactive pada upgrade dan instalasi git (upaya terbaik)

Contoh (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag main

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun

# install.ps1 belum memiliki flag -Verbose khusus.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

Referensi flag

Flag	Deskripsi
`-InstallMethod npm\|git`	Metode instalasi (default: `npm`)
`-Tag <tag\|version\|spec>`	npm dist-tag, versi, atau spesifikasi package (default: `latest`)
`-GitDir <path>`	Direktori checkout (default: `%USERPROFILE%\openclaw`)
`-NoOnboard`	Lewati onboarding
`-NoGitUpdate`	Lewati `git pull`
`-DryRun`	Hanya cetak tindakan

Referensi variabel environment

Variable	Description
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout
`OPENCLAW_NO_ONBOARD=1`	Lewati onboarding
`OPENCLAW_GIT_UPDATE=0`	Nonaktifkan git pull
`OPENCLAW_DRY_RUN=1`	Mode dry run

Jika -InstallMethod git digunakan dan Git tidak ada, script akan keluar dan menampilkan tautan Git for Windows.

CI dan otomasi

Gunakan flag/variabel environment non-interaktif untuk eksekusi yang dapat diprediksi.

install.sh (npm non-interaktif)
install.sh (git non-interaktif)
install-cli.sh (JSON)
install.ps1 (lewati onboarding)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Pemecahan masalah

Mengapa Git diperlukan?

Git diperlukan untuk metode instalasi git. Untuk instalasi npm, Git tetap diperiksa/diinstal untuk menghindari kegagalan spawn git ENOENT saat dependensi menggunakan URL git.

Mengapa npm mengalami EACCES di Linux?

Beberapa penyiapan Linux mengarahkan prefix global npm ke path yang dimiliki root. install.sh dapat mengubah prefix ke ~/.npm-global dan menambahkan ekspor PATH ke file rc shell (jika file tersebut ada).

Masalah sharp/libvips

Script secara default menetapkan SHARP_IGNORE_GLOBAL_LIBVIPS=1 untuk menghindari sharp melakukan build terhadap libvips sistem. Untuk menimpanya:

SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Windows: "npm error spawn git / ENOENT"

Instal Git for Windows, buka ulang PowerShell, lalu jalankan ulang installer.

Windows: "openclaw is not recognized"

Jalankan npm config get prefix dan tambahkan direktori tersebut ke PATH pengguna Anda (tidak perlu akhiran \bin di Windows), lalu buka ulang PowerShell.

Windows: cara mendapatkan output installer verbose

install.ps1 saat ini tidak mengekspos switch -Verbose. Gunakan tracing PowerShell untuk diagnostik tingkat script:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

openclaw tidak ditemukan setelah instalasi

Biasanya ini masalah PATH. Lihat Pemecahan masalah Node.js.

Install overview

Containers

Hosting

Maintenance

Internal Installer

Internal installer

Perintah cepat

install.sh

Alur (install.sh)

Deteksi source checkout

Contoh (install.sh)

install-cli.sh

Alur (install-cli.sh)

Contoh (install-cli.sh)

install.ps1

Alur (install.ps1)

Contoh (install.ps1)

CI dan otomasi

Pemecahan masalah

Install overview

Containers

Hosting

Maintenance

​Internal installer

​Perintah cepat

​install.sh

​Alur (install.sh)

​Deteksi source checkout

​Contoh (install.sh)

​install-cli.sh

​Alur (install-cli.sh)

​Contoh (install-cli.sh)

​install.ps1

​Alur (install.ps1)

​Contoh (install.ps1)

​CI dan otomasi

​Pemecahan masalah

Internal installer

Perintah cepat

install.sh

Alur (install.sh)

Deteksi source checkout

Contoh (install.sh)

install-cli.sh

Alur (install-cli.sh)

Contoh (install-cli.sh)

install.ps1

Alur (install.ps1)

Contoh (install.ps1)

CI dan otomasi

Pemecahan masalah