OpenClaw adalah asisten AI pribadi open-source yang terhubung ke WhatsApp, Telegram, dan channel lain. Kemampuan menalarnya datang dari model yang kamu pasang, dan model itu bisa diarahkan ke gateway mana pun yang OpenAI-compatible.
AI Gateway Appverse cocok jadi backend-nya: bayar pakai QRIS, kuota jelas dalam token atau saldo, dan prompt kamu tidak disimpan di gateway.
Sebelum mulai
- Paket AI Gateway aktif (Token Plan atau Pay As You Go). Belum punya? Pilih paket dulu di sini.
- API key aktif dari dashboard gateway.
- OpenClaw sudah terinstal dan wizard onboarding pertama sudah lewat. Belum? Jalankan npm install -g openclaw@latest.
- Satu Model ID dari tabel harga model.
Langkah integrasi
- 1
Ambil API key
Copy API key aktif dari dashboard gateway, atau halaman Token Plan bila kamu pemilik Token Plan karena key di-assign otomatis ke akun saat pembayaran.
- 2
Tambahkan provider di openclaw.json
Buka file config utama di ~/.openclaw/openclaw.json, lalu tambahkan blok models dan agents berikut.
Key models.providers membuat OpenClaw mengenal gateway, sedangkan agents.defaults.model.primary menjadikan model itu default untuk semua agent. OpenClaw menyalin provider ini ke file models.json internal tiap agent secara otomatis, jadi edit selalu openclaw.json, bukan file internal itu.
~/.openclaw/openclaw.json { "models": { "providers": { "appverse": { "baseUrl": "https://ai.appverse.id/v1", "api": "openai-completions", "apiKey": "API_KEY_KAMU", "models": [ { "id": "MODEL_ID_DARI_DASHBOARD", "name": "AppVerse Model" } ] } } }, "agents": { "defaults": { "model": { "primary": "appverse/MODEL_ID_DARI_DASHBOARD" } } } } - 3
Cek dan set model default lewat CLI
Jalankan openclaw models list untuk melihat referensi lengkap model baru kamu, yang formatnya appverse/MODEL_ID_DARI_DASHBOARD.
Kalau default di config belum aktif, set manual dengan perintah berikut.
Terminal openclaw models list openclaw models set appverse/MODEL_ID_DARI_DASHBOARD - 4
Restart dan uji dari channel kamu
Restart proses OpenClaw supaya config terbaca, lalu kirim satu pesan uji dari WhatsApp atau Telegram yang sudah terhubung. Balasan yang muncul berarti asisten kamu sekarang berjalan di model gateway.
Tips pemakaian
- Referensi model selalu lengkap dengan prefix provider, misalnya appverse/MODEL_ID_DARI_DASHBOARD. Bentuk tanpa prefix bisa gagal terpilih.
- Bila kamu mengaktifkan modelPolicy.allow di config, tambahkan referensi model gateway ke daftar izin supaya bisa dipilih.
- Pemakaian asisten kamu bisa dipantau dari dashboard gateway, termasuk total request dan token per periode.
Pertanyaan yang sering muncul
Model gateway tidak bisa dipilih di OpenClaw. Kenapa?
Dua penyebab paling umum: referensi model tidak ditulis lengkap (harus appverse/MODEL_ID), atau modelPolicy.allow aktif tapi model gateway belum masuk daftar izinnya. Cek keduanya di openclaw.json.
Kenapa harus edit openclaw.json, bukan models.json internal?
OpenClaw menyalin provider dari openclaw.json ke file models.json internal setiap agent lalu menggabungkannya. File internal bisa tertimpa kapan pun, jadi openclaw.json adalah sumber yang benar untuk diedit.
Apakah chat WhatsApp saya disimpan di gateway?
Gateway menerapkan ZDR (Zero Data Retention): prompt dan response yang lewat tidak disimpan dan tidak dipakai untuk training. Penyimpanan riwayat chat tetap terjadi di perangkat OpenClaw kamu sendiri.
Bisakah channel berbeda pakai model berbeda?
Bisa. Model default di agents.defaults.model berlaku global, dan kamu bisa menetapkan model lain per agent di config OpenClaw sesuai kebutuhan tiap channel.