Channel Hermes

Hermes Agent

Semua tentang Hermes Agent: apa itu, fungsinya, cara memasangnya ke SahabatMobile, cara memakai skill, sampai cara menangani error yang sering muncul.

Pusat Tutorial Ikuti Tur Newbie Lihat AI Gateway

Hermes Agent NEWBIE FRIENDLY

Hermes Agent adalah AI agent yang bisa kamu arahkan ke SahabatMobile lewat endpoint OpenAI-compatible. Tidak perlu kartu kredit, cukup pakai QRIS. Panduan ini dari NOL sampai sukses — khusus untuk Paket Hemat → MiMo V2.5 (paket paling murah, 128K konteks, hanya Mimo Original).

Paket Hemat = Rp49.000 / bulan → 82 credit, hanya model mimo-v2.5. Model eksklusif paket lain (minimax-*) juga ditolak 403 model_requires_package kalau dipaksa — ini normal, paket memang dikunci Mimo saja. Model biasa (DeepSeek, Claude, GPT) tetap bisa dipakai, tapi dibayar dari saldo, bukan dari kuota paket.

Tour akan menyorot tiap langkah & scroll otomatis — cocok untuk yang baru pertama kali pakai.

Pusat Tutorial Channel klik channel untuk buka / tutup

Hermes Tutorial

1 Apa itu Hermes? baca ini dulu

Hermes itu bukan model AI. Hermes adalah program atau agen AI, yaitu software yang kamu jalankan sendiri di komputer atau HP. Otak dan biaya pemrosesannya ada di sisi SahabatMobile; Hermes hanya jadi kendali yang kamu pegang.

Analogi paling gampang: Hermes itu seperti browsernya, sedangkan model AI itu seperti halaman web yang dibuka. Browser tidak berpikir, tapi tanpa browser kamu tidak bisa membuka halaman itu. Sama juga Hermes: tanpa Hermes, model AI-nya tidak bisa dipakai.

Tiga lapis yang harus dibedakan

Lapis	Letaknya	Perannya
1. Hermes	Komputer atau HP kamu	Antarmuka, skill, pengaturan, riwayat
2. Gateway SahabatMobile	Server kami	Autentikasi, kuota, pencatatan biaya
3. Model AI	Punya penyedia masing-masing	Yang benar-benar berpikir dan menjawab

Satu kalimat: Hermes = kendali, SahabatMobile = jalur dan catatan biaya, model AI = mesinnya. Kamu cukup berinteraksi dengan satu lapis saja, yaitu mengisi Base URL, API Key, dan Model. Tiga baris itu sudah menyambungkan ketiganya.

Kenapa pakai Hermes, bukan langsung pakai web chat biasa?

Skill siap pakai - kemampuan tambahan yang bisa dipasang, bukan diketik ulang tiap chat.
Satu jendela untuk banyak model - ganti model tanpa ganti aplikasi.
Bisa menangani konteks panjang - model berkonteks 128K karakter bisa mencerna dokumen tebal.
Biaya jelas - semua pemakaian tercatat di Plan Details.
Bukan sesi browser - cocok untuk pekerjaan panjang tanpa berpindah tab terus.

Tiga baris yang menghubungkan semuanya

Base URL: https://www.sahabatmobile.com/api/v1
API Key:  sk-sm-...        (dari Plan Details)
Model:    mimo-v2.5         (untuk Paket Hemat)

Kalau ketiga baris itu sudah terisi, rantainya Hermes menuju SahabatMobile menuju model sudah tersambung. Cara menempelkannya ada di Langkah 4 di bawah.

2 Fungsi Hermes - tujuh kemampuan utamanya fungsi

Hermes bukan sekadar tempat mengetik. Ini tujuh fungsi yang paling sering dipakai, dari yang paling sederhana sampai yang paling berguna.

Menjadi satu jendela chat untuk semua model

Di satu aplikasi kamu bisa mengobrol dengan MiMo, Gemini, DeepSeek, Claude, atau GPT. Tinggal ganti nama model. Ini fungsi paling dasar dan paling sering dipakai.

Menjadi kendali provider OpenAI-compatible

Hermes menerima Base URL bebas. Karena gateway SahabatMobile memakai format OpenAI, Hermes bisa diarahkan ke sana tanpa kode tambahan.

provider  : sahabatmobile
base_url  : https://www.sahabatmobile.com/api/v1
api_mode  : chat_completions

Menyimpan dan mengganti profil kerja

Profil adalah satu setelan lengkap (model, kunci, dan parameter). Bikin profil "Menulis" pakai MiMo, profil "Cari Referensi" pakai Gemini, lalu berpindah-pindah tanpa setelan ulang.

Skill, yaitu kemampuan siap pasang

Skill adalah instruksi siap pakai untuk tugas tertentu, misalnya membaca PDF, membuat ringkasan, atau mengolah gambar. Sekali pasang, skill terpakai otomatis pada percakapan berikutnya. Total ada 229 skill dalam 3 tier.

Detail lengkap ada di tutorial skill: perintah install, daftar 3 tier (Registry, SkillHub, Opsional), dan 2 aturan pemasangan — semuanya di Tutorial 3: Apa itu Skill.

