Cara Memasang Clawdbot di VPS

Clawdbot adalah asisten AI pribadi open-source yang di-hosting sendiri dan terhubung ke platform pesan favorit Anda. Berbeda dengan asisten AI berbasis cloud seperti ChatGPT, Clawdbot berjalan sepenuhnya di infrastruktur Anda, memberikan kontrol penuh atas data dan privasi Anda. Dalam artikel ini, kami akan memandu Anda melalui proses instalasi Clawdbot di VPS menggunakan Node.js. Kami merekomendasikan menggunakan LightNode sebagai penyedia VPS Anda.

Apa itu Clawdbot?

Clawdbot adalah asisten AI pribadi yang kuat yang hidup di dalam aplikasi dan platform pesan favorit Anda. Ia terhubung ke WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat, dan lainnya, mengubah Large Language Models menjadi pendamping pribadi yang selalu tersedia. Fitur utama meliputi:

• Dukungan Multi-platform: Bekerja di lebih dari 10 platform pesan
• Memori Persisten: Mengingat preferensi dan percakapan Anda sebelumnya dari waktu ke waktu
• Tindakan Proaktif: Dapat mengambil tindakan, mengatur pengingat, dan mengirim notifikasi
• Self-hosted: Kepemilikan data dan kontrol privasi penuh
• Dapat Disesuaikan: Dapat diperluas dengan keterampilan dan alat
• Selalu Aktif: Berjalan 24/7 di VPS atau mesin lokal Anda

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal berikut:

1. Server VPS: Anda dapat memilih dari berbagai penyedia layanan cloud. Kami merekomendasikan LightNode karena performa dan cakupan globalnya yang luar biasa.
2. Pengetahuan Dasar Command Line: Familiar dengan perintah terminal akan sangat membantu.
3. Node.js Terpasang: Pastikan Node.js versi 22 atau lebih tinggi sudah terpasang di server Anda.
4. Persyaratan Sistem Minimum: 2GB RAM, 1 vCPU, 10GB ruang disk (4GB RAM direkomendasikan untuk penggunaan produksi).

Mengapa Kami Merekomendasikan LightNode VPS

LightNode adalah pilihan tepat untuk hosting Clawdbot karena beberapa alasan:

Manfaat Utama LightNode

• Harga Terjangkau: Paket mulai dari $7.71/bulan dengan penagihan per jam, memungkinkan Anda mencoba tanpa komitmen jangka panjang.
• 40+ Lokasi Global: Data center di 6 benua termasuk USA, Eropa, Asia, Timur Tengah, dan Afrika, memastikan latensi rendah untuk pengguna di seluruh dunia.
• Performa Tinggi: Penyimpanan NVMe SSD dan CPU frekuensi tinggi memberikan performa luar biasa untuk beban kerja AI.
• Jaminan Uptime 99,95%: Infrastruktur andal dengan akses BGP lokal memastikan asisten Anda selalu tersedia.
• Penagihan Fleksibel: Bayar hanya untuk yang Anda gunakan dengan penagihan per jam, sempurna untuk pengujian dan skala.
• Ramah Pengembang: Akses root penuh, deployment instan, dan dukungan untuk Linux dan Windows.
• Snapshot Gratis: Satu snapshot gratis per VPS untuk backup dan pemulihan mudah.
• Bonus Pengguna Baru: Dapatkan hingga $15 kredit gratis pada pengisian pertama Anda.

Konfigurasi LightNode yang Direkomendasikan untuk Clawdbot

Konfigurasi ini menyediakan sumber daya yang cukup untuk operasi Clawdbot dan memberi ruang untuk pertumbuhan seiring peningkatan penggunaan Anda.

Mulai dengan LightNode

Langkah 1: Menyiapkan VPS Anda

1. Luncurkan Instance: Masuk ke LightNode dan buat instance VPS baru. Kami menyarankan memilih lokasi yang dekat dengan pengguna utama Anda untuk latensi optimal. Untuk akses global, Singapura atau Hong Kong adalah pilihan bagus untuk pengguna Asia, sementara Silicon Valley cocok untuk pengguna Amerika Utara.

2. Pilih Sistem Operasi: Pilih Ubuntu 22.04 LTS (direkomendasikan) atau Ubuntu 24.04. Versi ini memiliki dukungan Node.js yang sangat baik dan sudah banyak diuji.

3. Akses SSH: Gunakan klien SSH untuk mengakses server Anda:

   ssh username@your_server_ip
   

Langkah 2: Memasang Node.js

Clawdbot membutuhkan Node.js versi 22 atau lebih tinggi. Berikut cara memasangnya di Ubuntu:

# Perbarui daftar paket
sudo apt update

# Pasang Node.js 22 dari repositori NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Verifikasi pemasangan
node --version
# Harus menampilkan: v22.x.x

Alternatifnya, Anda bisa menggunakan NVM (Node Version Manager) untuk fleksibilitas lebih:

