Cara Install OpenClaw di VPS Linux
untuk Production: Panduan Lengkap dari Nol

🦞 Apa itu OpenClaw?

OpenClaw adalah personal AI assistant open-source yang bisa kamu jalankan di servermu sendiri. Dengan lebih dari 216.000 bintang di GitHub dan 40.000+ fork, OpenClaw adalah salah satu proyek AI assistant paling populer di dunia saat ini (per Februari 2026).

OpenClaw bukan sekadar chatbot biasa. Ini adalah infrastruktur AI personal yang menghubungkan kamu dengan berbagai channel komunikasi modern: WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage via BlueBubbles, Microsoft Teams, Matrix, dan bahkan Zalo. Semua bisa dijawab oleh satu AI assistant yang kamu kontrol penuh.

Dibangun di atas TypeScript dengan runtime Node.js, OpenClaw menggunakan arsitektur Gateway sebagai control plane pusat. Gateway inilah yang menjadi "otak" dari seluruh sistem: mengelola sesi, channel, tools, dan event. Kamu bisa mengontrol AI assistant-mu dari mana saja melalui WebSocket atau bahkan dari aplikasi macOS/iOS/Android.

Panduan ini akan membawa kamu dari kondisi VPS baru sampai OpenClaw berjalan production-ready, lengkap dengan daemon systemd agar tidak mati saat server restart.

🖥️ Kenapa Harus di VPS Linux?

OpenClaw memang bisa dijalankan di laptop atau komputer lokal. Tapi untuk production — artinya AI assistant yang berjalan terus 24/7 dan bisa diandalkan — kamu butuh VPS Linux. Ada beberapa alasan kuat:

Untuk target audience Indonesia, latency terhadap pengguna lokal sangat penting. Oleh karena itu, VPS Indonesia adalah pilihan terbaik. Response time yang cepat membuat pengalaman chat dengan AI assistant terasa lebih natural dan responsif.

OpenClaw dengan runtime Node.js membutuhkan minimal 1 GB RAM untuk berjalan, dengan rekomendasi 2 GB RAM untuk production yang stabil. Spesifikasi ini sangat terjangkau di VPS modern.

🛠️ Persiapan Server VPS

Sebelum install OpenClaw, pastikan VPS Linux kamu sudah siap. Panduan ini menggunakan Ubuntu 22.04 LTS sebagai sistem operasi, meskipun langkah-langkahnya juga berlaku untuk Debian, CentOS, dan distro Linux modern lainnya.

Spesifikasi Minimum VPS

Update Sistem & Install Dependencies

Setelah login ke VPS via SSH, langkah pertama selalu update sistem:

# Update dan upgrade sistem
sudo apt update && sudo apt upgrade -y

# Install dependencies dasar
sudo apt install -y curl wget git build-essential ca-certificates gnupg lsb-release unzip

Proses update akan memastikan semua package berada di versi terbaru. Ini penting untuk keamanan dan kompatibilitas.

Buat User Non-Root (Best Practice)

Untuk production, sebaiknya jangan jalankan layanan dengan user root:

# Buat user baru (ganti 'openclaw' dengan nama yang kamu inginkan)
sudo adduser openclaw
sudo usermod -aG sudo openclaw

# Switch ke user baru
su - openclaw

📦 Install Node.js v22

OpenClaw membutuhkan Node.js versi 22 atau lebih baru. Gunakan NodeSource untuk mendapatkan versi terbaru yang stabil:

# Tambahkan NodeSource repository untuk Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# Install Node.js
sudo apt install -y nodejs

# Verifikasi instalasi
node --version  # Harus menampilkan v22.x.x atau lebih tinggi
npm --version   # Versi npm yang terinstall bersama Node.js

Alternatif menggunakan pnpm (lebih cepat dan hemat disk):

# Install pnpm secara global
npm install -g pnpm

# Verifikasi
pnpm --version

🦞 Install OpenClaw

Ada dua cara menginstall OpenClaw: melalui npm (cara paling mudah untuk production) atau dari source code (untuk development atau kustomisasi mendalam).

Metode 1: Install via npm (Direkomendasikan)

# Install OpenClaw secara global
npm install -g openclaw@latest

# Atau menggunakan pnpm
pnpm add -g openclaw@latest

# Verifikasi instalasi
openclaw --version

Metode 2: Install dari Source Code

# Clone repository OpenClaw
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Install dependencies
pnpm install

# Build project
pnpm ui:build  # Otomatis install UI deps saat pertama kali
pnpm build

# Cek versi yang terinstall
pnpm openclaw --version

Untuk production sederhana, metode npm jauh lebih mudah dikelola dan di-update. Source code lebih cocok jika kamu ingin memodifikasi perilaku OpenClaw atau berkontribusi ke proyek.

⚙️ Setup Onboarding OpenClaw

Setelah terinstall, jalankan wizard onboarding. Wizard ini akan memandu kamu langkah demi langkah untuk mengkonfigurasi gateway, workspace, channel, dan skills:

# Jalankan onboarding wizard dengan sekaligus install daemon
openclaw onboard --install-daemon

Wizard akan menanyakan beberapa hal:

• API Key — Masukkan API key dari provider AI yang kamu gunakan (mis. Anthropic, OpenAI, atau OpenRouter)
• Model default — Pilih model AI (mis. anthropic/claude-opus-4-6)
• Gateway port — Port default adalah 18789
• Channel — Pilih channel yang ingin dihubungkan (Telegram, Discord, dll.)

Setelah wizard selesai, kamu bisa memverifikasi setup:

# Cek status keseluruhan sistem
openclaw status