Menangani konteks panjang dan dokumen

Dengan model berkonteks 128K karakter seperti mimo-v2.5, Hermes bisa membaca berkas atau dokumen panjang dalam satu sesi dan langsung menjawab berdasarkan isi dokumen itu.

Riwayat pemakaian dan monitoring

Semua pemakaian tercatat di Plan Details: sisa credit, persentase pemakaian per jam dan per minggu. Kalau habis, tinggal perpanjang paket, API key-nya tetap sama.

WebUI di browser sebagai pilihan tambahan

Hermes punya tampilan web untuk yang lebih suka membuka lewat browser daripada terminal. Ini sifatnya opsional. Kalau tidak dipakai, Hermes tetap berjalan lewat perintah baris dengan tiga baris yang sama.

Ringkasnya: Hermes memberi kamu satu jendela untuk semua model, skill yang bisa ditambah sewaktu-waktu, dan biaya yang selalu bisa dilacak. Langkah pemasangannya ada di bawah.

3 Apa itu Skill di Hermes? Fungsi dan kegunaannya newbie wajib baca

Skill adalah paket instruksi siap pakai di dalam Hermes. Kamu pasang sekali, lalu Hermes memakainya sendiri setiap kalitopik kamu cocok, tanpa perlu mengetik instruksi panjang di setiap chat.

Analogi: model AI itu otaknya, skill itu tata cara kerja yang kamu berikan. Otak sudah pintar, tapi tanpa tata cara, hasilnya bisa meleset dari yang kamu mau.

Skill itu apa, dan bukan apa

Skill	Bukan skill
Instruksi siap pakai	Bukan plugin atau aplikasi tambahan
Bekerja di dalam Hermes	Bukan model AI baru
Format dan aturan main	Bukan penghitung biaya atau kuota
Gratis, tidak menambah tagihan	Tidak perlu ganti API key

Skill tidak mengubah model yang dipakai dan tidak menambah ongkos request ke SahabatMobile. Yang berubah cuma cara Hermes menyusun jawabannya.

Kegunaan yang paling terasa

Menulis rapi dan konsisten - mata uang, format, gaya bahasa tetap sama setiap kali.
Membaca dokumen panjang lalu meringkasnya sesuai panjang yang kamu tentukan.
Mengolah gambar - memotong, mengubah ukuran, atau mengganti format.
Kerja berulang dengan format tetap - laporan harian, caption produk, template pesan.
Bisa ditambah kapan saja tanpa ganti aplikasi.

Tiga perintah yang dipakai

acli skills search
hermes skills install <identifier> --yes
hermes skills list

Dua aturan penting: installer tidak memakai --force dan maksimal 5 skill per pemasangan. Identifier palsu kadang tetap keluar exit code 0 padahal gagal, jadi selalu cek ulang dengan hermes skills list.

Tiga tier skill yang tersedia

Tier	Jumlah	Bentuk identifier	Keterangan
Registry	58	`official/<kategori>/<nama>`	Skill inti, paling sering dipakai
SkillHub	19 sampai 21	`<kategori>/<nama>`	Koleksi dari komunitas
Opsional	150	`<kategori>/<nama>`	Belum aktif, pilih sesuai kebutuhan
Total	229	dipakai di UI agent	tersedia untukmu

Perbedaannya cuma di asal dan status: Registry sudah jadi skill inti, Opsional belum aktif dan bisa kamu pilih sendiri saat dibutuhkan.

Intinya: skill bikin Hermes lebih konsisten, bukan lebih pintar. Kalau hasilnya masih meleset, biasanya karena skill yang dipakai kurang cocok dengan tugasmu, bukan karena modelnya salah.

4 Model mana yang boleh dipakai? Paket Hemat vs paket lain penting sebelum jual

Ini bagian yang paling sering bikinPemula bingung. Ada dua aturan yang terpisah: model eksklusif paket dan model yang ditanggung paketmu. Bedanya penting, karena kalau tertukar, model yang legal tiba-tiba ditolak.

Aturan 1: model eksklusif paket

Model yang namanya diawali mimo atau minimax hanya boleh dipanggil kalau kamu punya paket aktif. Tanpa paket, semuanya ditolak dengan 403 model_requires_package, dan itu normal, bukan bug.

Aturan 2: model yang ditanggung paketmu sendiri

Bahkan kalau paket aktif, model di luar daftar paketmu tidak ditanggung kuota. Request-nya tetap jalan, tapi tagihannya diambil dari saldo wallet. Jadi Paket Hemat tidak mengunci kamu ke satu model saja di pemakaian sehari-hari.

Contoh nyata: dengan Paket Hemat aktif, pakai mimo-v2.5 dan kuota paketmu yang berkurang. Pakai claude-sonnet-4-20250514 atau google/gemini-2.5-flash, saldo yang berkurang. Dua-duanya boleh, sumber biayanya yang beda.

Daftar paket dan model yang ditanggung

