Learning / AI Tools & Agent

Tutorial: Hubungkan Hermes ke Telegram (Pakai OpenRouter)

Langkah mengikuti dokumentasi resmi Hermes.

Alur Telegram ke Hermes ke OpenRouter

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

  1. Buka Telegram, cari @BotFather (centang biru resmi) atau buka t.me/BotFather.
  2. Kirim /newbot.
  3. Isi nama tampilan (bebas), lalu username yang harus berakhiran "bot" (misal belajarai_hermes_bot).
  4. 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 /revoke ke 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 .env otomatis. 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 /sethome di 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 ke TELEGRAM_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

MasalahSolusi
Bot diam totalCek 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 grupPrivacy 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 tidurMode polling butuh mesin menyala; pindah ke server/VPS atau webhook (lanjutan)
Dua gateway pakai token samaTelegram 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/.env ke repo publik.
  • Membagikan screenshot yang memuat token.

Latihan

  1. Buat bot, sambungkan, dan minta: "Ringkas berita AI hari ini dalam 5 poin."
  2. Tambahkan teman via pairing, lalu cabut aksesnya dengan hermes pairing revoke.
  3. Uji: minta bot menghapus folder uji coba → amati prompt persetujuan.
Gabung grup