Tutorial: Install OpenClaw Gateway dari Nol dalam 10 Menit

15 menit baca - Beginner friendly

Gue bakal tunjukin cara install OpenClaw Gateway dari nol. Literally 10 menit dari nol sampe lo bisa chat sama AI assistant dari HP lo lewat Telegram.

Ini tutorial paling dasar yang lo butuhkan sebelum ngapain aja. Kalo lo mau automate semuanya dengan OpenClaw, Gateway ini harus jalan dulu.

Lo bakal punya:

• OpenClaw Gateway yang jalan di mesin lo atau VPS
• Dashboard web buat chat sama AI
• Optional: Koneksi Telegram biar lo bisa chat dari mana aja
• Fondasi yang solid buat adds channel dan integrations lain

Ayo langsung aja.

Prerequisites: Apa yang Lo Butuhin

Official docs bilang lo butuh:

• Node.js version 24 (recommended) atau minimal version 22.14
• API key dari model provider kayak Anthropic, OpenAI, atau Google

Itu aja. Installer bakal handle sisanya.

Cek dulu Node version lo:

node --version

Kalo angka yang keluar di bawah 22.14, lo perlu update Node dulu.

For Windows users: WSL2 strongly recommended daripada native Windows. Lebih stable dan lebih cocok sama tooling yang ada. Official docs sendiri nyebutin ini.

Step 1: Install OpenClaw (30 Detik)

Cara paling cepet pake official installer script. Dia detect OS lo, install Node kalo belum ada, setup OpenClaw, terus launch onboarding wizard secara otomatis.

macOS, Linux, atau WSL2

Copas ini ke terminal:

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

Windows (PowerShell)

Buka PowerShell as administrator terus jalanin:

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

Installer bakal cek Node, install kalo belum ada, terus install OpenClaw. Tergantung internet speed dan apakah Node perlu diinstall, ini makan waktu 1 sampai 5 menit.

Kalo lo mau install tanpa langsung jalanin onboarding (mungkin mau prepare dulu), pake:

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

Step 2: Jalanin Onboarding Wizard

Sesudah install selesai, wizard bakal launch otomatis. Kalo lo skip pake --no-onboard, start manual:

openclaw onboard --install-daemon

Wizard bakal nanya beberapa hal:

1. Pilih model provider - Anthropic, OpenAI, Google, dan lain-lain
2. Masukin API key - paste key dari provider lo
3. Gateway configuration - mostly defaults work fine

Butuh sekitar 2 menit buat selesai semua.

Quick breakdown provider yang tersedia:

Kalo lo belum punya API key, wizard bakal jelasin dimana harus bikin. Biasanya 5 menit dan lo dapet free credits buat mulai.

Step 3: Cek Gateway Lagi

Sesudah onboarding selesai, cek apakah semuanya jalan dengan benar:

openclaw gateway status

Lo harusnya lihat Gateway listening di port 18789. Kalo bilang ada yang salah, wizard biasanya bilangin apa yang harus dibenerin.

Kalo status command gak nemu apa-apa, coba:

openclaw health

Ini jalanin check yang lebih lengkap dan bilangin exactly apa yang missing atau salah config.

Step 4: Buka Dashboard

Dashboard (biasa disebut Control UI) adalah interface web tempat lo chat sama AI assistant dan manage settings.

Buka dengan:

openclaw dashboard

Ini buka browser default lo ke dashboard. Kalo dia load dan lo bisa ngetik pesan terus dapet reply dari AI, basic setup lo udah selesai.

Step 5: Konekin Telegram (Optional tapi Worth It)

Ini cara paling cepet buat bikin AI assistant lo accessible dari HP lo. Telegram bot itu gratis, dan setup-nya cuma 5 menit.

Bikin Telegram Bot

1. Buka Telegram cari @BotFather
2. Kirim pesan /newbot
3. BotFather nanya nama - kasih nama apapun yang lo suka
4. BotFather nanya username - harus ending di bot (contoh: asistenku_bot)
5. BotFather kasih bot token yang keliatan kayak 123456789:ABCdefGhIJKlmNoPQRsTUVwxYZ

Simpen token itu. Lo bakal paste di step berikutnya.

Konekin Bot ke OpenClaw

Kembali ke terminal, jalanin:

openclaw channels login

Ini bakal guided lo lewat proses linking Telegram bot. Kalo ditanya bot token, paste yang tadi lo dapat dari BotFather.

Sesudah linked, lo harusnya bisa buka Telegram, cari bot lo pake username-nya, terus kirim pesan. AI assistant lo harusnya reply.

Sekarang lo bisa message AI assistant lo dari mana aja, bahkan kalo komputer lo sleep. Gateway tetep jalan di background.

Alternative Install Methods

Installer script adalah cara yang recommended, tapi ada cara lain kalo lo prefer.

Pakai npm (Kalo Lo Udah Kelola Node Sendiri)

Kalo lo udah punya Node 22+ dan lebih suka npm:

npm install -g openclaw@latest
openclaw onboard --install-daemon

Pakai pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

Note: pnpm butuh approval explicit buat packages dengan build scripts. Step approve-builds handle itu.

Pakai bun

