Internal penginstal

Deteksi OS

Mendukung macOS dan Linux (termasuk WSL).

Pastikan 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 ketika penginstal memerlukannya untuk Node atau Git. Node 22.22.3+, Node 24.15+, dan Node 25.9+ didukung; Node 23 tidak didukung. Di Alpine/musl Linux, penginstal menggunakan paket apk sebagai pengganti NodeSource dan memverifikasi versi SQLite yang benar-benar ditautkan. Aliran paket Alpine stabil saat ini dapat menyediakan Node yang cukup baru dengan SQLite sistem yang rentan; jika hal itu terjadi, gunakan kontainer resmi node:24-alpine atau host berbasis glibc sebagai gantinya.

Pastikan Git

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

Instal OpenClaw

• Metode npm (default): 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 telah 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 dengan prompt yang diaktifkan.
• Saat --verify dijalankan, skrip memeriksa versi yang terinstal dan hanya memeriksa kesehatan Gateway setelah konfigurasi tersedia.

Instal runtime Node lokal

Mengunduh tarball Node LTS didukung yang versinya dipatok (versi disematkan dalam skrip dan diperbarui secara independen, default 24.15.0) ke <prefix>/tools/node-v<version> dan memverifikasi SHA-256. Linux ARMv7 menggunakan Node 22.22.3 karena biner ARMv7 resmi Node 24+ tidak tersedia. Di Alpine/musl Linux, tempat Node tidak menerbitkan tarball kompatibel untuk runtime yang dipatok, menginstal nodejs dan npm dengan apk, lalu memverifikasi Node dan pustaka SQLite yang benar-benar ditautkan. Aliran paket Alpine stabil saat ini mungkin masih menautkan SQLite yang rentan meskipun menggunakan Node yang cukup baru; gunakan kontainer resmi node:24-alpine atau host berbasis glibc jika pemeriksaan keamanan menolak paket tersebut.

Pastikan Git

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

Instal OpenClaw di bawah prefiks

• Metode npm (default): menginstal di bawah prefiks dengan npm, lalu menulis pembungkus ke <prefix>/bin/openclaw
• Metode git: mengkloning/memperbarui checkout (default ~/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, yang mengaktifkan layanan pengganti, lalu memeriksa kesehatan Gateway sebisa mungkin.

Pastikan lingkungan PowerShell + Windows tersedia

Memerlukan PowerShell 5+.

Pastikan Node.js 24 secara default

Jika tidak tersedia, skrip mencoba menginstalnya melalui winget, lalu Chocolatey, kemudian 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 serta PATH pengguna. Node 22.22.3+, Node 24.15+, dan Node 25.9+ didukung; Node 23 tidak didukung.

Instal OpenClaw

• Metode npm (default): instalasi npm global menggunakan -Tag yang dipilih, dijalankan dari direktori sementara penginstal yang dapat ditulis agar shell yang dibuka di folder terlindungi seperti C:\ tetap berfungsi
• Metode git: klon/perbarui repositori, instal/bangun dengan pnpm, dan instal wrapper 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 serta PATH pengguna.

Tugas pascainstalasi

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

Tangani kegagalan

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