Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw mengirimkan tiga skrip penginstal, disajikan dari openclaw.ai.
SkripPlatformFungsinya
install.shmacOS / Linux / WSLMenginstal Node jika diperlukan, menginstal OpenClaw melalui npm (default) atau git, dan dapat menjalankan onboarding.
install-cli.shmacOS / Linux / WSLMenginstal Node + OpenClaw ke prefiks lokal (~/.openclaw) dengan mode npm atau git checkout. Tidak memerlukan root.
install.ps1Windows (PowerShell)Menginstal Node jika diperlukan, menginstal OpenClaw melalui npm (default) atau git, dan dapat menjalankan onboarding.

​
Perintah cepat

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
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)

1

Detect OS

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

Ensure Node.js 24 by default

Memeriksa versi Node dan menginstal Node 24 jika diperlukan (Homebrew di macOS, skrip penyiapan NodeSource di Linux apt/dnf/yum). OpenClaw masih mendukung Node 22 LTS, saat ini 22.16+, untuk kompatibilitas.
3

Ensure Git

Menginstal Git jika belum ada.
4

Install OpenClaw

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

Post-install tasks

  • Menyegarkan layanan Gateway yang dimuat secara 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/config lolos)
  • Mengatur default SHARP_IGNORE_GLOBAL_LIBVIPS=1

​
Deteksi checkout sumber

Jika dijalankan di dalam checkout OpenClaw (package.json + pnpm-workspace.yaml), skrip menawarkan:
  • gunakan checkout (git), atau
  • gunakan instalasi global (npm)
Jika tidak ada TTY yang tersedia dan tidak ada metode instalasi yang ditetapkan, default-nya adalah npm dan menampilkan peringatan. Skrip keluar dengan kode 2 untuk pemilihan metode yang tidak valid atau nilai --install-method yang tidak valid.

​
Contoh (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
FlagDeskripsi
--install-method npm|gitPilih metode instalasi (default: npm). Alias: --method
--npmPintasan untuk metode npm
--gitPintasan untuk metode git. Alias: --github
--version <version|dist-tag|spec>Versi npm, dist-tag, atau spesifikasi paket (default: latest)
--betaGunakan dist-tag beta jika tersedia, jika tidak fallback ke latest
--git-dir <path>Direktori checkout (default: ~/openclaw). Alias: --dir
--no-git-updateLewati git pull untuk checkout yang sudah ada
--no-promptNonaktifkan prompt
--no-onboardLewati onboarding
--onboardAktifkan onboarding
--dry-runCetak tindakan tanpa menerapkan perubahan
--verboseAktifkan output debug (set -x, log npm level notice)
--helpTampilkan penggunaan (-h)
VariabelDeskripsi
OPENCLAW_INSTALL_METHOD=git|npmMetode instalasi
OPENCLAW_VERSION=latest|next|main|<semver>|<spec>Versi npm, dist-tag, atau spesifikasi paket
OPENCLAW_BETA=0|1Gunakan beta jika tersedia
OPENCLAW_GIT_DIR=<path>Direktori checkout
OPENCLAW_GIT_UPDATE=0|1Aktifkan/nonaktifkan pembaruan git
OPENCLAW_NO_PROMPT=1Nonaktifkan prompt
OPENCLAW_NO_ONBOARD=1Lewati onboarding
OPENCLAW_DRY_RUN=1Mode dry run
OPENCLAW_VERBOSE=1Mode debug
OPENCLAW_NPM_LOGLEVEL=error|warn|noticeLevel log npm
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1Kontrol perilaku sharp/libvips (default: 1)

​
install-cli.sh

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

​
Alur (install-cli.sh)

1

Install local Node runtime

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

Ensure Git

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

Install OpenClaw under prefix

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

Refresh loaded gateway service

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)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
FlagDeskripsi
--prefix <path>Prefiks instalasi (default: ~/.openclaw)
--install-method npm|gitPilih metode instalasi (default: npm). Alias: --method
--npmPintasan untuk metode npm
--git, --githubPintasan 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)
--jsonEmit event NDJSON
--onboardJalankan openclaw onboard setelah instalasi
--no-onboardLewati onboarding (default)
--set-npm-prefixDi Linux, paksa prefiks npm ke ~/.npm-global jika prefiks saat ini tidak dapat ditulis
--helpTampilkan penggunaan (-h)
VariabelDeskripsi
OPENCLAW_PREFIX=<path>Prefiks instalasi
OPENCLAW_INSTALL_METHOD=git|npmMetode instalasi
OPENCLAW_VERSION=<ver>Versi OpenClaw atau dist-tag
OPENCLAW_NODE_VERSION=<ver>Versi Node
OPENCLAW_GIT_DIR=<path>Direktori checkout Git untuk instalasi git
OPENCLAW_GIT_UPDATE=0|1Aktifkan/nonaktifkan pembaruan git untuk checkout yang sudah ada
OPENCLAW_NO_ONBOARD=1Lewati orientasi awal
OPENCLAW_NPM_LOGLEVEL=error|warn|noticeLevel log npm
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1Kontrol perilaku sharp/libvips (default: 1)

