04 · Pasang & setup awal · LAB

Pasang & setup awal OpenClaw

Pasang di komputer latihan. Ikuti setup awal. Pastikan pintu penghubung (Gateway) jalan. Buka layar kontrol di browser. Catat versinya.

Daftar isi

Persiapan
Jalur instalasi
Setup awal
Cek sehat
Lab wajib
Kesalahan umum

Fakta terverifikasi

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 benar-benar selesai, bukan setengah jalan. OS: macOS, Linux, Windows Hub / PowerShell / WSL2. Ikuti halaman Install di docs resmi — jangan tebak dari blog usang.

Persiapan

Komputer latihan (bukan sistem penting) dengan hak admin.
Internet untuk unduh paket dan coba model.
Kredensial model siap dicek (API key / login provider).
Catatan lab notebook siap: tanggal, OS, versi Node.

Analogi: Ini seperti merakit dapur uji, bukan dapur restoran buka 24 jam. Salah di lab = belajar. Salah saat sudah dipakai orang banyak = sakit kepala.

Jalur instalasi

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

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. Ia bantu buat file pengaturan, kunci masuk (auth), dan layanan OS supaya Gateway (resepsionis) tetap jalan di belakang.

Jalankan alur setup awal sesuai docs (perintah teks / installer).
Pilih mode lokal untuk lab.
Pastikan kunci masuk Gateway ada (token/password panjang acak).
Pasang layanan OS bila docs menyarankan — supaya Gateway hidup lagi setelah komputer dinyalakan ulang.
Jangan anggap selesai hanya karena “terasa oke” — verifikasi 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 menghalangi.
gateway status — Apakah pintu penghubung berjalan dan bisa dihubungi?
dashboard — Layar kontrol di browser lokal bisa dipakai chat uji.

Keamanan awal

Di komputer latihan: biarkan hanya komputer ini yang bisa sambung (bind loopback). Jangan buka ke internet dulu. Selesaikan modul 06 sebelum dipakai banyak orang atau dibuka ke jaringan luar.

Lab wajib

Node versi didukung tercatat
openclaw --version tercatat
Onboard selesai (bukan setengah jalan)
doctor tanpa error blocking
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

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

Kunci:

Supaya salah konfigurasi tidak menabrak data/produksi.
openclaw doctor
18789 (http://127.0.0.1:18789/)

Kesalahan umum

PATH belum memuat perintah openclaw setelah install.
Onboard ditinggal sebelum auth/service 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.