Internal penginstal

OpenClaw menyediakan tiga skrip penginstal, disajikan dari openclaw.ai.

Skrip	Platform	Yang dilakukan
`install.sh`	macOS / Linux / WSL	Menginstal Node jika diperlukan, menginstal OpenClaw melalui npm (default) atau git, dan dapat menjalankan onboarding.
`install-cli.sh`	macOS / Linux / WSL	Menginstal Node + OpenClaw ke prefiks lokal (`~/.openclaw`) dengan mode npm atau git checkout. Tidak memerlukan root.
`install.ps1`	Windows (PowerShell)	Menginstal Node jika diperlukan, menginstal OpenClaw melalui 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 penginstalan berhasil tetapi openclaw tidak ditemukan di terminal baru, lihat pemecahan masalah Node.js.

install.sh

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

Alur (install.sh)

Mendeteksi OS

Mendukung macOS dan Linux (termasuk WSL).

Memastikan Node.js 24 secara default

Memeriksa versi Node dan menginstal Node 24 jika diperlukan (Homebrew di macOS, skrip penyiapan NodeSource di Linux apt/dnf/yum). Di macOS, Homebrew hanya diinstal saat penginstal memerlukannya untuk Node atau Git. OpenClaw tetap mendukung Node 22 LTS, saat ini 22.19+, untuk kompatibilitas. Di Alpine/musl Linux, penginstal menggunakan paket apk alih-alih NodeSource; repositori Alpine yang dikonfigurasi harus menyediakan Node 22.19+ (Alpine 3.21 atau lebih baru pada saat penulisan).

Memastikan Git

Menginstal Git jika belum ada menggunakan manajer paket yang terdeteksi, termasuk Homebrew di macOS dan apk di Alpine.

Menginstal OpenClaw

Metode npm (default): penginstalan 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 dimuat secara upaya terbaik (openclaw gateway install --force, lalu mulai ulang)
Menjalankan openclaw doctor --non-interactive pada upgrade dan penginstalan git (upaya terbaik)
Mencoba onboarding saat sesuai (TTY tersedia, onboarding tidak dinonaktifkan, dan pemeriksaan bootstrap/konfigurasi lulus)

Deteksi checkout sumber

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

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

Jika tidak ada TTY yang tersedia dan tidak ada metode instalasi yang ditetapkan, default-nya adalah npm dan memberi peringatan. Skrip keluar dengan kode 2 untuk pemilihan metode yang tidak valid atau nilai --install-method yang tidak valid.

Contoh (install.sh)

Default
Lewati onboarding
Penginstalan Git
Checkout main GitHub
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 -- --install-method git --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 paket (default: `latest`)
`--beta`	Gunakan dist-tag beta jika tersedia, jika tidak fallback 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 tingkat notice npm)
`--help`	Tampilkan penggunaan (`-h`)

Referensi variabel lingkungan

Variabel	Deskripsi
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_VERSION=latest\|next\|<semver>\|<spec>`	Versi npm, dist-tag, atau spesifikasi paket
`OPENCLAW_BETA=0\|1`	Gunakan beta jika tersedia
`OPENCLAW_HOME=<path>`	Direktori dasar untuk state OpenClaw dan path git/onboarding default
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout
`OPENCLAW_GIT_UPDATE=0\|1`	Aktifkan/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`	Tingkat log npm

install-cli.sh

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

Alur (install-cli.sh)

Menginstal runtime Node lokal

Mengunduh tarball Node LTS yang didukung dan dipin (versinya disematkan di skrip dan diperbarui secara independen) ke <prefix>/tools/node-v<version> dan memverifikasi SHA-256. Di Alpine/musl Linux, tempat Node tidak menerbitkan tarball yang kompatibel untuk runtime yang dipin, menginstal nodejs dan npm dengan apk dan menautkan runtime tersebut ke path wrapper prefiks. Repositori Alpine harus menyediakan Node 22.19+; gunakan Alpine 3.21 atau lebih baru jika repositori lama hanya menyediakan Node 20 atau 21.

Memastikan Git

Jika Git belum ada, mencoba instalasi melalui apt/dnf/yum/apk di Linux atau Homebrew di macOS.

Menginstal OpenClaw di bawah prefiks

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

Menyegarkan layanan Gateway yang dimuat

Jika layanan Gateway sudah dimuat dari prefiks yang sama, skrip menjalankan openclaw gateway install --force, lalu openclaw gateway restart, dan memeriksa kesehatan Gateway secara upaya terbaik.

Contoh (install-cli.sh)