​
install.ps1

​
Alur (install.ps1)

1

Ensure PowerShell + Windows environment

Memerlukan PowerShell 5+.
2

Ensure Node.js 24 by default

Jika tidak ada, mencoba instalasi melalui winget, lalu Chocolatey, lalu Scoop. Node 22 LTS, saat ini 22.16+, tetap didukung untuk kompatibilitas.
3

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
4

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 restart)
  • Menjalankan openclaw doctor --non-interactive pada upgrade dan instalasi git (upaya terbaik)
5

Handle failures

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

​
Contoh (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex
FlagDeskripsi
-InstallMethod npm|gitMetode instalasi (default: npm)
-Tag <tag|version|spec>dist-tag, versi, atau spesifikasi paket npm (default: latest)
-GitDir <path>Direktori checkout (default: %USERPROFILE%\openclaw)
-NoOnboardLewati orientasi awal
-NoGitUpdateLewati git pull
-DryRunCetak tindakan saja
VariabelDeskripsi
OPENCLAW_INSTALL_METHOD=git|npmMetode instalasi
OPENCLAW_GIT_DIR=<path>Direktori checkout
OPENCLAW_NO_ONBOARD=1Lewati orientasi awal
OPENCLAW_GIT_UPDATE=0Nonaktifkan git pull
OPENCLAW_DRY_RUN=1Mode dry run
Jika -InstallMethod git digunakan dan Git tidak ada, skrip keluar dan mencetak tautan Git for Windows.

​
CI dan otomatisasi

Gunakan flag/variabel lingkungan non-interaktif untuk eksekusi yang dapat diprediksi. 
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

​
Pemecahan masalah

Git diperlukan untuk metode instalasi git. Untuk instalasi npm, Git tetap diperiksa/diinstal untuk menghindari kegagalan spawn git ENOENT saat dependensi menggunakan URL git.
Beberapa setup Linux mengarahkan prefiks global npm ke path milik root. install.sh dapat mengalihkan prefiks ke ~/.npm-global dan menambahkan ekspor PATH ke file rc shell (jika file tersebut ada).
Skrip menggunakan default SHARP_IGNORE_GLOBAL_LIBVIPS=1 untuk menghindari sharp dibuild terhadap libvips sistem. Untuk menimpanya:
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
Instal Git for Windows, buka ulang PowerShell, jalankan ulang penginstal.
Jalankan npm config get prefix dan tambahkan direktori tersebut ke PATH pengguna Anda (tidak perlu sufiks \bin di Windows), lalu buka ulang PowerShell.
install.ps1 saat ini tidak mengekspos switch -Verbose. Gunakan tracing PowerShell untuk diagnostik tingkat skrip:
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
Biasanya ini masalah PATH. Lihat pemecahan masalah Node.js.

​
Terkait