Paket	Harga	Credit	Model yang ditanggung
Paket Hemat	Rp49.000	82	`mimo-v2.5`
Paket Coding	Rp149.000	248	`mimo-v2.5`, `mimo-v2.5-pro`, `deepseek-v3.2`, `deepseek-v4-flash`, `qwen3.7-flash`
Paket MiniMax	Rp195.000	325	`MiniMax-M3`, `MiniMax-M2.7`, `MiniMax-M2.5`, `MiniMax-M2.1`, `MiniMax-M2`
Paket Pro	Rp499.000	832	12 model, termasuk `deepseek-v4-pro`, `gemini-2.5-flash`, `claude-3-haiku`

Semua paket dibatasi 30 request per menit. Batas pemakaian juga dijaga jendela 5 jam dan mingguan, supaya kuota habis perlahan dan tidak sekaligus terkuras di awal bulan.

Model yang selalu boleh (dibayar dari saldo)

Model di luar daftar paket di atas tetap bisa dipakai selama saldo cukup. Contoh yang sering dipilih:

google/gemini-2.5-flash - cepat dan murah, cocok buat coba-coba.
claude-sonnet-4-20250514 - kuat untuk menulis dan analisis.
deepseek-v4-flash -harga dan performa seimbang untuk coding harian.

Cara memastikan sebelum menjual: cek dua-duanya di Plan Details, yaitu daftar model paket dan sisa credit. Kalau model yang kamu tawarkan tidak ada di daftar paket,ña njelaskan ke pembeli bahwa biayanya dari saldo, bukan kuota paket.

5 Kode error dan cara memperbaikinya simpan halaman ini

Semua error dari SahabatMobile berbentuk sama, jadi gampang dibaca: 403 model_requires_package berarti modelnya salah atau paket belum aktif. Berikut daftar lengkapnya.

403 — model ditolak

Kode	Artinya	Perbaikan
`model_requires_package`	Model `mimo-` atau `minimax-` tanpa paket aktif	Beli paket, atau ganti ke model non-eksklusif
`model_not_billable`	Model tidak punya harga jual di katalog	Pakai model lain yang ada di daftar Models
`model_no_tool_support`	Model tidak mendukung tool/function calling	Matikan fitur tool di Hermes untuk model itu

402 — saldo kurang

insufficient_credits

Saldo wallet habis. Ini muncul kalau kamu memakai model di luar paket. Perbaikannya: top-up di Billing, atau pindahkan pemakaian ke model yang ditanggung paket.

429 — kuota atau rate limit habis

Semua kode 429 memang soal kuota, tapi penyebabnya berbeda. Cek field error.code untuk tahu yang mana:

`error.code`	Artinya	Perbaikan
`no_active_package`	Paket sudah habis masa berlakunya	Perpanjang di Packages
`5h_exhausted`	Batas 5 jam habis	Tunggu, cek `reset_in` di respons
`weekly_exhausted`	Batas mingguan habis	Tunggu reset mingguan
`monthly_exhausted`	Batas bulanan habis	Perpanjang paket
`pace_over`	Terpakai terlalu cepat dalam sebulan	Tunggu beberapa jam, kurangi laju pemakaian

401 dan 5xx

401 Unauthorized - key salah atau tidak ada. Ambil ulang dari Plan Details untuk key paket, atau dari /ai/api-keys untuk key PAYG.
5xx - gangguan di sisi penyedia model. Layak dicoba ulang, dan tidak membebankan biaya kalau request gagal.

Aturan retry: hanya 429 dan 5xx yang layak diulang. Untuk 401 dan 403, perbaiki dulu penyebabnya, jangan diulang karena hasilnya pasti sama.

Masih tidak jalan? Kirim ke CS SahabatMobile: email akun, kode error lengkap, dan screenshot pengaturan Hermes kamu. Data itu mempercepat penanganan tanpa perlu ditebak.

6 Beralih provider Hermes ke SahabatMobile sudah pakai Hermes

Kalau Hermes kamu sekarang tersambung ke provider lain (OpenAI langsung, OpenRouter, atau server lokal), kamu tidak perlu install ulang. Cukup ganti pengaturannya — riwayat chat dan skill yang terpasang tidak ikut hilang.

Catat pengaturan lama dulu

Sebelum mengubah apa pun, salin dulu Base URL, API key, dan nama model yang sekarang terisi ke catatan. Kalau ternyata ada yang salah, kamu bisa kembali persis seperti semula dalam semenit.

Ganti tiga kolom ke SahabatMobile

Di pengaturan provider Hermes (cari Custom Provider atau OpenAI Compatible), ganti isinya:

Base URL: https://www.sahabatmobile.com/api/v1
API Key:  sk-sm-...        (key PAKET dari Plan Details)
Model:    mimo-v2.5

Simpan. Kalau Hermes tidak otomatis reload, tutup lalu buka lagi.

Tes dengan satu pesan

Kirim halo. Kalau dibalas, peralihan selesai. Kalau muncul error, cocokkan kodenya dengan Tutorial 5: Kode error — hampir selalu cuma soal key tertukar atau model salah ketik.

