Langsung ke konten utama

​
Instal

Sudah mengikuti Panduan Memulai? Anda sudah siap — halaman ini ditujukan untuk metode instalasi alternatif, instruksi spesifik platform, dan pemeliharaan.

​
Persyaratan sistem

  • Node 22+ (skrip instalasi akan menginstalnya jika belum ada)
  • macOS, Linux, atau Windows
  • pnpm hanya diperlukan jika Anda membangun dari sumber (source)
Di Windows, kami sangat merekomendasikan menjalankan OpenClaw di bawah WSL2.

​
Metode instalasi

Skrip instalasi adalah cara yang direkomendasikan untuk menginstal OpenClaw. Skrip ini menangani deteksi Node, instalasi, dan onboarding dalam satu langkah.
Untuk host VPS/cloud, hindari penggunaan citra (image) marketplace “1-click” pihak ketiga jika memungkinkan. Lebih baik gunakan citra OS dasar yang bersih (misalnya Ubuntu LTS), lalu instal OpenClaw sendiri menggunakan skrip instalasi.

Skrip instalasi

Mengunduh CLI, menginstalnya secara global via npm, dan meluncurkan wizard onboarding.
curl -fsSL https://openclaw.ai/install.sh | bash
Selesai — skrip menangani deteksi Node, instalasi, dan onboarding.Untuk melewati onboarding dan hanya menginstal binernya saja:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Untuk semua bendera (flag), variabel lingkungan (env var), dan opsi CI/otomatisasi, lihat Detail teknis installer.
Jika Anda sudah memiliki Node 22+ dan lebih suka mengelola instalasi sendiri:
npm install -g openclaw@latest
openclaw onboard --install-daemon
Jika Anda memiliki libvips yang terinstal secara global (umum di macOS via Homebrew) dan sharp gagal, paksa penggunaan biner prebuilt:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Jika Anda melihat pesan sharp: Please add node-gyp to your dependencies, instal build tooling (macOS: Xcode CLT + npm install -g node-gyp) atau gunakan variabel lingkungan di atas.
Untuk kontributor atau siapa pun yang ingin menjalankan dari checkout lokal.
1

Clone dan bangun (build)

Clone repositori OpenClaw dan bangun:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

Hubungkan (link) CLI

Buat perintah openclaw tersedia secara global:
pnpm link --global
Atau, lewati langkah link dan jalankan perintah via pnpm openclaw ... dari dalam repositori.
3

Jalankan onboarding

openclaw onboard --install-daemon
Untuk alur kerja pengembangan yang lebih mendalam, lihat Setup.

​
Metode instalasi lainnya

Docker

Deployment dalam kontainer atau headless.

Podman

Kontainer rootless: jalankan setup-podman.sh sekali, lalu skrip peluncuran.

Nix

Instalasi deklaratif melalui Nix.

Ansible

Provisioning armada otomatis.

Bun

Penggunaan khusus CLI melalui runtime Bun.

​
Setelah instalasi

Pastikan semuanya berfungsi: 
openclaw doctor         # periksa masalah konfigurasi
openclaw status         # status gateway
openclaw dashboard      # buka UI browser
Jika Anda memerlukan jalur runtime kustom, gunakan:
  • OPENCLAW_HOME untuk jalur internal berbasis direktori home
  • OPENCLAW_STATE_DIR untuk lokasi state yang dapat berubah
  • OPENCLAW_CONFIG_PATH untuk lokasi file konfigurasi
Lihat Variabel Lingkungan untuk aturan prioritas dan detail lengkap.

​
Pemecahan Masalah: openclaw tidak ditemukan

Diagnosis cepat:
node -v
npm -v
npm prefix -g
echo "$PATH"
Jika $(npm prefix -g)/bin (macOS/Linux) atau $(npm prefix -g) (Windows) tidak ada dalam $PATH Anda, shell Anda tidak dapat menemukan biner npm global (termasuk openclaw).Perbaikan — tambahkan jalur tersebut ke file startup shell Anda (~/.zshrc atau ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
Di Windows, tambahkan output dari npm prefix -g ke PATH Anda.Kemudian buka terminal baru (atau jalankan rehash di zsh / hash -r di bash).

​
Perbarui / Hapus Instalasi

Memperbarui

Jaga OpenClaw tetap mutakhir.

Migrasi

Pindah ke mesin baru.

Hapus Instalasi

Hapus OpenClaw sepenuhnya.