Learning / AI Tools & Agent
Tutorial: Hubungkan Hermes ke Telegram (Pakai OpenRouter)
Langkah mengikuti dokumentasi resmi Hermes.
Diagram buatan sendiri. Kamu chat di Telegram → gateway Hermes (di laptop/servermu) → model di OpenRouter → balasan kembali ke Telegram.
Yang kamu butuhkan
- Hermes sudah terinstall dan bisa chat di terminal (modul sebelumnya).
- API key OpenRouter + saldo credits.
- Akun Telegram di HP/desktop.
- Laptop/server harus menyala selama bot dipakai (mode default = polling).
Langkah 1 — Setel OpenRouter di Hermes
hermes model # pilih OpenRouter, tempel API key
hermes # tes: kirim "halo", pastikan dijawab
Langkah 2 — Buat bot di @BotFather
- Buka Telegram, cari @BotFather (centang biru resmi) atau buka
t.me/BotFather. - Kirim
/newbot. - Isi nama tampilan (bebas), lalu username yang harus berakhiran "bot" (misal
belajarai_hermes_bot). - BotFather membalas dengan token, bentuknya seperti
123456789:ABC....
🔐 Token = kunci penuh bot. Siapa pun yang memegangnya bisa mengendalikan bot. Jangan screenshot, jangan taruh di website/GitHub. Bocor? Kirim
/revokeke BotFather.
Opsional: /setdescription, /setuserpic, /setcommands (contoh isi: help - Bantuan, new - Percakapan baru, sethome - Jadikan chat ini home channel).
Jalan pintas resmi: di Hermes Desktop/dashboard ada Messaging → Telegram → Create with QR yang membuat bot dan mengisi
.envotomatis. Tutorial ini memakai cara manual supaya kamu paham isinya.
Langkah 3 — Cari User ID Telegram kamu
Hermes membatasi akses pakai user ID angka (bukan @username). Kirim pesan ke @userinfobot → ia membalas angka ID-mu. Simpan.
Langkah 4 — Konfigurasi gateway
Cara A (disarankan):
hermes gateway setup
Pilih Telegram, tempel token, isi user ID.
Cara B (manual) — edit ~/.hermes/.env:
TELEGRAM_BOT_TOKEN=TOKEN_DARI_BOTFATHER
TELEGRAM_ALLOWED_USERS=ID_TELEGRAM_KAMU # pisahkan koma untuk beberapa orang
OPENROUTER_API_KEY=KEY_OPENROUTER_KAMU
Lalu amankan file:
chmod 600 ~/.hermes/.env
Langkah 5 — Jalankan & verifikasi
hermes gateway
Kirim "halo" ke bot di Telegram. Bot seharusnya online dalam hitungan detik.
Checklist verifikasi:
- ☐ Bot membalas di DM.
- ☐ Teman yang tidak di allowlist mencoba chat → tidak dilayani (atau mendapat kode pairing).
- ☐ Kirim
/sethomedi DM supaya hasil jadwal (cron) dikirim ke sini. - ☐ Coba minta perintah berbahaya → bot meminta persetujuan "yes/no" dulu.
Pairing (alternatif allowlist)
Jika tidak ingin menulis ID satu per satu: orang baru yang DM bot akan menerima kode pairing 8 karakter (berlaku 1 jam). Pemilik menyetujui dari terminal:
hermes pairing list
hermes pairing approve telegram KODEPAIRING
hermes pairing revoke telegram USER_ID
Tanpa allowlist dan tanpa pairing, gateway menolak semua orang (aman secara default). Jangan pakai GATEWAY_ALLOW_ALL_USERS=true untuk bot pribadi.
Pakai di grup
- Privacy mode BotFather aktif secara default → bot hanya melihat
/perintah, balasan ke bot, dan mention. Matikan lewat/mybots→ Bot Settings → Group Privacy, lalu keluarkan & masukkan lagi bot ke grup. Alternatif: jadikan bot admin. - Agar tidak menyahut semua obrolan, di
~/.hermes/config.yaml:
telegram:
require_mention: true
- ID grup berupa angka negatif (misal
-100…), masukkan keTELEGRAM_GROUP_ALLOWED_CHATS, bukan ke allowlist user.
Biaya & batas
- Tiap pesan Telegram bisa memicu beberapa panggilan model (tool, ringkasan konteks). Pantau di halaman Activity OpenRouter.
- Pasang batas: isi saldo kecil dulu, matikan auto top-up saat belajar.
- Untuk hemat, pakai
provider_routing.sort: "price"atau model murah untuk tugas tambahan (auxiliary). - Telegram membatasi unduhan file bot 20 MB pada Bot API publik.
Tidak bisa bayar OpenRouter?
Kalau tidak punya kartu untuk membeli credits OpenRouter, lihat Vikey sebagai alternatif provider API (top up QRIS; gateway pihak ketiga, baca dulu catatan privasinya) atau pakai model lokal.
Troubleshooting
| Masalah | Solusi |
|---|---|
| Bot diam total | Cek token benar; lihat log di terminal hermes gateway / ~/.hermes/logs/gateway.log |
| Balasan "unauthorized" | ID kamu belum ada di TELEGRAM_ALLOWED_USERS (cek ulang di @userinfobot) |
| Jalan di DM tapi tidak di grup | Privacy mode, keluar-masuk ulang bot, allowlist grup, require_mention |
| Token bocor/invalid | /revoke di BotFather → token baru → update .env → restart gateway |
| Bot mati saat laptop tidur | Mode polling butuh mesin menyala; pindah ke server/VPS atau webhook (lanjutan) |
| Dua gateway pakai token sama | Telegram menolak polling ganda; 1 token = 1 gateway |
❌ Jangan lakukan
- Menaruh token bot / API key di HTML, JavaScript, atau file statis website e-learning. Semua yang ada di frontend bisa dibaca pengunjung.
- Commit
~/.hermes/.envke repo publik. - Membagikan screenshot yang memuat token.
Latihan
- Buat bot, sambungkan, dan minta: "Ringkas berita AI hari ini dalam 5 poin."
- Tambahkan teman via pairing, lalu cabut aksesnya dengan
hermes pairing revoke. - Uji: minta bot menghapus folder uji coba → amati prompt persetujuan.