Kalau mau kembali: tempel lagi tiga baris catatan dari langkah 1. Tidak ada yang terkunci — provider bisa diganti kapan saja tanpa menghubungi siapa pun.

7 Pasang skill pertama: cari, install, pastikan jalan praktik 5 menit

Tutorial ini praktik langsung dari Tutorial 3: mencari satu skill, memasangnya, memastikan benar-benar terpasang, lalu memakainya dalam chat biasa.

Cari dulu, jangan tebak identifier

Jalankan perintah search yang sama seperti di Tutorial 3, lalu ketik kata kunci sesuai kebutuhanmu (misal ringkasan, gambar, atau format dokumen). Catat identifier persis seperti yang tampil, termasuk besar-kecil hurufnya. Identifier registry selalu diawali official/.

Install satu per satu

hermes skills install <identifier> --yes

Ganti <identifier> dengan hasil dari langkah 1. Dua aturan pemasangannya sama seperti di Tutorial 3 (tanpa --force, maksimal 5 per pemasangan).

Pastikan benar-benar terpasang

hermes skills list

Nama skill harus muncul di daftar. Kenapa langkah ini wajib dijelaskan di Tutorial 3: identifier palsu bisa lolos tanpa error yang jelas.

Pakai lewat chat biasa

Tidak ada tombol khusus. Cukup chat seperti biasa dengan topik yang cocok dengan skill itu — misalnya minta ringkasan kalau skill-nya peringkas. Hermes memakai skill yang terpasang secara otomatis.

Kalau hasilnya tidak berubah: kemungkinan topik chat-mu belum cocok dengan skill itu, atau skill yang terpasang kurang tepat. Coba topik yang lebih spesifik dulu sebelum menyimpulkan skill-nya rusak. Detail alasannya ada di penutup Tutorial 3.

8 Menjalankan Hermes di VPS SahabatMobile khusus VPS, bahasa pemula

Tutorial ini khusus untuk kamu yang menyewa VPS SahabatMobile dan mau Hermes-nya jalan di situ — hidup 24 jam, tidak mati saat laptop ditutup. Bahasanya dibuat untuk pemula yang baru pertama kali pegang VPS.

Ide dasarnya, satu kalimat: VPS itu komputer sewaan yang tidak pernah dimatikan. Hermes dipasang sekali di sana, disambungkan ke SahabatMobile, lalu dibiarkan jalan terus. Kamu mengobrol dengannya dari HP atau laptop, yang kerja tetap si VPS.

Langkah 0 — Pilih aplikasinya sejak install (pre-install)

Hermes dan OpenClaw bisa dipasang sejak VPS dibuat — tidak perlu install manual belakangan. Saat memesan atau me-reinstall VPS di portal, kamu memilih citra (blueprint)-nya:

Templat aplikasi — Hermes Agent, OpenClaw, WordPress, dan sejenisnya. Aplikasi sudah terpasang dan siap pakai begitu VPS menyala. Ini pilihan yang dipakai tutorial ini.
Sistem operasi murni — Ubuntu polos tanpa aplikasi. Pilih ini hanya kalau kamu mau memasang semuanya sendiri.
Docker — citra berbasis container.

Nama citra yang terpasang tampil di halaman server-mu (misal "Hermes Agent" bukan sekadar "Ubuntu"), dibaca langsung dari mesin — jadi kalau nanti VPS di-reinstall dengan citra lain, namanya ikut berubah. Pilih templat Hermes Agent kalau tujuanmu menjalankan Hermes.

Sudah punya VPS jalan? Tidak perlu bikin baru. Buka halaman server-mu di portal — kalau status panel Aplikasi Prasetel-nya Siap, berarti aplikasinya sudah ada. Langsung lanjut ke langkah 2.

Langkah 1 — Siapkan dua akses: portal dan SSH (opsional)

Akses utama adalah portal (portal.sahabatmobile.com → Server Saya → server-mu). Semua langkah di tutorial ini bisa selesai dari portal saja, tanpa terminal. Akses SSH ke server-mu sendiri tersedia di tab Akses (ada tombol Lihat Password) untuk yang mau memeriksa langsung — sifatnya opsional, bukan syarat.

Kalau kamu masuk lewat SSH dan mau memastikan, tiga perintah ini harus keluar angka versi (di VPS SahabatMobile ketiganya sudah ada):

node --version
npm --version
pm2 --version

Langkah 2 — Hermes sudah terpasang, tinggal hubungkan akunmu

Kabar baik untuk pemula: kamu tidak perlu install apa pun. Hermes sudah terpasang bawaan di VPS SahabatMobile sebagai Aplikasi Prasetel. Yang belum ada hanya sambungan ke akunmu — dan itu dipasang lewat portal, bukan lewat terminal.

Buka halaman server-mu di portal

Masuk ke portal.sahabatmobile.com lalu buka Server Saya dan klik server-mu. Pindah ke tab Aplikasi Prasetel. Di atas panel ada statusnya: Siap berarti program jalan, Belum siap berarti ada yang perlu dibereskan dulu (lihat catatannya di panel).

Tempel API key-mu, klik Hubungkan akun