Default
Prefiks + versi kustom
Penginstalan Git
Output JSON otomatisasi
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>`	Prefiks 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 OpenClaw atau dist-tag (default: `latest`)
`--node-version <ver>`	Versi Node (default: `22.22.0`)
`--json`	Keluarkan peristiwa NDJSON
`--onboard`	Jalankan `openclaw onboard` setelah instalasi
`--no-onboard`	Lewati orientasi awal (default)
`--set-npm-prefix`	Di Linux, paksa prefiks npm ke `~/.npm-global` jika prefiks saat ini tidak dapat ditulis
`--help`	Tampilkan penggunaan (`-h`)

Environment variables reference

Variabel	Deskripsi
`OPENCLAW_PREFIX=<path>`	Prefiks instalasi
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_VERSION=<ver>`	Versi OpenClaw atau dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Versi Node
`OPENCLAW_HOME=<path>`	Direktori dasar untuk status OpenClaw dan jalur git/orientasi awal default
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout Git untuk instalasi git
`OPENCLAW_GIT_UPDATE=0\|1`	Alihkan pembaruan git untuk checkout yang sudah ada
`OPENCLAW_NO_ONBOARD=1`	Lewati orientasi awal
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	Level log npm

install.ps1

Alur (install.ps1)

Ensure PowerShell + Windows environment

Memerlukan PowerShell 5+.

Ensure Node.js 24 by default

Jika tidak ada, mencoba instalasi melalui winget, lalu Chocolatey, lalu Scoop. Jika tidak ada manajer paket yang tersedia, skrip mengunduh zip resmi Node.js Windows ke %LOCALAPPDATA%\OpenClaw\deps\portable-node dan menambahkannya ke proses saat ini serta PATH pengguna. Node 22 LTS, saat ini 22.19+, tetap didukung untuk kompatibilitas.

Install OpenClaw

Metode npm (default): instalasi npm global menggunakan -Tag yang dipilih, dijalankan dari direktori sementara penginstal yang dapat ditulis sehingga shell yang dibuka di folder terlindungi seperti C:\ tetap berfungsi
Metode git: clone/perbarui repo, instal/build dengan pnpm, dan instal wrapper di %USERPROFILE%\.local\bin\openclaw.cmd. Jika Git tidak ada, skrip melakukan bootstrap MinGit lokal pengguna di %LOCALAPPDATA%\OpenClaw\deps\portable-git dan menambahkannya ke proses saat ini serta PATH pengguna.

Post-install tasks

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

Handle failures

Instalasi iwr ... | iex dan scriptblock melaporkan error penghentian tanpa menutup sesi PowerShell saat ini. Instalasi langsung powershell -File / pwsh -File tetap keluar dengan kode non-nol untuk otomatisasi.

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))) -InstallMethod git -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 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0

Flags reference

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

Environment variables reference

Variabel	Deskripsi
`OPENCLAW_INSTALL_METHOD=git\|npm`	Metode instalasi
`OPENCLAW_GIT_DIR=<path>`	Direktori checkout
`OPENCLAW_NO_ONBOARD=1`	Lewati orientasi awal
`OPENCLAW_GIT_UPDATE=0`	Nonaktifkan git pull
`OPENCLAW_DRY_RUN=1`	Mode uji coba

Jika -InstallMethod git digunakan dan Git tidak ada, skrip mencoba bootstrap MinGit lokal pengguna sebelum mencetak tautan Git for Windows.

CI dan otomatisasi

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

install.sh (non-interactive npm)
install.sh (non-interactive git)
install-cli.sh (JSON)
install.ps1 (skip 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

Why is Git required?

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

Why does npm hit EACCES on Linux?

Beberapa pengaturan Linux mengarahkan prefiks global npm ke jalur milik root. install.sh dapat mengalihkan prefiks ke ~/.npm-global dan menambahkan ekspor PATH ke file rc shell (ketika file tersebut ada).

Windows: "npm error spawn git / ENOENT"

Jalankan ulang penginstal agar dapat melakukan bootstrap MinGit lokal pengguna, atau instal Git for Windows dan buka ulang PowerShell.

Windows: "openclaw is not recognized"

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

Windows: how to get verbose installer output

install.ps1 saat ini tidak menyediakan switch -Verbose. Gunakan pelacakan PowerShell untuk diagnostik tingkat skrip:

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

openclaw not found after install

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

​Perintah cepat

​install.sh

​Alur (install.sh)

​Deteksi checkout sumber

​Contoh (install.sh)

​install-cli.sh

​Alur (install-cli.sh)

​Contoh (install-cli.sh)

​install.ps1

​Alur (install.ps1)

​Contoh (install.ps1)

​CI dan otomatisasi

​Pemecahan masalah

​Terkait

Perintah cepat

install.sh

Alur (install.sh)

Deteksi checkout sumber

Contoh (install.sh)

install-cli.sh

Alur (install-cli.sh)

Contoh (install-cli.sh)

install.ps1

Alur (install.ps1)

Contoh (install.ps1)

CI dan otomatisasi

Pemecahan masalah

Terkait