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

Install overview

Internal penginstal

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

Skrip Platform Fungsinya
install.sh macOS / Linux / WSL Menginstal Node jika diperlukan, menginstal OpenClaw melalui npm (bawaan) atau git, dan dapat menjalankan orientasi awal.
install-cli.sh macOS / Linux / WSL Menginstal Node + OpenClaw ke prefiks lokal (~/.openclaw) melalui npm atau git. Tidak memerlukan root.
install.ps1 Windows (PowerShell) Menginstal Node jika diperlukan, menginstal OpenClaw melalui npm (bawaan) atau git, dan dapat menjalankan orientasi awal.

Ketiganya mendukung Node 22.19+, 23.11+, atau 24+; Node 24 adalah target bawaan untuk instalasi baru.

Perintah cepat

install.sh

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

install-cli.sh

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

install.ps1

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

install.sh

Alur (install.sh)

  • Deteksi sistem operasi

    Mendukung macOS dan Linux (termasuk WSL).

  • Pastikan Node.js 24 tersedia secara bawaan

    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 jika penginstal memerlukannya untuk Node atau Git. Node 22.19+ dan 23.11+ tetap didukung untuk kompatibilitas. Di Alpine/Linux musl, penginstal menggunakan paket apk sebagai pengganti NodeSource; repositori Alpine yang dikonfigurasi harus menyediakan versi Node yang didukung (Alpine 3.21 atau lebih baru pada saat penulisan).

  • Pastikan Git tersedia

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

  • Instal OpenClaw

    • Metode npm (bawaan): instalasi npm global
    • Metode git: mengkloning/memperbarui repositori, menginstal dependensi dengan pnpm, membangun, lalu menginstal pembungkus di ~/.local/bin/openclaw

  • Tugas pascainstalasi

    • Menentukan biner openclaw yang baru saja diinstal untuk perintah lanjutan
    • Untuk instalasi yang belum dikonfigurasi, memulai orientasi awal sebelum pemeriksaan doctor atau Gateway. Dengan --no-onboard atau tanpa TTY, skrip mencetak perintah untuk menyelesaikan penyiapan nanti.
    • Untuk instalasi yang sudah dikonfigurasi, menyegarkan dan memulai ulang layanan Gateway yang dimuat sebisa mungkin, lalu menjalankan doctor. Pemutakhiran memperbarui Plugin jika memungkinkan, atau mencetak perintah manual dalam proses tanpa antarmuka yang mengaktifkan perintah interaktif.
    • Saat --verify dijalankan, skrip memeriksa versi yang terinstal dan memeriksa kesehatan Gateway hanya setelah konfigurasi tersedia.

    • Deteksi checkout sumber

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

    • menggunakan checkout (git), atau
    • menggunakan instalasi global (npm)

    Jika TTY tidak tersedia dan metode instalasi tidak ditetapkan, metode bawaan adalah npm dan skrip menampilkan peringatan.

    Skrip keluar dengan kode 2 untuk pemilihan metode yang tidak valid atau nilai --install-method yang tidak valid.

    Contoh (install.sh)

    Bawaan

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

    Lewati orientasi awal

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

    Instalasi Git

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

    Checkout main GitHub

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

    Simulasi

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

    Verifikasi setelah instalasi

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verify
    Referensi flag
    Flag Deskripsi
    --install-method | --method npm|git Pilih metode instalasi (bawaan: npm)
    --npm Pintasan untuk metode npm
    --git | --github Pintasan untuk metode git
    --version <version|dist-tag|spec> Versi npm, dist-tag, atau spesifikasi paket (bawaan: latest)
    --beta Gunakan dist-tag beta jika tersedia; jika tidak, kembali ke latest
    --git-dir | --dir <path> Direktori checkout (bawaan: ~/openclaw)
    --no-git-update Lewati git pull untuk checkout yang sudah ada
    --no-prompt Nonaktifkan perintah interaktif
    --no-onboard Lewati orientasi awal
    --onboard Aktifkan orientasi awal
    --verify Jalankan verifikasi cepat pascainstalasi (--version, kesehatan Gateway jika dimuat)
    --dry-run Cetak tindakan tanpa menerapkan perubahan
    --verbose Aktifkan keluaran debug (set -x, log npm tingkat notice)
    --help | -h Tampilkan petunjuk penggunaan
    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 status OpenClaw serta jalur git/orientasi awal bawaan
    OPENCLAW_GIT_DIR=<path> Direktori checkout
    OPENCLAW_GIT_UPDATE=0|1 Aktifkan atau nonaktifkan pemutakhiran git
    OPENCLAW_NO_PROMPT=1 Nonaktifkan perintah interaktif
    OPENCLAW_VERIFY_INSTALL=1 Jalankan verifikasi cepat pascainstalasi
    OPENCLAW_NO_ONBOARD=1 Lewati orientasi awal
    OPENCLAW_DRY_RUN=1 Mode simulasi
    OPENCLAW_VERBOSE=1 Mode debug
    OPENCLAW_NPM_LOGLEVEL=error|warn|notice Tingkat log npm (bawaan: error, menyembunyikan gangguan pesan deprekasi npm)

    install-cli.sh

    Alur (install-cli.sh)

  • Instal runtime Node lokal

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

  • Pastikan Git tersedia

    Jika Git belum tersedia, skrip mencoba menginstalnya melalui apt/dnf/yum/apk di Linux atau Homebrew di macOS.

  • Instal OpenClaw di bawah prefiks

    • Metode npm (bawaan): menginstal di bawah prefiks dengan npm, lalu menulis pembungkus ke <prefix>/bin/openclaw
    • Metode git: mengkloning/memperbarui checkout (bawaan ~/openclaw) dan tetap menulis pembungkus ke <prefix>/bin/openclaw

  • Segarkan 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 sebisa mungkin.

    • Contoh (install-cli.sh)

    Bawaan

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

    Prefiks + versi khusus

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

    Instalasi Git

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

    Keluaran JSON otomatisasi

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

    Jalankan orientasi awal

    bash
    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard
    Referensi flag
    Flag Deskripsi
    --prefix <path> Prefiks instalasi (bawaan: ~/.openclaw)
    --install-method | --method npm|git Pilih metode instalasi (bawaan: npm)
    --npm Pintasan untuk metode npm
    --git | --github Pintasan untuk metode git
    --git-dir | --dir <path> Direktori checkout Git (bawaan: ~/openclaw)
    --version <ver> Versi atau dist-tag OpenClaw (bawaan: latest)
    --node-version <ver> Versi Node (bawaan: 22.22.2)
    --json Keluarkan peristiwa NDJSON
    --onboard Jalankan openclaw onboard setelah instalasi
    --no-onboard Lewati orientasi awal (bawaan)
    --set-npm-prefix Di Linux, paksa prefiks npm menjadi ~/.npm-global jika prefiks saat ini tidak dapat ditulisi
    --help | -h Tampilkan cara penggunaan
    Referensi variabel lingkungan
    Variabel Deskripsi
    OPENCLAW_PREFIX=<path> Prefiks instalasi
    OPENCLAW_INSTALL_METHOD=git|npm Metode instalasi
    OPENCLAW_VERSION=<ver> Versi atau dist-tag OpenClaw
    OPENCLAW_NODE_VERSION=<ver> Versi Node
    OPENCLAW_HOME=<path> Direktori dasar untuk status OpenClaw serta jalur git/orientasi awal bawaan
    OPENCLAW_GIT_DIR=<path> Direktori checkout Git untuk instalasi git
    OPENCLAW_GIT_UPDATE=0|1 Aktifkan atau nonaktifkan pembaruan git untuk checkout yang sudah ada
    OPENCLAW_NO_ONBOARD=1 Lewati orientasi awal
    OPENCLAW_NPM_LOGLEVEL=error|warn|notice Tingkat log npm (bawaan: error)

    install.ps1

    Alur (install.ps1)

  • Pastikan lingkungan PowerShell + Windows tersedia

    Memerlukan PowerShell 5+.

  • Pastikan Node.js 24 tersedia secara bawaan

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

  • Instal OpenClaw

    • Metode npm (bawaan): instalasi npm global menggunakan -Tag yang dipilih, dijalankan dari direktori sementara penginstal yang dapat ditulisi agar shell yang dibuka di folder terlindungi seperti C:\ tetap berfungsi
    • Metode git: klon/perbarui repositori, instal/bangun dengan pnpm, dan instal pembungkus di %USERPROFILE%\.local\bin\openclaw.cmd. Jika Git tidak tersedia, skrip menyiapkan MinGit lokal pengguna di %LOCALAPPDATA%\OpenClaw\deps\portable-git dan menambahkannya ke PATH proses saat ini dan pengguna.

  • Tugas pascainstalasi

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

  • Tangani kegagalan

    Instalasi iwr ... | iex dan scriptblock melaporkan galat yang menghentikan proses tanpa menutup sesi PowerShell saat ini. Instalasi langsung powershell -File / pwsh -File tetap keluar dengan kode bukan nol untuk otomatisasi.

    • Contoh (install.ps1)

    Bawaan

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

    Instalasi Git

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

    Checkout main GitHub

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

    Direktori git khusus

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

    Simulasi

    powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun
    Referensi flag
    Flag Deskripsi
    -InstallMethod npm|git Metode instalasi (bawaan: npm)
    -Tag <tag|version|spec> Dist-tag, versi, atau spesifikasi paket npm (bawaan: latest)
    -GitDir <path> Direktori checkout (bawaan: %USERPROFILE%\openclaw)
    -NoOnboard Lewati orientasi awal
    -NoGitUpdate Lewati git pull
    -DryRun Hanya cetak tindakan
    Referensi variabel lingkungan
    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 simulasi

    CI dan otomatisasi

    Gunakan flag/variabel lingkungan noninteraktif agar eksekusi dapat diprediksi.

    install.sh (npm noninteraktif)

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

    install.sh (git noninteraktif)

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

    install-cli.sh (JSON)

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

    install.ps1 (lewati orientasi awal)

    powershell
    & ([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 guna menghindari kegagalan spawn git ENOENT ketika dependensi menggunakan URL git.

    Mengapa npm mengalami EACCES di Linux?

    Beberapa konfigurasi Linux mengarahkan prefiks global npm ke jalur yang dimiliki root. install.sh dapat mengubah prefiks menjadi ~/.npm-global dan menambahkan ekspor PATH ke berkas rc shell (jika berkas tersebut tersedia).

    Windows: "npm error spawn git / ENOENT"

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

    Windows: "openclaw is not recognized"

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

    Windows: cara mendapatkan keluaran penginstal terperinci

    install.ps1 tidak menyediakan opsi -Verbose. Gunakan pelacakan PowerShell untuk diagnostik tingkat skrip:

    powershell
    Set-PSDebug -Trace 1& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardSet-PSDebug -Trace 0
    openclaw tidak ditemukan setelah instalasi

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

    Terkait

    Was this useful?
    On this page

    On this page