Di bagian Model akan ada kotak bertuliskan kurang lebih: "Model sudah terpasang di server ini, tapi belum bisa menjawab sampai akun SahabatMobile dihubungkan." Ambil API key dari Plan Details (key paket, awalan sk-), tempel ke kolomnya, lalu klik Hubungkan akun.

Portal mengecek key-mu dulu tanpa memotong kuota. Kalau key salah (tidak diawali sk- atau ditolak server), kamu langsung diberi tahu — bukan dibiarkan gagal diam-diam. Kalau berhasil muncul "Akun terhubung" beserta jumlah model yang tersedia.

Tes dengan tombol Uji koneksi

Klik Uji koneksi di panel yang sama. Hermes mengirim satu permintaan nyata dan menampilkan jawabannya. Jujur saja: tes ini memakan sedikit kuotamu — biayanya disebut terbuka supaya tidak terasa seperti biaya tersembunyi. Kalau gagal, pesannya menjelaskan penyebabnya (misal saldo habis atau model tidak tersedia), bukan sekadar "gagal".

Dua tombol yang BUKAN untukmu: kalau kamu melihat tombol Pasang provider di tutorial lain, itu khusus admin. Pelanggan cukup pakai Hubungkan akun — jangan mencari-cari tombol Pasang provider di halamanmu.

Langkah 3 — Kenali rumahnya Hermes di VPS (opsional, lewat SSH)

Langkah ini hanya untuk yang penasaran isi dalamnya — boleh dilewati. Semua data Hermes tinggal di satu folder di home user server-mu:

ls ~/.hermes/skills/

Folder skills/ berisi skill yang terpasang. Jangan dibuat atau diubah manual — biarkan portal dan program Hermes yang mengelolanya. Kalau folder ~/.hermes/ belum ada, berarti akunmu belum terhubung (kembali ke langkah 2).

Langkah 4 — Pilih model dan kanal di portal

Setelah akun terhubung (langkah 2), sambungan teknisnya sudah beres — tidak perlu mengisi Base URL atau menjalankan curl manual. Yang tersisa hanya memilih, semuanya dari tab Aplikasi Prasetel yang sama:

Sub-tab Model — cara memilih model AI agent-mu di portal, langkahnya berurutan:
1. Penyedia sudah tetap: SahabatMobile AI. Tidak perlu diganti.
2. Vendor — dropdown untuk menyaring (misal Xiaomi, MiniMax). Pilih Semua vendor kalau mau lihat semuanya; angkanya menunjukkan jumlah model per vendor.
3. Cari model — ketik di kolom pencarian (misal mimo) untuk menyaring daftar yang panjang.
4. Klik modelnya — model yang sedang dipakai bertanda centang. Daftar rekomendasi di atasnya menjelaskan tiap model: MiMo V2.5 Pro untuk kerjaan panjang, MiMo V2.5 cepat untuk harian, MiniMax M3 untuk dokumen besar.
Membaca label dan tombol yang terkunci
- Label paket = model itu ditanggung paketmu. Label butuh paket = kamu belum punya paket yang mengizinkannya.
- Tombol yang terkunci (abu-abu, tidak bisa diklik) berarti akunmu memang belum memenuhi syarat — klik model lain yang terbuka, atau beli paket dulu. Ini disengaja supaya kamu tidak mengklik, menunggu, lalu baru ditolak 403.
- Bawaan awalnya: paket → mimo-v2.5, tanpa paket (PAYG) → google/gemini-2.5-flash. Ganti kapan saja dengan klik model lain — pilihanmu tidak ditimpa otomatis.
Sub-tab Kanal — sambungkan aplikasi pesan supaya agent bisa dijangkau dari sana. Penghitungnya menunjukkan berapa kanal yang sudah Terhubung dan mana yang masih Belum disambung.
Sub-tab Keterampilan — cari dan pasang skill langsung dari portal, tanpa mengetik perintah. Angkanya dihitung per skill asli (misal productivity/powerpoint), bukan per folder kategori.
Sub-tab Penggunaan token — pantau pemakaianmu di sini.

Kalau kamu memakai Hermes di komputer sendiri (bukan VPS SahabatMobile), barulah pengisian manual berlaku — lihat Langkah 4 tur untuk tiga kolomnya (Base URL, API Key, Model).

Langkah 5 — Pasang skill, tidak perlu kunci manual

Pasang satu skill percobaan dari sub-tab Keterampilan di portal (cari, centang, pasang), atau ikuti Tutorial 7 kalau kamu bekerja lewat terminal. Penghitung di sub-tab dihitung per skill asli, jadi angkanya cocok dengan total 229 di Tutorial 3.

Kabar baik kedua: di VPS SahabatMobile kamu tidak perlu mengunci proses manual (tidak perlu pm2 start atau sejenisnya). Hermes berjalan sebagai layanan di server — patokannya badge status di panel: kalau tertulis Siap, berarti jalan, bahkan saat HP dan laptop-mu mati total. Kalau ragu, klik Periksa untuk memuat ulang statusnya.

