04 · Pasang & setup awal · LAB

Pasang & setup awal OpenClaw

Sekarang pasang di komputer latihan. Ikuti setup awal, pastiin Gateway (resepsionis) hidup, buka layar kontrol di browser, terus catat versinya. Intinya: lab dulu, bukan produksi.

Daftar isi

Persiapan
Jalur instalasi
Setup awal
Cek sehat
Lab wajib
Kesalahan umum

Yang sudah dicek

Butuh Node.js versi: 22.22.3+, 24.15+, atau 25.9+ (Node 26 disarankan). Login model lewat perintah teks atau kunci API. Setup awal harus kelar beneran — jangan setengah-setengah. OS: macOS, Linux, Windows Hub / PowerShell / WSL2. Ikuti halaman Install di docs resmi. Jangan nebak dari blog usang.

Persiapan

Komputer latihan (bukan sistem penting) — punya hak admin.
Internet buat unduh paket dan coba model.
Kredensial model siap dicek (API key / login provider).
Lab notebook siap: tanggal, OS, versi Node.

Analogi: Ini kayak merakit dapur uji, bukan dapur restoran buka 24 jam. Salah di lab = belajar. Salah pas udah dipakai orang banyak = sakit kepala.

Jalur instalasi

Rujuk docs.openclaw.ai halaman Install. Biasanya ada beberapa jalur:

Installer OS / skrip resmi
Pemasangan lewat manajer paket Node
Prefix lokal / build dari sumber
Kontainer
Aplikasi companion desktop (bila ada di docs)

Tip

Mulai dari “Getting Started” resmi. Setelah install, catat output openclaw --version dan node -v.

Setup awal

Onboard = panduan setup awal. Dia bantu buat file pengaturan, kunci masuk, dan layanan OS supaya Gateway (resepsionis) tetap jalan di belakang.

Jalankan alur setup awal sesuai docs (perintah teks / installer).
Pilih mode lokal buat lab.
Pastikan kunci masuk Gateway ada (token/password panjang acak).
Pasang layanan OS kalau docs nyaranin — biar Gateway hidup lagi setelah komputer dinyalain ulang.
Jangan anggap selesai cuma karena “terasa oke” — cek di langkah berikutnya.

Cek sehat

openclaw --version
node -v
openclaw doctor
openclaw gateway status
openclaw status
openclaw dashboard

doctor — cek pengaturan dan layanan; perbaiki yang ngalangin.
gateway status — pintu penghubung jalan dan bisa dihubungi?
dashboard — layar kontrol di browser lokal buat chat uji.

Keamanan awal

Di komputer latihan: biarin cuma komputer ini yang bisa sambung (bind loopback = cuma dari mesin sendiri). Jangan buka ke internet dulu. Kerjain modul 06 dulu sebelum dipakai banyak orang atau dibuka ke luar.

Lab wajib

Node versi didukung tercatat
openclaw --version tercatat
Setup awal kelar (bukan setengah-setengah)
doctor tanpa error yang nahan jalan
Status Gateway: jalan + probe ok
Layar kontrol lokal bisa kirim/terima chat uji
Folder ~/.openclaw tidak di-commit ke git publik
Backup singkat catatan (lokasi data, keputusan kunci masuk) — rahasia disensor

Kuis singkat (klik buat buka)

Mengapa pakai mesin lab dulu?
Perintah untuk cek config/service?
Port layar kontrol lokal yang sering dipakai?

Kunci:

Supaya salah setting nggak nabrak data/produksi.
openclaw doctor
18789 (http://127.0.0.1:18789/)

Kesalahan umum

PATH belum memuat perintah openclaw setelah install.
Setup awal ditinggal sebelum kunci masuk / layanan siap.
Menyimpan token ke repo publik (sangat berbahaya).
Langsung buka port ke luar tanpa kunci masuk + tanpa modul keamanan.

Kalau macet: lihat Troubleshooting dan docs resmi — jangan tebak.