Bot Telegram Hermes Diam? Cara Cek dan Perbaiki
Troubleshooting, bukan pemasangan awal
Panduan ini untuk bot Hermes Agent yang sebelumnya sudah tersambung ke Telegram tetapi sekarang tidak membalas. Langkahnya berbeda dari cara menghubungkan Hermes Agent ke Telegram, dan bukan tips untuk menghemat token. Mulailah dengan mencari tahu apakah gateway hidup, apakah akun diizinkan, dan apakah model AI dapat dihubungi.
Periksa service dan log terlebih dahulu
Pastikan gateway berjalan
Jika Hermes dipasang sebagai service, ikuti perintah yang sesuai pada dokumentasi versi dan sistem operasi yang dipakai. Untuk instalasi Linux systemd, dokumentasi resmi menyediakan pemeriksaan hermes gateway status serta perintah untuk memulai service bila berhenti. Sesudah perubahan konfigurasi, restart gateway dengan cara yang didokumentasikan untuk instalasi tersebut; jangan menjalankan banyak salinan sekaligus.
Lihat log gateway untuk pesan terbaru. FAQ resmi menunjukkan lokasi log ~/.hermes/logs/gateway.log dan cara meninjau bagian akhirnya. Perhatikan waktu pesan, platform yang disebut, dan penyebab yang ditulis. Simpan beberapa baris yang relevan, tetapi jangan menyalin token bot, kunci API, atau isi percakapan pribadi ke forum publik.
Periksa allowlist dan token dengan aman
Telegram dapat menolak pengirim yang tidak tercantum pada daftar pengguna yang diizinkan. Cocokkan ID akun Telegram yang seharusnya boleh memakai bot dengan pengaturan allowlist. Nama pengguna Telegram bukan pengganti ID numerik. Dokumentasi Hermes menganjurkan pembatasan akses, sehingga jangan mengubah bot menjadi terbuka untuk semua orang sekadar sebagai tes.
Pastikan token bot tersimpan di berkas konfigurasi rahasia yang benar dan tidak kedaluwarsa. Jangan menempelkan token ke percakapan atau tangkapan layar. Jika token terungkap, cabut melalui BotFather dan konfigurasi ulang lewat alur setup resmi. Dua gateway atau profil tidak boleh memakai token Telegram yang sama secara bersamaan; dokumentasi menyebut koneksi duplikat dapat membuat adapter kedua dinonaktifkan atau gagal aktif.
Bedakan masalah provider dan jaringan
Jika log menunjukkan gateway aktif tetapi permintaan AI gagal, periksa koneksi jaringan, alamat endpoint yang dikonfigurasi, model/provider yang dipilih, serta status akun pada layanan provider. FAQ Hermes mengaitkan respons 429 dengan batas laju provider dan menyarankan menunggu lalu mencoba lagi atau memakai provider lain yang sudah dikonfigurasi. Untuk kode lain seperti 402, jangan menebak penyebabnya: baca pesan lengkap dan keterangan provider yang tercatat di log, karena arti dan tindakan lanjutnya bergantung pada layanan yang menolak permintaan.
Panduan resmi Telegram Hermes Agent, FAQ troubleshooting, dan pengelolaan gateway menjelaskan alur konfigurasi, pemeriksaan, serta log. Ikuti instruksi yang cocok dengan versi terpasang; perintah dan pengelolaan service dapat berubah.
Setelah memperbaiki satu penyebab, kirim satu pesan uji yang sederhana. Jika tetap diam, catat status service dan potongan log yang sudah disamarkan, lalu cari bantuan di kanal resmi. Jangan membagikan token, kata sandi, atau data pribadi untuk mempercepat diagnosis.