Pengecualian: penguncian manual (misal pakai PM2) hanya berlaku kalau kamu menjalankan Hermes di komputer atau VPS sendiri, bukan di VPS SahabatMobile.

Langkah 6 — Pakai dari HP seperti biasa

Setelah langkah 5, pemakaian harian tidak butuh terminal sama sekali. Ngobrol dengan Hermes dari HP atau laptop seperti biasa — yang menjawab tetap model SahabatMobile lewat jalur yang sudah dites di langkah 2. Buka portal lagi hanya kalau mau pasang skill baru, ganti model, atau mengecek status lewat tombol Periksa.

Ringkasan alur VPS: pilih templat Hermes Agent sejak install (langkah 0), siapkan akses portal (langkah 1), hubungkan akun di tab Aplikasi Prasetel (langkah 2), intip folder kalau penasaran (langkah 3, opsional), pilih model lewat Penyedia → Vendor → Model plus kanal (langkah 4), pasang skill (langkah 5). Setelah itu pakai dari mana saja (langkah 6) — tanpa terminal, tanpa PM2, tanpa install.

9 Kanal pesan: membaca status WhatsApp dkk. Terhubung atau belum

Kanal adalah aplikasi pesan yang disambungkan ke Hermes, supaya agent bisa dijangkau tanpa membuka terminal. Buka sub-tab Kanal di Aplikasi Prasetel untuk melihat daftarnya.

Cara membaca daftarnya

Setiap baris ada nama platform dan statusnya: Terhubung (hijau) berarti kanal itu sudah bisa dipakai ngobrol, Belum disambung (abu-abu) berarti belum. Angka di tombol sub-tab menunjukkan berapa kanal yang terhubung. Kalau daftarnya malah bertuliskan "Daftar kanal tidak terbaca dari server", berarti datanya gagal diambil — klik Periksa untuk memuat ulang.

Dua lampu yang wajib dicek

Lampu	Artinya
Gateway: Berjalan	Mesin penghubung kanal hidup. Kalau tertulis Berhenti, tidak ada kanal yang bisa dipakai sampai ia jalan lagi.
Agent: namamu	Nama agent yang menjawab di kanal. Kalau tertulis Hermes saja, berarti nama khusus belum dipasang — tidak mengganggu fungsi.

Platform yang dikenali

Telegram, Discord, Slack, WhatsApp, Feishu, WeCom, WeChat, QQ Bot, DingTalk, dan Yuanbao. WhatsApp adalah yang paling umum dipakai pelanggan Indonesia.

Batas jujur tutorial ini: tab Kanal di portal hanya menampilkan status — tidak ada tombol sambung di sana. Penyambungan kanal (misal pairing WhatsApp) dikerjakan di servernya langsung, bukan dari portal. Kalau status kanal-mu masih Belum disambung dan kamu butuh menyambungkannya, minta panduan penyambungannya ke CS SahabatMobile.

10 Laporan agent ke pemilik lewat WhatsApp konsep + persiapan

Pola yang paling sering dipakai pemilik: agent Hermes yang melayani pelanggan (misal menjawab calon mahasiswa) sekaligus melapor ke pemilik lewat WhatsApp — ringkasan chat masuk, pertanyaan yang tidak terjawab, dan pemakaian token hari itu.

Syaratnya, tiga saja

Kanal WhatsApp berstatus Terhubung

Cek di sub-tab Kanal seperti Tutorial 9. Tanpa ini tidak ada jalan pesan keluar-masuk sama sekali.

Agent punya bahan untuk dilaporkan

Laporan yang bagus butuh data: riwayat chat tersimpan otomatis oleh Hermes, pemakaian token terlihat di sub-tab Penggunaan token, dan pengetahuan bot berasal dari skill + Q&A yang terpasang (Tutorial 3). Pastikan ketiganya ada sebelum meminta laporan.

Minta laporannya dengan kalimat jelas

Contoh perintah ke agent: "Ringkaskan semua chat hari ini: siapa saja yang bertanya, topik apa yang paling sering, dan sebutkan pertanyaan yang tidak bisa kamu jawab." Agent membaca riwayatnya sendiri lalu menyusun ringkasannya.

Batas jujur tutorial ini: pengiriman laporan terjadwal otomatis (misal tiap jam 9 malam) diatur di servernya, bukan dari portal — di portal belum ada tombol penjadwalan laporan. Untuk pola laporannya sendiri (isi apa saja yang diminta), tiga langkah di atas sudah cukup. Kalau butuh laporan otomatis terjadwal, minta panduannya ke CS SahabatMobile.

Aturan main laporan: angka yang dilaporkan agent (jumlah chat, topik, token) berasal dari data yang ia baca, bukan karangan. Kalau ada angka yang meragukan, cek silang dengan sub-tab Penggunaan token dan riwayat chat sebelum meneruskannya.

11 Install ulang VPS pakai templat otomatis ganti aplikasi tanpa repot

Mau ganti VPS-mu dari Hermes ke OpenClaw, atau sebaliknya, atau mulai dari nol lagi? Tidak perlu sewa VPS baru dan tidak perlu install manual. Di portal ada tombol reinstall: pilih templat aplikasinya, sisanya dipasang otomatis oleh sistem.

