Skip to main content

​
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.
Selesai — skrip menangani deteksi Node, instalasi, dan onboarding.Untuk melewati onboarding dan hanya menginstal binernya saja:
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:
Jika Anda memiliki libvips yang terinstal secara global (umum di macOS via Homebrew) dan sharp gagal, paksa penggunaan biner prebuilt:
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:
2

Hubungkan (link) CLI

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

Jalankan onboarding

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