Panduan Instalasi

Instal OpenClaw dari nol, sebenarnya gampang banget! Ikuti langkah-langkah di bawah ini satu per satu, kira-kira 5-10 menit sudah selesai. Tenang, kami akan jelaskan setiap langkahnya.

📋 Persyaratan Sistem

Sebelum mulai menginstal, pastikan dulu komputermu memenuhi persyaratan dasar ini:

Node.js 22 atau lebih baru — Ini adalah lingkungan dasar untuk menjalankan OpenClaw (tenang, script instalasi akan membantu mengeceknya)
Sistem Operasi — macOS, Linux, atau Windows (perlu WSL2)
RAM — Minimal 2GB memori tersedia
Disk — Minimal 500MB ruang tersedia
Jaringan — Perlu koneksi internet untuk mengunduh dan memanggil API model AI

ℹ️ Apa itu Node.js? Sederhananya, Node.js itu seperti "penerjemah" yang memungkinkan komputermu menjalankan program yang ditulis dalam JavaScript. OpenClaw ditulis dalam JavaScript, jadi butuh Node.js untuk berjalan. Kamu nggak perlu belajar JavaScript, cukup instal Node.js saja.

ℹ️ Apa itu WSL2? Pengguna Windows perlu tahu: OpenClaw tidak berjalan langsung di Windows, melainkan membutuhkan WSL2 (Windows Subsystem for Linux 2), yang pada dasarnya menginstal sistem Linux mini di dalam Windows. Kalau kamu pakai Windows, script instalasi akan menangani ini secara otomatis.

🌟 Metode 1: Script Instalasi Satu Baris (Direkomendasikan untuk Pemula!)

Ini adalah cara instalasi paling simpel. Cukup copy-paste satu baris perintah di terminal, dan script akan menyelesaikan semuanya secara otomatis. Gampang banget, tinggal ikuti saja!

💡 Apa itu "terminal"? Terminal adalah jendela tempat kamu bisa mengetik perintah teks. Di macOS namanya "Terminal", di Windows namanya "PowerShell" atau "Command Prompt". Kamu bisa mencarinya di komputer dengan mengetik "Terminal".

Buka Terminal

Tekan Command + Spasi, ketik "Terminal", lalu tekan Enter. Sebuah jendela command line hitam (atau putih) akan muncul.

Copy-Paste Perintah Instalasi

Salin perintah di bawah ini, tempel ke jendela terminal, lalu tekan Enter:

curl -fsSL https://openclaw.ai/install.sh | bash

Perintah ini akan melakukan beberapa hal:

Mengecek apakah Node.js sudah terinstal di komputermu, kalau belum akan diinstal otomatis
Mengunduh dan menginstal OpenClaw versi terbaru
Menjalankan wizard konfigurasi awal (onboarding) untuk memandu pengaturan dasar

Tunggu Instalasi Selesai

Proses instalasi memakan waktu sekitar 2-5 menit, tergantung kecepatan internetmu. Kamu akan melihat banyak teks bergulir di terminal, itu normal, jangan khawatir! Setelah selesai, wizard konfigurasi akan terbuka otomatis.

Buka Terminal

Di Linux, kamu bisa menekan Ctrl + Alt + T untuk membuka terminal, atau cari "Terminal" di menu aplikasi.

Copy-Paste Perintah Instalasi

Sama seperti macOS, salin perintah di bawah ini, tempel ke terminal, dan tekan Enter:

curl -fsSL https://openclaw.ai/install.sh | bash

Script akan otomatis mengecek Node.js, mengunduh dan menginstal OpenClaw, serta menjalankan wizard konfigurasi.

Tunggu Instalasi Selesai

Tunggu beberapa menit dengan sabar, kalau sudah muncul wizard konfigurasi berarti instalasi berhasil!

Buka PowerShell (Jalankan sebagai Administrator)

Cari "PowerShell" di Start Menu, klik kanan, pilih "Run as Administrator". Langkah ini penting karena proses instalasi membutuhkan hak akses administrator.

Copy-Paste Perintah Instalasi

Pengguna Windows menggunakan perintah khusus ini:

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

Script ini akan otomatis membantumu:

Mengecek dan mengkonfigurasi WSL2 (jika belum terinstal)
Menginstal Node.js
Mengunduh dan menginstal OpenClaw
Menjalankan wizard konfigurasi awal

Tunggu Instalasi Selesai

Instalasi di Windows mungkin sedikit lebih lambat (karena mungkin perlu menginstal WSL2), sekitar 5-10 menit. Setelah selesai, wizard konfigurasi akan terbuka otomatis.

⚠️ Perhatian untuk Pengguna Windows: Setelah menginstal WSL2, kamu mungkin perlu me-restart komputer. Jika script memintamu restart, silakan restart dulu, lalu jalankan kembali perintah instalasi.

📦 Metode 2: Instal via npm

Jika kamu sudah familiar dengan Node.js dan npm (package manager dari Node.js), kamu bisa menggunakan cara ini. Metode ini memberikanmu kontrol yang lebih besar.

Pastikan Node.js Sudah Terinstal

Buka terminal, ketik perintah berikut untuk mengecek versi Node.js:

node --version

Jika menampilkan v22.x.x atau lebih tinggi, berarti kamu sudah siap. Jika belum terinstal atau versinya terlalu rendah, silakan unduh versi terbaru dari nodejs.org.

Instal OpenClaw Secara Global dengan npm

Jalankan di terminal:

npm install -g openclaw@latest

