Dokumentasi untuk menghubungkan OpenClaw ke AI Gateway SahabatMobile.
Channel ini membahas OpenClaw dari nol: apa itu, cara menyambungkannya ke SahabatMobile, model mana yang boleh dipakai, dan cara menangani error. Semua contoh konfigurasi mengikuti format resmi dokumentasi OpenClaw.
OpenClaw adalah program agen AI yang berjalan di komputermu sendiri (laptop, VPS, atau server). Bedanya dengan chat di browser: OpenClaw bisa memegang pekerjaan panjang, dihubungkan ke aplikasi pesan seperti Telegram atau WhatsApp, dan dijadwalkan lewat cron bawaannya.
| Lapis | Letaknya | Perannya |
|---|---|---|
| 1. OpenClaw | Komputer atau VPS kamu | Agen, jadwal, kanal chat, file kerja |
| 2. SahabatMobile | Infrastruktur kami | Cek key, jatah pemakaian, hitung tagihan |
| 3. Model AI | Milik vendor pembuatnya | Menalar dan menyusun jawaban akhir |
OpenClaw tidak terikat ke satu penyedia model. Ia bicara ke model lewat provider yang kamu daftarkan di file konfigurasinya — dan SahabatMobile bisa didaftarkan sebagai salah satu provider itu karena endpoint-nya kompatibel OpenAI. Caranya ada di Tutorial 2.
OpenClaw mengenal provider baru lewat blok models.providers
di file konfigurasinya (format JSON5). Isinya tiga hal yang sama
seperti di Hermes: alamat server, kunci, dan daftar model.
Ambil key paket dari Plan Details
(awalan sk-) kalau berlangganan paket, atau key PAYG dari
/ai/api-keys. Simpan sebagai environment variable supaya
tidak tertulis polos di file config:
export SM_API_KEY="sk-sm-ISI_KEY_KAMU"
Tambahkan blok ini ke konfigurasi OpenClaw-mu
(mode: "merge" artinya provider bawaan tetap ada,
SahabatMobile hanya ditambahkan):
{
agents: {
defaults: { model: { primary: "sahabatmobile/mimo-v2.5" } },
},
models: {
mode: "merge",
providers: {
sahabatmobile: {
baseUrl: "https://www.sahabatmobile.com/api/v1",
apiKey: "${SM_API_KEY}",
api: "openai-completions",
models: [
{ id: "mimo-v2.5", name: "MiMo V2.5" },
],
},
},
},
}
baseUrl = alamat
gateway SahabatMobile. apiKey dibaca dari environment
variable (tanda ${...}), jadi key tidak menempel di
file. api: "openai-completions" = format yang dipakai
gateway kami. primary = model yang dipakai agen
kalau kamu tidak menyebut lain.
Restart agar config terbaca ulang, lalu minta agent mengerjakan sesuatu yang ringan (misal: "tulis satu kalimat perkenalan"). Kalau dijawab, sambungan hidup. Kalau error, cocokkan kodenya di Tutorial 4.
models di blok yang sama (misal MiniMax atau Gemini),
lalu ganti primary-nya. Aturan paket vs PAYG-nya sama
seperti di Tutorial 3.
Aturannya sama persis seperti di Hermes, karena yang mengatur adalah gateway SahabatMobile, bukan aplikasinya:
mimo atau minimax hanya jalan
kalau kamu punya paket aktif. Tanpa paket: 403 model_requires_package.mimo-v2.5 (128K konteks,
ditanggung kuota). Contoh PAYG: google/gemini-2.5-flash
(dibayar dari saldo).Cara tes paling cepat tanpa membuka OpenClaw: tembak gateway langsung dengan curl memakai key yang sama:
curl https://www.sahabatmobile.com/api/v1/chat/completions \
-H "Authorization: Bearer sk-sm-KEY_KAMU" \
-H "Content-Type: application/json" \
-d '{"model": "mimo-v2.5",
"messages": [{"role": "user", "content": "halo"}]}'
Kalau curl dibalas tapi OpenClaw error, masalahnya di sisi config
OpenClaw (salah ketik baseUrl, env var tidak terbaca, atau
format JSON5 rusak). Kalau curl-nya sendiri error, masalahnya di
key/paket/kuota:
| Kode | Artinya |
|---|---|
401 |
Key salah / env var tidak terbaca. Cek echo $SM_API_KEY. |
402 |
Saldo kurang (model di luar paket). |
403 model_requires_package |
Model paket tanpa paket aktif. |
429 |
Kuota/rate limit habis. Cek error.code. |
5h_exhausted,
pace_over, aturan retry) ada di
Tutorial 5 channel Hermes.
Hanya ulangi request untuk 429/5xx; 401/403 diperbaiki dulu penyebabnya.
Di VPS SahabatMobile, OpenClaw terdeteksi sebagai aplikasi terpasang
(folder /home/ubuntu/.openclaw). Berbeda dengan Hermes,
untuk OpenClaw belum ada tombol hubungkan akun, pilih model,
atau tes koneksi di portal — penyambungan ke SahabatMobile
dilakukan lewat file konfigurasi seperti
Tutorial 2.
OpenClaw menjangkau aplikasi chat lewat Gateway-nya. Setiap kanal (Telegram, WhatsApp, Discord, dan lain-lain) didaftarkan sekali, lalu agent bisa diajak ngobrol dari sana tanpa buka terminal.
Telegram butuh token bot saja, tanpa install plugin tambahan. Buat bot dulu lewat BotFather di Telegram sampai dapat token, lalu daftarkan:
openclaw channels add --channel telegram --token GANTI_DENGAN_TOKEN_BOT
Tanpa flag pun bisa — openclaw channels add saja akan
menampilkan daftar kanal untuk dipilih satu per satu.
WhatsApp memakai plugin resmi yang dipasang otomatis saat pertama dipilih. Tautkan akunnya dengan QR:
openclaw channels login --channel whatsapp
Siapkan HP di tangan sebelum menjalankan perintah ini — QR yang tampil di terminal ada masa berlakunya. Disarankan memakai nomor khusus (bukan nomor pribadi utama) untuk agent.
openclaw gateway openclaw channels status --probe
Secara bawaan pengirim tak dikenal tidak langsung diterima — mereka mengajukan pairing dan pemilik menyetujui. Daftar pengajuan dan setujui dari CLI:
openclaw pairing list whatsapp openclaw pairing approve whatsapp KODE_YANG_MUNCUL
Kode pairing kedaluwarsa dalam 1 jam, jadi setujui segera setelah muncul. Aturan ini bisa diketatkan ke allowlist kalau hanya nomor tertentu yang boleh masuk.
Skill di OpenClaw adalah folder berisi file instruksi
SKILL.md yang mengajari agent cara memakai suatu tool.
Katalog publiknya bernama ClawHub — cari di sana,
pasang yang cocok, lalu pastikan terdaftar.
openclaw skills search "kata kunci"
Tulis kebutuhanmu dalam bahasa sehari-hari, misal calendar atau
PDF. Catat nama pemilik dan slug-nya persis seperti yang tampil
(format @owner/nama-skill).
openclaw skills install @owner/nama-skill
Secara bawaan skill masuk ke workspace yang sedang aktif. Kalau
mau dipakai semua agent di mesin itu, tambah flag
--global supaya masuk ke folder bersama
~/.openclaw/skills. Untuk sumber selain ClawHub
(Git atau folder lokal) ada varian git: dan path
langsung — polanya sama, tinggal ganti sumbernya.
openclaw skills list openclaw skills update --all
Nama skill harus muncul di daftar. Perintah update hanya mengejar
pemasangan dari ClawHub — yang dari Git atau folder lokal dipasang
ulang manual kalau mau versi barunya. Kalau ada yang meragukan
keasliannya, cek dengan openclaw skills verify @owner/nama-skill.
hermes skills install tidak jalan
di OpenClaw, dan sebaliknya.
Sama seperti Hermes, OpenClaw tidak perlu dipasang manual baris per baris. Di portal sudah tersedia citra jadi OpenClaw — pilih templatnya saat reinstall, sisanya dikerjakan sistem.
Di portal, masuk Server Saya → klik server-mu → cari tombol reinstall (sejajar Start, Stop, Reboot). Kalau muncul pesan "Tunggu sebentar", cloud sedang sibuk — coba lagi setelah selesai, jangan dipaksa.
Biarkan metode Gunakan templat aplikasi (sudah terpilih otomatis), lalu klik templat OpenClaw dari daftar. Cara klik-klik lengkapnya — saring kategori, tombol Tampilkan semua templat, peringatan RAM/disk — sama persis seperti di Tutorial 11 channel Hermes, jadi tidak ditulis ulang di sini.
Aturannya sama: snapshot dulu kalau ada data yang masih dibutuhkan (opsi Instal ulang setelah pencadangan), atau relakan terhapus total. Isi password dua kali (harus sama), centang persetujuan, lalu jalankan dan tunggu sampai selesai.
Setelah VPS menyala lagi, OpenClaw tinggal di folder
/home/ubuntu/.openclaw. Portal mendeteksinya otomatis
sebagai aplikasi terpasang — kalau panel server-mu menampilkan
OpenClaw di daftar aplikasi, berarti install templatnya sukses.
Berbeda dengan Hermes yang punya tombol Hubungkan akun, OpenClaw
disambungkan lewat file konfigurasi seperti di
Tutorial 2 (daftarkan provider
sahabatmobile, isi key, restart, tes). Selesaikan
tutorial itu, lalu kembali ke sini untuk langkah terakhir.
Terakhir, hubungkan kanal chat (Tutorial 6) dan pasang skill (Tutorial 7). Urutan ini disengaja: templat dulu, provider kemudian, kanal dan skill paling akhir.
Istilah yang dipakai di seluruh dokumentasi ini. Dibaca sekali, berlaku untuk AI Gateway, Hermes, dan OpenClaw.
| Istilah | Artinya |
|---|---|
| AI Gateway | Pintu tunggal SahabatMobile untuk memakai banyak model AI lewat satu API endpoint yang kompatibel OpenAI. |
| API Key | Kunci rahasia awalan sk- untuk membuktikan identitas tiap request. Key paket diambil di Plan Details, key PAYG di /ai/api-keys. |
| Base URL | Alamat gateway: https://www.sahabatmobile.com/api/v1. Diisi di kolom Base URL / Endpoint aplikasi agar mengarah ke SahabatMobile. |
| Channel | Bagian dokumentasi ini (AI Gateway, Hermes, OpenClaw) — dan juga aplikasi pesan yang tersambung ke agent (WhatsApp, Telegram). |
| Credit | Satuan bayar paket. 1 credit = Rp600. Paket Hemat Rp49.000 = 82 credit. |
| Kanal | Sama dengan channel: aplikasi pesan yang tersambung ke agent. Statusnya Terhubung atau Belum disambung. |
| Konteks | Banyaknya teks yang bisa dibaca model dalam sekali jalan. MiMo V2.5: 128K, MiniMax: 1M. |
| Kuota paket | Jatah pemakaian dari paket aktif, dijaga jendela 5 jam dan mingguan. Habis = tunggu reset atau perpanjang. |
| Model | Otak AI yang menjawab (MiMo, MiniMax, Gemini, Claude, ...). Ditulis persis, huruf kecil, misal mimo-v2.5. |
| Paket | Langganan bulanan (Hemat, Coding, MiniMax, Pro). Kuotanya terkunci ke model tertentu. |
| PAYG | Pay-as-you-go: bayar per pakai dari saldo, tanpa paket. Semua model non-eksklusif boleh dipakai. |
| Provider | Sumber model yang didaftarkan di aplikasi (Hermes/OpenClaw). Provider kita bernama sahabatmobile. |
| Saldo / Wallet | Uang di akun untuk bayar pemakaian PAYG. Model di luar paket memotong saldo. |
| Skill | Kemampuan siap pasang di agent (baca PDF, ringkas, olah gambar). Hermes: 229 skill 3 tier. OpenClaw: katalog ClawHub. |
| Token | Potongan teks yang dihitung untuk biaya. Pemakaian tercatat di Plan Details / Penggunaan token. |
Apakah halaman ini membantu?
Membeli Paket MiniMax
baru saja • Rp0 • Lihat Paket