SahabatMobile SahabatMobile - Docs
Channel OpenClaw

OpenClaw Docs

Dokumentasi untuk menghubungkan OpenClaw ke AI Gateway SahabatMobile.

OpenClaw NEWBIE FRIENDLY

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.

Pusat Tutorial Channel klik tutorial untuk buka / tutup
OpenClaw Tutorial
1 Apa itu OpenClaw? baca ini dulu

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.

Analogi: kalau Hermes itu seperti browsernya model AI, OpenClaw itu seperti asisten pribadi yang punya meja kerja sendiri — ada laci berkasnya (workspace), ada jam dindingnya (jadwal cron), dan ada banyak saluran teleponnya (kanal chat). Otaknya tetap model AI dari SahabatMobile; OpenClaw yang mengatur kerjaannya.

Tiga lapis yang harus dibedakan

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.

2 Menyambungkan OpenClaw ke SahabatMobile satu blok config

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.

1
Siapkan API key dulu

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"
2
Daftarkan provider sahabatmobile

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" },
        ],
      },
    },
  },
}
Arti tiap baris: 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.
3
Restart OpenClaw lalu tes

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.

Mau tambah model lain? Tambahkan entri ke daftar models di blok yang sama (misal MiniMax atau Gemini), lalu ganti primary-nya. Aturan paket vs PAYG-nya sama seperti di Tutorial 3.
3 Model mana yang boleh dipakai? aturan paket sama

Aturannya sama persis seperti di Hermes, karena yang mengatur adalah gateway SahabatMobile, bukan aplikasinya:

  • Model berawalan mimo atau minimax hanya jalan kalau kamu punya paket aktif. Tanpa paket: 403 model_requires_package.
  • Model di luar daftar paketmu tetap boleh dipanggil, tapi tagihannya dari saldo wallet, bukan kuota paket.
  • Contoh aman untuk Paket Hemat: mimo-v2.5 (128K konteks, ditanggung kuota). Contoh PAYG: google/gemini-2.5-flash (dibayar dari saldo).
Daftar paket lengkap (Hemat Rp49.000, Coding Rp149.000, MiniMax Rp195.000, Pro Rp499.000 + model yang ditanggung masing-masing) ada di Tutorial 4 channel Hermes — tidak ditulis ulang di sini supaya tidak dobel.
4 Tes koneksi dan kode error simpan halaman ini

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.
Daftar kode lengkap (termasuk 5h_exhausted, pace_over, aturan retry) ada di Tutorial 5 channel Hermes. Hanya ulangi request untuk 429/5xx; 401/403 diperbaiki dulu penyebabnya.
5 OpenClaw di VPS SahabatMobile status terdeteksi

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.

Batas jujur tutorial ini: alur portal untuk OpenClaw (tombol hubungkan/tes seperti di Hermes) belum tersedia. Tutorial 2–4 di atas memakai file config dan berlaku di VPS maupun komputer sendiri. Kalau tombol portal-nya sudah ada, tutorial ini akan diperbarui.
6 Menyambungkan kanal chat: Telegram dulu, WhatsApp menyusul ngobrol dari HP

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.

1
Mulai dari Telegram (paling gampang)

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.

2
WhatsApp lewat QR (kalau butuh WA)

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.

3
Pastikan gateway jalan dan setujui pengirim
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.

Kenapa Telegram dulu? Karena tidak ada langkah install plugin dan tidak ada QR yang keburu kedaluwarsa. Begitu Telegram jalan, pola yang sama (daftarkan kanal, cek status, setujui pengirim) berlaku untuk kanal lain.
7 Skill OpenClaw: cari, pasang, pastikan jalan praktik 5 menit

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.

1
Cari dulu
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).

2
Pasang ke workspace
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.

3
Pastikan terdaftar dan mutakhir
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.

Bedanya dengan skill Hermes: formatnya sama-sama folder instruksi, tapi perintah dan katalognya beda (ClawHub vs registry Hermes). Jangan tertukar — perintah hermes skills install tidak jalan di OpenClaw, dan sebaliknya.
8 Install OpenClaw pakai templat otomatis tanpa install manual

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.

1
Buka halaman reinstall server-mu

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.

2
Pilih metode templat aplikasi, klik OpenClaw

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.

3
Tentukan nasib data, isi login, jalankan

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.

4
Pastikan OpenClaw-nya terpasang

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.

5
Sambungkan ke SahabatMobile

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.

6
Sambungkan kanal dan pasang skill

Terakhir, hubungkan kanal chat (Tutorial 6) dan pasang skill (Tutorial 7). Urutan ini disengaja: templat dulu, provider kemudian, kanal dan skill paling akhir.

Ringkasan urutan OpenClaw: templat OpenClaw (tutorial ini) → provider SahabatMobile (Tutorial 2) → model (Tutorial 3) → kanal (Tutorial 6) → skill (Tutorial 7). Error di tengah jalan? Lihat Tutorial 4.
Semua tutorial OpenClaw sudah lengkap: 8 tutorial

Status Dokumentasi

Yang sudah ada di channel ini
  • Apa itu OpenClaw dan tiga lapisnya
  • Menyambungkan OpenClaw ke SahabatMobile
  • Aturan model paket vs PAYG
  • Tes koneksi dan kode error
  • Status OpenClaw di VPS SahabatMobile

Glosarium

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?

Terima kasih atas masukannya.

© 2026 sahabatmobile. All rights reserved.