# Mulai gateway secara manual untuk test
openclaw gateway --port 18789 --verbose

# Kirim pesan test
openclaw agent --message "Halo OpenClaw, apakah kamu berjalan?" --thinking high

Konfigurasi disimpan di ~/.openclaw/openclaw.json. File ini adalah pusat konfigurasi OpenClaw kamu. Workspace default ada di ~/.openclaw/workspace.

Contoh Konfigurasi Minimal

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback"
  }
}

🔄 Setup Daemon Systemd untuk Autostart

Agar OpenClaw berjalan otomatis saat VPS boot dan tetap aktif, kita perlu mengkonfigurasi systemd service. OpenClaw sudah menyediakan command untuk ini:

# Install dan aktifkan service systemd (user-level, tidak perlu sudo)
openclaw service install
openclaw service start

# Verifikasi service berjalan
openclaw service status

# Atau cek via systemctl
systemctl --user status openclaw

Jika ingin membuat unit file systemd secara manual (untuk lebih banyak kontrol):

# Buat directory jika belum ada
mkdir -p ~/.config/systemd/user

# Buat file service
cat > ~/.config/systemd/user/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw AI Assistant Gateway
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/openclaw gateway
WorkingDirectory=%h
Restart=always
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=default.target
EOF

# Reload dan aktifkan
systemctl --user daemon-reload
systemctl --user enable openclaw
systemctl --user start openclaw
systemctl --user status openclaw

sudo loginctl enable-linger $(whoami)

📡 Menghubungkan Channel Komunikasi

OpenClaw mendukung banyak channel. Untuk audience Indonesia, yang paling relevan adalah Telegram, WhatsApp, dan Discord. Berikut cara mengkonfigurasinya:

Telegram Bot

# Di ~/.openclaw/openclaw.json, tambahkan konfigurasi Telegram:
{
  "channels": {
    "telegram": {
      "botToken": "123456789:ABCDEFGHIjklmnopqrstuvwxyz",
      "allowFrom": ["username_telegram_kamu"]
    }
  }
}

Dapatkan bot token dari @BotFather di Telegram. Isi allowFrom dengan username Telegram kamu untuk keamanan.

Discord Bot

{
  "channels": {
    "discord": {
      "token": "discord-bot-token-kamu",
      "allowFrom": ["discord_user_id_kamu"]
    }
  }
}

WhatsApp

# Scan QR code untuk link WhatsApp
openclaw channels login

# Konfigurasi di openclaw.json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+628123456789"]
    }
  }
}

Setelah konfigurasi channel, restart gateway dan cek status:

openclaw service restart
openclaw doctor  # Diagnosa kesehatan sistem
openclaw status  # Status keseluruhan

🔐 Konfigurasi Keamanan Production

OpenClaw terhubung ke channel pesan nyata. Keamanan bukan opsional, tapi wajib. Berikut best practice untuk deployment production:

1. Kunci Gateway ke Loopback

# Di openclaw.json, pastikan gateway bound ke loopback
{
  "gateway": {
    "bind": "loopback",
    "port": 18789,
    "auth": {
      "mode": "password"
    }
  }
}

2. Allowlist Channel

Selalu isi allowFrom dengan user ID yang diizinkan. Jangan biarkan kosong atau gunakan "*" kecuali memang diperlukan.

3. Setup Firewall

# Setup UFW firewall
sudo ufw allow OpenSSH
sudo ufw allow 80
sudo ufw allow 443
sudo ufw enable

# Jangan buka port gateway (18789) ke publik!
# Gateway hanya untuk loopback atau akses via tunnel

4. Sandbox Mode untuk Grup

# Aktifkan sandbox untuk sesi non-main (grup/channel)
{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

🚀 Kenapa VPS SufaNet Cocok untuk OpenClaw?

Memilih VPS yang tepat untuk menjalankan OpenClaw adalah keputusan krusial. Untuk pengguna Indonesia, VPS Indonesia SufaNet menawarkan keunggulan yang sulit ditandingi oleh provider lain.

🔍 Troubleshooting Umum

# Pastikan npm global bin ada di PATH
export PATH="$(npm root -g)/../bin:$PATH"
echo 'export PATH="$(npm root -g)/../bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Cek port yang digunakan
sudo lsof -i :18789
# Ganti port di konfigurasi atau kill proses yang menggunakan port tersebut

# Cek log kesalahan
openclaw doctor
# Pastikan bot token benar dan allowFrom diisi dengan username/ID kamu

sudo loginctl enable-linger $(whoami)
openclaw service install
openclaw service start

❓ FAQ (Pertanyaan yang Sering Diajukan)

🎯 Kesimpulan

Menginstall OpenClaw di VPS Linux bukanlah hal yang sulit jika kamu mengikuti langkah-langkah yang benar. Dengan Node.js v22, konfigurasi daemon systemd, dan pengaturan keamanan yang tepat, kamu bisa memiliki AI assistant personal yang berjalan 24/7 di servermu sendiri.

Kunci sukses deployment production OpenClaw ada di tiga hal:

1. Server yang stabil — VPS dengan uptime tinggi dan resource yang jujur
2. Konfigurasi keamanan yang benar — Jangan biarkan gateway terekspos ke publik tanpa proteksi
3. Monitoring rutin — Gunakan openclaw doctor untuk memastikan semua berjalan baik

Untuk pengguna Indonesia, memilih VPS Indonesia SufaNet memberikan keuntungan latency rendah yang membuat pengalaman chat dengan AI assistant terasa lebih responsif. Jika kamu butuh jangkauan internasional, VPS Singapore SufaNet adalah pilihan tepat dengan koneksi regional yang kuat.