Integrasi
OpenClaw

Integrasi OpenClaw dengan KoboiLLM

OpenClaw (opens in a new tab) adalah platform AI agent yang dapat diinstal di server lokal Anda. Panduan ini akan membantu Anda mengintegrasikan OpenClaw dengan API Key dari KoboiLLM.

Keunggulan OpenClaw di Server Lokal

  • Hemat Biaya - Bisa dijalankan di perangkat murah seperti STB (Set-Top Box) bekas
  • Server 24 Jam - Konsumsi listrik rendah (12V), cocok untuk server yang harus selalu aktif
  • Privacy - Data berada di server Anda sendiri
  • Fleksibel - Bisa diganti-ganti model AI sesuai kebutuhan

Prasyarat

Hardware yang Direkomendasikan

Video tutorial menunjukkan penggunaan:

  • STB HG680P yang dimodifikasi dengan Armbian Linux
  • RAM 2GB dengan ZRAM
  • Power Backup - UPS Mini 12V 6000mAh (bisa bertahan 6 jam tanpa listrik)

:::tip Untuk tutorial modifikasi STB dengan Armbian, Anda bisa mengikuti video tutorial dari NanangMRK di YouTube (opens in a new tab). :::

Software Requirements

  • Armbian Linux (atau distro Linux lainnya)
  • Akses SSH ke server
  • curl dan git terinstal

Langkah Instalasi

1. Update Sistem

Pertama, pastikan sistem Anda up-to-date:

sudo apt update && sudo apt upgrade -y

2. Jalankan Installer OpenClaw

OpenClaw menyediakan one-liner script untuk instalasi otomatis:

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

Installer ini akan:

  • Mendeteksi dan menginstal dependencies yang diperlukan
  • Menginstal Node.js versi 22
  • Menginstal OpenClaw CLI

3. Onboarding Wizard

Setelah instalasi selesai, wizard onboarding akan muncul. Ikuti langkah-langkah berikut:

Security Confirmation

Baca terms dan ketik y untuk melanjutkan.

Setup Mode

Pilih QuickStart untuk konfigurasi cepat.

Model/Auth Provider

Pilih Custom Provider untuk menggunakan KoboiLLM.

Konfigurasi KoboiLLM

API Base URL

Masukkan Base URL KoboiLLM:

https://api.koboillm.com/v1

:::note Pastikan menyertakan /v1 di akhir URL untuk kompatibilitas OpenAI API. :::

Membuat Virtual Key

  1. Buka dashboard KoboiLLM (opens in a new tab)
  2. Masuk ke menu Virtual Keys → Create New Key
  3. Isi form:
    • Key Name: Bebas, contoh: openclaw_koboy
    • Model: Pilih All Team Models (rekomendasi)
    • Key Type: Pilih Default

:::tip Kenapa All Team Models? Dengan memilih "All Team Models", Anda bisa berganti-ganti model (Gemini, GPT, Claude) langsung dari OpenClaw tanpa perlu membuat key baru. Jika memilih model spesifik, Anda terbatas hanya bisa menggunakan model tersebut. :::

  1. Klik Create Key dan salin Virtual Key yang muncul

Memasukkan API Key

Paste Virtual Key yang sudah dibuat ke terminal OpenClaw.

Endpoint Compatibility

Pilih OpenAI-Compatible.

Model ID

Masukkan model yang ingin digunakan:

gemini/gemini-2.5-flash

Endpoint ID dan Model Alias

  • Endpoint ID: kobolllm (atau nama yang Anda inginkan)
  • Model Alias: Bebas, contoh: gemini-2.5-flash-kobolllm

Channels dan Search Providers

Anda bisa melewati (skip) konfigurasi ini untuk sekarang. Integrasi tambahan seperti Telegram, Discord, atau Search Providers bisa dikonfigurasi nanti.

Skills dan Systemd

  • Configure skills: y
  • Install Homebrew: y (rekomendasi)
  • Install systemd service: y (agar OpenClaw berjalan otomatis)

Mengakses Dashboard

Via SSH Tunneling

Karena OpenClaw berjalan di server lokal, Anda perlu membuat SSH tunnel untuk mengakses dashboard dari browser komputer Anda:

ssh -L 18789:127.0.0.1:18789 username@ip-server

Contoh:

ssh -L 18789:127.0.0.1:18789 mafaza@192.168.188.212

Buka Dashboard

Buka browser dan akses:

http://localhost:18789

Anda akan melihat halaman login OpenClaw Gateway. Klik Connect untuk masuk ke interface chat.

Testing

Coba kirim pesan test di interface chat OpenClaw. Jika berhasil, Anda akan mendapat response dari model AI yang dipilih.

Cek Penggunaan di Dashboard KoboiLLM

Buka dashboard KoboiLLM (opens in a new tab) → Request Logs untuk melihat:

  • Request yang masuk
  • Model yang digunakan
  • Biaya per request

:::info Contoh Biaya Satu request "hello!" dengan Gemini 2.5 Flash hanya memakan biaya sekitar $0.0003 atau sekitar Rp 42 (dengan kurs $1 = Rp 14.200). :::

Tips Optimasi Biaya

OpenClaw menggunakan lebih banyak token dibanding chat biasa karena:

  • System prompt yang kompleks
  • Tool calling dan function calling
  • Context yang lebih besar

:::warning Pantau penggunaan token Anda di dashboard KoboiLLM untuk mengontrol biaya. :::

Troubleshooting

Verification Failed

Jika mendapat error "Verification Failed" saat memasukkan Model ID:

  • Pastikan format model benar (contoh: gemini/gemini-2.5-flash)
  • Pastikan Virtual Key memiliki akses ke model tersebut

Dashboard Tidak Bisa Diakses

  • Pastikan SSH tunnel sudah berjalan
  • Cek apakah port 18789 tidak diblokir firewall
  • Pastikan OpenClaw service sedang berjalan: systemctl status openclaw

Key Type AI API vs Default

Jika mengalami bug dengan Key Type "AI API", gunakan "Default" saja. Key Type "Default" lebih stabil untuk kebanyakan use case.

Video Tutorial

Untuk panduan visual yang lebih lengkap, tonton video tutorial di bagian atas halaman ini.

Bantuan

Jika mengalami kendala, Anda bisa:

  • Menghubungi support melalui Shopee (opens in a new tab)
  • Membuka issue di GitHub atau menghubungi tim OpenClaw
  • Bergabung dengan komunitas untuk diskusi
n8nRJ Auto-Metadata