bun add -g openclaw@latest
openclaw onboard --install-daemon

Bun supported untuk global CLI install path. Untuk Gateway runtime-nya sendiri, Node tetep recommended.

Troubleshooting: Sharp Build Errors

Kalo sharp (image processing library) gagal waktu npm install karena conflict sama global libvips:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Dari Source (Untuk Developer)

Kalo lo mau jalanin development version atau contribute:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon

Atau skip linking dan jalanin langsung dari repo pake pnpm openclaw ....

Where Things Live di Machine Lo

Sekali terinstall, OpenClaw simpen files-nya di lokasi yang predictable. Tau ini membantu kalo lo perlu debug atau backup.

Official docs recommend simpen kustomisasi lo di ~/.openclaw/workspace dan ~/.openclaw/openclaw.json biar pas update, perubahan lo gak ke-overwrite.

Install di VPS (Server Tanpa Layar)

Sampai sini kita udah install di local machine. Tapi lo probably mau ini jalan 24/7 di VPS biar bisa diakses kapan aja.

Setup-nya mostly sama. SSH ke VPS terus jalanin installer:

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

Terus jalanin onboarding:

openclaw onboard --install-daemon

Waktu ditanya interface mana yang bind, pilih all interfaces atau 0.0.0.0 bukan default localhost. Ini bikin lo bisa akses dashboard dari luar server.

Sesudah setup, start gateway:

openclaw gateway start

Cek status:

openclaw gateway status

Lo bakal mau set up nginx sebagai reverse proxy dengan SSL (pakai Let's Encrypt) biar bisa akses dashboard lewat HTTPS. Juga mau config firewall biar cuma allow traffic di port 80, 443, dan SSH port lo.

Kalo lo mau security hardening yang lengkap, cek tutorial companion kita: OpenClaw Security Hardening Checklist.

Biar Gateway Jalan Terus di Background

Di VPS atau Mac, lo mau gateway tetep jalan bahkan setelah lo close terminal. Flag --install-daemon waktu onboarding setup service background.

Di Linux dengan systemd:

openclaw gateway start
openclaw gateway stop
openclaw gateway restart

Di macOS, installer setup launch agent.

Kalo di VPS tanpa systemd, pake pm2 biar tetep alive:

npm install -g pm2
pm2 start "openclaw gateway" --name openclaw
pm2 save
pm2 startup

Ini bikin gateway restart otomatis kalo server reboot.

Update OpenClaw

OpenClaw release update regularly. Buat update ke versi terbaru:

npm install -g openclaw@latest

Terus restart gateway:

openclaw gateway restart

Config dan workspace files lo tetep aman. Yang ke-update cuma core application-nya.

Common First-Time Issues

Ini masalah yang paling sering orang alami dan cara fix-nya.

Gateway Gak Mau Start

openclaw gateway status

Kalo gak nunjukin apa-apa, coba start manual:

openclaw gateway start

Cek logs buat errors:

tail -f /tmp/openclaw/gateway.log

Onboarding Hang atau Freeze

Press Ctrl+C buat cancel, terus jalanin:

openclaw onboard --install-daemon

Telegram Bot Gak Respond

1. Pastiin lo udah start bot dengan /start di Telegram
2. Cek bot token bener di config
3. Jalanin openclaw channels login lagi buat re-link

Dashboard Gak Mau Load

Pastiin gateway beneran jalan:

openclaw health

Kalo health check pass tapi dashboard tetep gak load, clear browser cache terus coba lagi.

Checklist Setup

Langkah Selanjutnya

Sekali basic setup work, ini natural next steps:

• Tambah WhatsApp - Konekin nomor WhatsApp lo biar bisa chat dari sana juga
• Tulis custom skills - Automate tugas repetitif dengan skill scripts lo sendiri
• Konek Google Workspace - Akses Gmail, Calendar, Drive lewat AI lo
• Security hardening - Kunci gateway sebelum expose ke internet

Butuh VPS buat Jalanin OpenClaw 24/7?

Kita recommend SumoPod:

Dapat SumoPod VPS - Cepat, affordable, perfect buat jalanin OpenClaw sepanjang waktu dengan security yang proper.

Versi English yang lebih teknis tersedia di GitHub:

Read English Version on GitHub - Full technical guide with more detail on alternative install methods and troubleshooting.

Referensi

• Official OpenClaw Installation Docs
• Official Getting Started Guide
• Gateway Setup Reference
• OpenClaw GitHub Repository
• Channel Integration Docs

Related Tutorials

• OpenClaw Security Hardening Checklist - Kunci gateway lo setelah setup
• OpenClaw Session Maintenance Guide - Jaga gateway lo tetep jalan smooth
• WhatsApp Customer Care Bot untuk UMKM - Tambah WhatsApp ke setup lo
• WordPress Security Scanner Skill - Scan WordPress sites lo otomatis

Tutorial ini diverifikasi terhadap official OpenClaw documentation di docs.openclaw.ai. Semua commands dan steps dikonfirmasi dari official source.

Tutorial ini bagian dari project OpenClaw Sumopod - membuat automation accessible untuk UMKM Indonesia.

Last Updated: April 2026 Version: 1.0 Author: Radian IT Team