# Pasang NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Pasang Node.js 22
nvm install 22
nvm use 22

# Verifikasi pemasangan
node --version

Langkah 3: Memasang Clawdbot

Ada beberapa metode instalasi yang tersedia. Pilih yang paling sesuai dengan kebutuhan Anda.

Metode 1: Skrip Installer Resmi (Direkomendasikan untuk Pemula)

Skrip installer adalah metode termudah dan secara otomatis menangani dependensi:

# Unduh dan jalankan installer
curl -fsSL https://clawd.bot/install.sh | bash

Perintah ini akan:

• Mendeteksi sistem operasi Anda
• Memastikan Node.js 22+ terpasang
• Memasang Clawdbot secara global melalui npm
• Mengatur path yang diperlukan
• Menjalankan perintah doctor untuk memverifikasi instalasi

Metode 2: Instalasi Global dengan npm

Untuk pengguna yang nyaman dengan npm:

# Pasang Clawdbot secara global
npm install -g clawdbot@latest

# Atau menggunakan pnpm (lebih cepat)
pnpm add -g clawdbot@latest

# Verifikasi pemasangan
clawdbot --version

Metode 3: Instalasi dari Source (Untuk Pengembang)

# Clone repositori
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Pasang dependensi
pnpm install

# Bangun UI
pnpm ui:build

# Bangun proyek
pnpm build

# Jalankan wizard onboarding
./dist/entry.js onboard --install-daemon

Metode 4: Instalasi Docker (Opsional)

Untuk deployment berbasis container:

# Clone repositori
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Jalankan skrip setup Docker
./docker-setup.sh

Langkah 4: Menjalankan Wizard Onboarding

Setelah instalasi, jalankan wizard onboarding untuk mengonfigurasi Clawdbot:

# Mulai wizard onboarding interaktif
clawdbot onboard --install-daemon

Wizard akan memandu Anda melalui:

1. Konfigurasi Gateway: Pilih mode gateway lokal atau remote dan atur port gateway (default: 18789).
2. Pengaturan Autentikasi: Konfigurasikan penyedia model AI Anda.
   • Anthropic (Claude): API key atau OAuth (direkomendasikan)
   • OpenAI (ChatGPT/Codex): API key
   • Penyedia Lain: Endpoint dan API key kustom
3. Konfigurasi Channel: Atur platform pesan:
   • WhatsApp: login kode QR
   • Telegram: token bot dari @BotFather
   • Discord: token bot dari Discord Developer Portal
   • Slack: OAuth atau token bot
4. Instalasi Layanan: Pasang Gateway sebagai layanan latar belakang (systemd di Linux).
5. Identitas Agen: Atur kepribadian dan perilaku default asisten Anda.

Langkah 5: Memulai Gateway

Setelah menyelesaikan wizard onboarding, Gateway harus mulai secara otomatis. Anda dapat memeriksa statusnya dengan:

# Periksa status gateway
clawdbot gateway status

# Lihat log
clawdbot logs --follow

# Periksa kesehatan
clawdbot health

Mulai Manual (jika layanan tidak berjalan)

# Jalankan gateway di foreground
clawdbot gateway --port 18789 --verbose

Mengelola Layanan

# Mulai layanan
systemctl --user start clawdbot-gateway.service

# Hentikan layanan
systemctl --user stop clawdbot-gateway.service

# Restart layanan
systemctl --user restart clawdbot-gateway.service

# Aktifkan layanan agar berjalan saat boot
systemctl --user enable clawdbot-gateway.service

# Lihat log layanan
journalctl --user -u clawdbot-gateway -f

Langkah 6: Mengakses Dashboard

Clawdbot Control UI dapat diakses melalui browser web Anda:

http://your_server_ip:18789/

Jika Anda telah mengatur autentikasi selama wizard onboarding, Anda perlu memasukkan token gateway untuk mengakses dashboard.

Akses Jarak Jauh via SSH Tunnel

Untuk akses jarak jauh yang aman:

# Buat tunnel SSH dari mesin lokal Anda
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Kemudian akses secara lokal
http://localhost:18789/

Langkah 7: Menghubungkan Channel Pertama Anda

WhatsApp

Untuk menghubungkan WhatsApp:

# Hasilkan dan tampilkan kode QR
clawdbot channels login

# Pindai dengan WhatsApp:
# Pengaturan → Perangkat Tertaut → Tautkan Perangkat

Setelah dipindai, WhatsApp Anda akan terhubung ke Clawdbot.

Telegram

1. Buat bot dengan mengirim pesan ke @BotFather di Telegram
2. Ikuti petunjuk untuk membuat bot baru
3. Salin token bot yang diberikan
4. Tambahkan bot ke Clawdbot:

clawdbot channels add --channel telegram --token "your_bot_token_here"

Discord

1. Kunjungi Discord Developer Portal
2. Buat aplikasi baru
3. Aktifkan bot di tab "Bot"
4. Salin token bot
5. Undang bot ke server Discord Anda dengan izin yang sesuai
6. Tambahkan ke Clawdbot:

clawdbot channels add --channel discord --token "your_discord_bot_token"

Langkah 8: Mengonfigurasi Keamanan DM

Secara default, Clawdbot menggunakan mode pairing untuk pesan langsung, artinya pengirim yang tidak dikenal akan menerima kode pairing dan pesan mereka tidak diproses sampai disetujui.

# Daftar permintaan pairing yang tertunda
clawdbot pairing list whatsapp

# Setujui permintaan pairing
clawdbot pairing approve whatsapp <pairing_code>

# Lihat pairing yang disetujui
clawdbot pairing list whatsapp --approved

Anda dapat mengubah perilaku ini di file konfigurasi di ~/.clawdbot/clawdbot.json.

Langkah 9: Menguji Setup Anda

Kirim pesan uji untuk memastikan semuanya berfungsi:

# Kirim pesan uji
clawdbot message send --to +15555550123 --message "Halo dari Clawdbot!"

# Atau uji via Telegram
clawdbot message send --to @your_telegram_username --message "Halo!"

Alternatifnya, kirim pesan langsung ke WhatsApp/Telegram/Discord yang terhubung, dan asisten Clawdbot Anda akan merespons.

Langkah 10: Mengonfigurasi Nginx (Opsional)

Untuk penggunaan produksi, kami menyarankan mengatur reverse proxy dengan Nginx untuk meningkatkan keamanan dan mengelola sertifikat SSL.

Pasang Nginx

sudo apt install -y nginx

Konfigurasi Nginx

Edit file konfigurasi Nginx:

sudo nano /etc/nginx/sites-available/clawdbot

Tambahkan konfigurasi berikut:

server {
    listen 80;
    server_name your-domain.com;  # Ganti dengan domain Anda

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Aktifkan Konfigurasi

# Buat symbolic link
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Uji konfigurasi Nginx
sudo nginx -t

# Restart Nginx
sudo systemctl restart nginx

Menambahkan SSL dengan Certbot (Direkomendasikan)

# Pasang Certbot
sudo apt install -y certbot python3-certbot-nginx

# Dapatkan sertifikat SSL
sudo certbot --nginx -d your-domain.com

# Certbot akan otomatis mengonfigurasi Nginx dengan SSL

Setelah ini, Clawdbot Anda dapat diakses di:

https://your-domain.com/

Pemecahan Masalah Umum

Gateway Tidak Bisa Dimulai

Jika gateway gagal mulai:

# Periksa kesalahan konfigurasi
clawdbot doctor

# Lihat log detail
journalctl --user -u clawdbot-gateway -n 50

Kesalahan Memori Habis

Pada VPS dengan 2GB RAM, Anda mungkin mengalami kesalahan memori habis saat pembaruan. Tambahkan swap file:

# Buat swap file 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Buat swap permanen
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Port Sudah Digunakan

Jika port 18789 sudah digunakan:

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

# Atau gunakan port lain
clawdbot gateway --port 18889

Bot Tidak Merespons

Jika bot Anda tidak merespons:

1. Periksa Status Gateway: clawdbot gateway status
2. Verifikasi Konfigurasi Channel: Pastikan token benar dan channel aktif
3. Periksa Autentikasi: Pastikan API key valid
4. Tinjau Log: clawdbot logs --follow untuk mencari pesan error

Memperbarui Clawdbot

Untuk memperbarui ke versi terbaru:

# Jalankan ulang installer
curl -fsSL https://clawd.bot/install.sh | bash

# Atau update via npm
npm update -g clawdbot@latest

# Restart gateway
clawdbot gateway restart

# Verifikasi kesehatan
clawdbot health

Kesimpulan

Memasang Clawdbot di VPS adalah proses yang mudah dan memberikan Anda asisten AI pribadi yang kuat, di-hosting sendiri dan dapat diakses di berbagai platform pesan. Dengan harga terjangkau, cakupan global, dan infrastruktur berperforma tinggi dari LightNode, Anda dapat menjalankan asisten AI pribadi dengan percaya diri.

Dengan mengikuti panduan ini, Anda seharusnya sudah menjalankan Clawdbot di VPS dalam waktu sekitar 20-30 menit, menyediakan pendamping AI yang selalu tersedia, menghormati privasi Anda, dan memberikan kontrol penuh atas data Anda.

Untuk kustomisasi lebih lanjut dan fitur lanjutan, lihat dokumentasi resmi di halaman GitHub Clawdbot dan jelajahi diskusi komunitas untuk wawasan dan tips tambahan.

Sumber Daya Tambahan

• Dokumentasi Resmi Clawdbot
• Repositori GitHub Clawdbot
• LightNode VPS - Penyedia VPS yang Direkomendasikan
• Komunitas Discord Clawdbot
• Skills Marketplace - Perluas asisten Anda dengan keterampilan tambahan