Penjelasan perintah ini:

npm install — Menggunakan npm untuk menginstal software
-g — Instal secara global, sehingga perintah openclaw bisa digunakan di mana saja
openclaw@latest — Menginstal OpenClaw versi terbaru

Jalankan Konfigurasi Awal dan Daftarkan Layanan Background

Setelah instalasi selesai, jalankan:

openclaw onboard --install-daemon

Perintah ini melakukan dua hal:

onboard — Memulai wizard konfigurasi untuk memandumu menyelesaikan pengaturan awal (memilih model AI, memasukkan API key, dll.)
--install-daemon — Mendaftarkan OpenClaw sebagai layanan background (daemon), sehingga akan otomatis berjalan saat komputer dinyalakan, tanpa perlu dibuka manual setiap kali

💡 Apa itu daemon (proses background)? Sederhananya: sebuah program yang berjalan diam-diam di belakang layar, kamu tidak melihat jendelanya, tapi dia terus bekerja. Dengan menambahkan --install-daemon, OpenClaw akan berjalan tenang di background, siap menunggu pesanmu kapan saja.

🐳 Metode 3: Instal dengan Docker

Jika kamu suka menggunakan Docker (teknologi containerisasi), atau ingin menjalankan OpenClaw di lingkungan yang benar-benar terisolasi, kamu bisa pilih cara ini.

ℹ️ Apa itu Docker? Docker itu seperti "kotak virtual", kamu bisa menjalankan software di dalamnya. Dengan begitu, meskipun software bermasalah, tidak akan mempengaruhi komputermu. Jika kamu tidak tahu apa itu Docker, disarankan menggunakan Metode 1 atau Metode 2.

Pastikan Docker Sudah Terinstal

Jika belum menginstal Docker, kunjungi docker.com untuk mengunduh dan menginstal Docker Desktop.

Jalankan Container Docker OpenClaw

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

Perintah ini akan mengunduh image Docker OpenClaw dan menjalankan container-nya. Parameter -v memetakan file konfigurasi ke komputermu, sehingga data tidak akan hilang.

✅ Verifikasi Setelah Instalasi

Setelah instalasi selesai, mari kita pastikan semuanya berjalan normal. Ikuti langkah-langkah di bawah ini:

Jalankan Health Check

openclaw doctor

Perintah ini seperti melakukan "pemeriksaan kesehatan" untuk OpenClaw. Ia akan mengecek apakah semua komponen yang diperlukan berfungsi normal. Jika semuanya baik-baik saja, kamu akan melihat banyak tanda centang hijau.

Cek Status

openclaw status

Perintah ini memberitahumu apakah OpenClaw sedang berjalan. Jika menampilkan "running", berarti semuanya normal!

Buka Dashboard Web

openclaw dashboard

Perintah ini akan otomatis membuka browser dan mengakses dashboard web OpenClaw. Alamatnya:

http://127.0.0.1:18789/

Di dashboard ini, kamu bisa melihat semua pengaturan dan status OpenClaw, sangat intuitif!

🎉 Jika ketiga perintah di atas tidak menampilkan error, selamat! OpenClaw sudah berhasil terinstal! Selanjutnya, kunjungi bagian Mulai Cepat untuk belajar cara menggunakannya.

🛠️ Masalah Instalasi Umum

Kalau ada masalah, jangan panik! Berikut masalah yang paling sering ditemui saat instalasi beserta solusinya:

Masalah 1: Perintah tidak ditemukan (command not found: openclaw)

Ini biasanya masalah variabel lingkungan PATH. Sederhananya, komputermu tidak tahu di mana letak perintah openclaw.

Solusi:

# Cari di mana openclaw terinstal
which openclaw || npm list -g openclaw

# Jika menggunakan bash, tambahkan path ke file konfigurasi
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Jika menggunakan zsh (default macOS)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Masalah 2: Versi Node.js terlalu rendah

Jika kamu melihat error seperti "Node.js v18 is not supported", berarti kamu perlu meng-upgrade Node.js.

Solusi:

# Gunakan nvm (Node Version Manager) untuk mengelola versi Node.js
# Instal nvm dulu
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Instal Node.js 22
nvm install 22

# Gunakan Node.js 22
nvm use 22

# Verifikasi versi
node --version

Masalah 3: Konflik port (EADDRINUSE)

Jika kamu melihat "EADDRINUSE: address already in use :::18789", artinya port 18789 sudah dipakai oleh program lain.

Solusi:

# Cari proses yang menggunakan port 18789
lsof -i :18789

# Jika itu proses OpenClaw yang lama, hentikan dulu
openclaw stop

# Lalu mulai ulang
openclaw start

Masalah 4: Izin tidak cukup (EACCES)

Masalah izin mungkin muncul saat menginstal secara global dengan npm di Linux/macOS.

Solusi:

# Metode A: Ubah direktori instalasi global npm
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Lalu instal ulang
npm install -g openclaw@latest

⚠️ Jangan pernah gunakan sudo npm install -g! Meskipun menambahkan sudo bisa menyelesaikan masalah izin, hal ini bisa menyebabkan masalah keamanan lainnya. Gunakan metode di atas untuk mengubah direktori instalasi global npm.

Masalah 5: Timeout jaringan

Jika unduhan lambat atau timeout, mungkin ada masalah jaringan.

Solusi:

# Atur npm menggunakan mirror registry (berguna jika koneksi lambat)
npm config set registry https://registry.npmmirror.com

# Lalu instal ulang
npm install -g openclaw@latest