Buka halaman reinstall server-mu

Di portal, buka Server Saya → klik server-mu → cari tombol reinstall (biasanya di barisan aksi server, sejajar Start, Stop, dan Reboot). Tunggu kalau muncul pesan "Tunggu sebentar" — artinya cloud sedang bekerja dan semua input akan ditolak sia-sia. Coba lagi setelah selesai.

Pilih cara install: templat aplikasi

Ada tiga cara, dan yang pertama sudah dipilih otomatis karena paling gampang:

Gunakan templat aplikasi — daftar citra jadi (termasuk Hermes Agent dan OpenClaw). Semua di daftar ini langsung bisa dipakai begitu VPS menyala. Pilih ini kecuali kamu tahu persis kenapa butuh yang lain.
Berdasarkan citra sistem operasi — Ubuntu polos, aplikasi dipasang sendiri. Untuk yang sudah mahir.
Gunakan gambar khusus — image kustom milikmu sendiri (termasuk hasil Buat image kustom dari server yang sudah jadi).

Klik templat yang dimau

Daftarnya bisa disaring per kategori, dan ada tombol Tampilkan semua templat kalau yang kamu cari belum kelihatan. Klik satu templat (misal Hermes Agent) sampai terpilih. Kalau tidak memilih apa pun lalu menekan install, kamu ditolak dengan pesan "Pilih citra terlebih dahulu".

Perhatikan peringatan kebutuhan: kalau templat butuh RAM atau disk lebih besar dari VPS-mu (misal "Butuh RAM minimal sekian GB"), install tidak akan jalan dengan benar. Naikkan dulu spesifikasi servernya atau pilih templat yang lebih ringan.

Tentukan nasib data lama — ini yang paling penting

Dua pilihan, dan tidak bisa dibatalkan setelah jalan:

Instal ulang setelah pencadangan — sistem membuat snapshot disk dulu, baru install ulang. Pilih ini kalau ada data yang masih dibutuhkan.
Tidak perlu backup, cukup instal ulang — semua data di disk sistem terhapus total dan kembali seperti semula. Pilih ini hanya kalau kamu yakin tidak ada yang perlu diselamatkan.

Isi login, centang persetujuan, jalankan

Pilih login pakai password (ketik dua kali, harus sama persis — spasi sisa copy-paste otomatis dibuang) atau key pair. Lalu centang kotak persetujuan — tanpa centang, tombol install tidak jalan dan kamu diminta membacanya dulu. Setelah itu jalankan dan tunggu sampai selesai.

Sambungkan akunmu lagi

Install ulang = mesin baru. API key yang tertanam ikut terhapus, jadi ulangi Tutorial 8 langkah 2 (tempel key → Hubungkan akun → Uji koneksi). Skill dan file yang tidak ikut snapshot juga perlu dipasang ulang.

Tips hemat: sebelum reinstall, bikin dulu image kustom dari server yang sudah jadi (ada tombolnya di halaman yang sama, cukup isi nama). Image itu muncul di daftar gambar khusus dan bisa dipakai install ulang kapan saja — server langsung kembali persis seperti saat image dibuat, termasuk skill-skillnya.

Semua tutorial Hermes sudah lengkap: 11 tutorial + tur 6 langkah

Alur 6 Langkah (estimasi 5 menit)

Daftar / Login di sahabatmobile.com
Beli Paket Hemat (QRIS)
Ambil API Key Paket di Plan Details
Pasang di Hermes Agent (Base URL + Key + Model)
Tes koneksi — kirim "halo"
Pantau kuota & isi ulang

Langkah 1 — Daftar / Login

Buka sahabatmobile.com

Klik Daftar → isi nama, email, password → verifikasi HP jika diminta. Jika sudah punya akun langsung Login.

Langkah 2 — Beli Paket Hemat (khusus MiMo 2.5)

Masuk ke Packages

Buka Dashboard → Packages. Cari kartu Paket Hemat — keterangannya sekarang: "hanya Mimo Original (DeepSeek nonaktif sementara)".

Klik Mulai Sekarang → pilih metode QRIS (Xendit) → scan QR pakai GoPay / OVO / DANA / m-banking → bayar Rp49.000.

Setelah sukses, kamu otomatis dapat 82 credit. Paket aktif seketika, tidak perlu tunggu admin.

Kenapa harus Paket Hemat? Karena paket ini dikunci ke mimo-v2.5 saja (128K konteks, multimodal, paling stabil & murah). Kalau kamu pakai API key PAYG biasa tanpa paket, model paket akan ditolak dengan 403 model_requires_package.

Langkah 3 — Ambil API Key Paket (di Plan Details yang benar)

Buka Plan Details — cek yang sesuai layar asli

