Hermes Agent ke Telegram: Chat AI dari HP

Bedakan dari memasang Hermes

Artikel ini membahas cara menghubungkan Hermes Agent yang sudah tersedia ke Telegram, bukan cara memasang Hermes di VPS atau di Termux. Untuk panduan instalasi Android yang berbeda, baca memasang Hermes Agent di Termux. Setelah tersambung, kamu bisa mengirim pesan ke bot dari HP tanpa membuka terminal setiap kali. Rincian gateway bisa berubah, jadi ikuti dokumentasi resmi Hermes yang berlaku untuk versi terpasang.

Buat bot pribadi di Telegram

Buka Telegram dan cari akun resmi @BotFather. Kirim /newbot, pilih nama tampilan, lalu username unik yang berakhir dengan bot. BotFather akan memberikan API token. Simpan token secara rahasia: siapa pun yang memegangnya dapat mengendalikan bot. Jangan menaruhnya di repositori publik, tangkapan layar, atau pesan grup.

Hermes menggunakan numeric Telegram user ID untuk membatasi siapa yang dapat berbicara dengan bot. Dokumentasinya menyarankan @userinfobot atau @get_id_bot untuk mengetahui angka ID. Catat ID akunmu sendiri; jangan mengandalkan username karena konfigurasi allowlist yang dijelaskan Hermes menggunakan ID numerik.

Konfigurasikan gateway Hermes

Cara paling mudah yang didokumentasikan adalah menjalankan wizard:

hermes gateway setup

Pilih Telegram ketika diminta, lalu masukkan token BotFather dan ID pengguna yang diizinkan. Dokumentasi juga menjelaskan konfigurasi manual di ~/.hermes/.env menggunakan variabel TELEGRAM_BOT_TOKEN dan TELEGRAM_ALLOWED_USERS. Contoh bentuknya:

TELEGRAM_BOT_TOKEN=TOKEN_DARI_BOTFATHER
TELEGRAM_ALLOWED_USERS=123456789

Ganti nilai contoh dengan token dan ID milikmu; jangan menyalin token ke artikel, Git, atau chat publik. Pastikan allowlist diisi. Menurut dokumentasi Hermes, gateway menolak pengguna secara default bila daftar yang diizinkan tidak disetel. Bagikan username bot kepada akunmu sendiri untuk membuka percakapan; token tidak dibutuhkan untuk mengirim pesan lewat aplikasi Telegram.

Jalankan dan tes dari HP

Mulai gateway dengan perintah yang tercantum di dokumentasi:

hermes gateway

Tunggu bot aktif, lalu kirim pesan langsung dari akun Telegram yang ID-nya sudah diizinkan. Jika tidak ada balasan, periksa kembali token, angka allowlist, koneksi server, dan apakah gateway sedang berjalan. Jangan menambah key konfigurasi atau mengganti lokasi file berdasarkan tebakan; dokumentasi resmi Hermes untuk gateway Telegram adalah acuan untuk versi terbaru.

Lindungi bot dan tangani kebocoran

Untuk percakapan pribadi, batasi allowlist hanya ke akunmu. Jika bot dimasukkan ke grup, pengaturan privasi Telegram memengaruhi pesan yang dapat dilihatnya; ikuti instruksi resmi Hermes dan BotFather, lalu uji dengan hati-hati. Jangan menonaktifkan pembatasan grup kecuali benar-benar diperlukan.

Jika token bocor, dokumentasi Hermes menyarankan segera mencabutnya melalui /revoke di BotFather. Setelah pencabutan, ikuti petunjuk Hermes untuk memasukkan token baru dan menjalankan ulang gateway; langkah persisnya dapat bergantung pada cara instalasi, jadi periksa dokumentasi versi yang sedang digunakan sebelum melangkah. Jangan menganggap menghapus pesan yang berisi token sudah cukup.