Masuk ke Dashboard → Plan Details (https://www.sahabatmobile.com/ai/plan-details). Jika belum punya paket aktif, kamu otomatis di-redirect ke Subscription — itu tandanya harus beli Paket Hemat dulu (Langkah 2).

Jika paket sudah aktif, halaman tampil seperti ini (sesuai kode asli):

Header Plan Details + badge Auto-sync
Hero gelap "Package API Key" — "Key ini digunakan untuk API calls. Gunakan di OpenCode, Claude Code, atau tools lainnya."
Jika belum ada key: tombol Generate API Key → klik, maka banner hijau muncul: "API key baru berhasil dibuat. Simpan key ini: sk-sm-...." — copy detik itu juga (full key hanya muncul sekali di banner).
Jika sudah ada key: tampil sk-sm-14huruf•••••••••••• (prefix saja + titik-titik) + ikon Copy (copy tanpa tampil) + tombol Reset dan Hapus. Tampilannya persis seperti di screenshot hero, bukan tabel biasa.
Bawahnya ada Usage Monitor (real-time) + rincian model Paket Hemat.

Cara copy yang benar: klik ikon di kanan key (akan fetch /ai/plan-details/key/{id}/plain dan copy ke clipboard tanpa menampilkan full key di layar) — atau copy dari banner hijau saat generate. Jangan ambil dari /ai/api-keys (itu PAYG, beda jalur).

Ingat: untuk Hermes Paket Hemat pakai key PAKET dari halaman ini, bukan key PAYG. Bedanya ada di tabel Dua jenis API key di channel AI Gateway.

Validasi: sudah dicek langsung ke PlanDetailsController@index & plan-details.blade.php — hero, Generate/Reset/Hapus, masked key_prefix••••, dan endpoint copy memang seperti di atas. Docs ini sekarang 100% sesuai tampilan asli, bukan karangan.

Langkah 4 — Pasang di Hermes Agent

Hermes yang support OpenAI-compatible cukup diisi 3 kolom ini:

Base URL: https://www.sahabatmobile.com/api/v1
API Key:  sk-sm-DARI_PLAN_DETAILS (tempel key paket, bukan key PAYG lama)
Model:    mimo-v2.5

Temukan setting Provider di Hermes

Buka Hermes Agent → Settings → Model / Provider → Add Custom Provider / OpenAI Compatible (nama menu tiap versi Hermes beda, intinya cari kolom Base URL / API Base / Endpoint).

Isi 3 field wajib

Base URL / Endpoint: https://www.sahabatmobile.com/api/v1 — harus lengkap sampai /v1, jangan tambah /chat/completions
API Key: tempel sk-sm-... dari Plan Details
Model: ketik persis mimo-v2.5 — huruf kecil, pakai strip. Jangan pakai MiniMax-M3 atau deepseek-v3.2 (akan 403 karena tidak termasuk Paket Hemat)

Simpan & restart Hermes jika perlu

Klik Save. Jika Hermes tidak auto-reload, tutup lalu buka lagi.

Tentang MiMo V2.5: Model Xiaomi, 128K konteks (bisa baca dokumen panjang), multimodal, stabil untuk coding & chat. Di Paket Hemat sengaja hanya Mimo Original — jadi performa & harga paling hemat, tidak tercampur model lain yang belum aktif.

Langkah 5 — Tes Koneksi (wajib sebelum pakai serius)

Opsi A — lewat Hermes langsung: kirim pesan halo. Jika dibalas, sukses.

Opsi B — tes pakai curl (paling akurat untuk newbie yang mau pastikan key benar):

curl https://www.sahabatmobile.com/api/v1/chat/completions \
  -H "Authorization: Bearer sk-sm-YOUR_PAKET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.5",
    "messages": [{"role": "user", "content": "halo, tes koneksi mimo 2.5 via sahabatmobile"}]
  }'

Opsi C — Python:

from openai import OpenAI
client = OpenAI(api_key="sk-sm-YOUR_PAKET_KEY", base_url="https://www.sahabatmobile.com/api/v1")
r = client.chat.completions.create(model="mimo-v2.5", messages=[{"role":"user","content":"halo"}])
print(r.choices[0].message.content)

Jika sukses → credit di Plan Details akan berkurang sedikit (tanda pemakaian tercatat).

Langkah 6 — Pantau Kuota & Isi Ulang

Kembali ke Plan Details — ada bar progress credit terpakai / total + % 5 jam & mingguan. Jika habis, top-up / perpanjang paket di Packages. Tidak perlu ganti API key — key paket tetap sama selama paket aktif.

Troubleshooting Newbie (paling sering)

Tiga error di bawah ini menutup hampir semua kasus newbie. Daftar kode lengkap (402, 429 per error.code, 401, 5xx, plus aturan retry) ada di Tutorial 5: Kode error dan cara memperbaikinya.

Gejala	Solusi singkat
`403 model_requires_package`	Model bukan `mimo-v2.5`, padahal paketmu Hemat. Ganti modelnya persis.
`401 Unauthorized`	Key tertukar. Ambil ulang dari Plan Details (key paket).
`429`	Kuota habis. Lihat `error.code`-nya (`5h_exhausted`, `weekly_exhausted`, dst) di daftar kode.

Tetap bingung? Chat CS SahabatMobile + kirim: email akun, kode error lengkap, dan screenshot Packages & Plan Details.

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?