Tutorial Lengkap Membangun AI Agent Telegram: Dari Nol hingga Bisa Apa Saja

Panduan Langkah demi Langkah Membangun AI Agent yang Terhubung ke Telegram, Dapat Mengakses Terminal, Browser, File System, dan Bekerja 24/7 — Semuanya dengan Biaya $0

Artikel ini akan memandu Anda membangun AI Agent yang terhubung ke Telegram — sebuah asisten AI yang dapat Anda kirimi pesan dan yang akan merespons dengan melakukan tindakan nyata: menjalankan perintah shell, browsing website, mengelola file, menjadwalkan tugas, dan banyak lagi.

Semua langkah dalam artikel ini telah diuji dan diverifikasi pada Hermes Agent v0.14.0 (Mei 2026). Dokumentasi resmi tersedia di https://hermes-agent.nousresearch.com/docs/

Apa yang Akan Kita Bangun?

Setelah mengikuti tutorial ini, Anda akan memiliki:

• Sebuah AI Agent yang berjalan 24/7 di server Anda
• Terhubung ke Telegram — Anda cukup mengirim pesan untuk memberikan perintah
• Dapat mengakses terminal (menjalankan perintah shell)
• Dapat browsing website dan mengambil informasi
• Dapat membaca, menulis, dan mengedit file
• Dapat menjadwalkan tugas (cron jobs)
• Dapat mengingat informasi antar sesi (persistent memory)
• Menggunakan AI model gratis (Google Gemini, Groq, OpenRouter)

Total biaya: $0 (untuk software; server bisa menggunakan free tier)

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Server Linux (Ubuntu 20.04+) — bisa VPS, Raspberry Pi, atau WSL di Windows
2. Python 3.11+ terinstall
3. Akun Telegram untuk menerima pesan dari bot
4. Akun Google untuk mendapatkan API key AI gratis (Gemini)

Langkah 1: Install Hermes Agent

Hermes Agent adalah framework open source oleh Nous Research untuk membangun AI Agent. Install dengan satu perintah:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Script install akan:

• Mengunduh Hermes Agent ke /usr/local/lib/hermes-agent/
• Membuat virtual environment Python
• Menginstall semua dependencies
• Membuat command hermes yang bisa dijalankan dari mana saja

Setelah install selesai, verifikasi:

hermes --version
# Output: Hermes Agent v0.14.0 (2026.5.16) atau lebih baru

Jika hermes tidak ditemukan, tambahkan ke PATH:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Langkah 2: Setup AI Model Provider

Anda membutuhkan AI model untuk "otak" agent. Berikut opsi 100% gratis:

Opsi 1: Google Gemini (Rekomendasi)

1. Buka https://aistudio.google.com/apikey
2. Login dengan akun Google
3. Klik "Create API Key"
4. Salin API key yang dihasilkan

Gratis tanpa kartu kredit. Free tier: 15 request per menit — lebih dari cukup untuk penggunaan pribadi.

Opsi 2: Groq (Inference Tercepat)

1. Buka https://console.groq.com
2. Buat akun (gratis)
3. Buat API key di menu API Keys

Gratis. Groq menjalankan model open source (Llama 3.3, Mixtral) dengan kecepatan sangat tinggi.

Opsi 3: OpenRouter (Akses 400+ Model)

1. Buka https://openrouter.ai
2. Buat akun (gratis)
3. Buat API key di menu Keys

Gratis untuk model dengan label :free (Qwen, DeepSeek, Llama, dll).

Konfigurasi Model

Jalankan setup wizard interaktif:

hermes setup

Atau konfigurasi manual:

# Untuk Google Gemini:
hermes config set model.provider google
hermes config set model.default gemini-2.0-flash

# Untuk Groq:
hermes config set model.provider groq
hermes config set model.default llama-3.3-70b-versatile

# Untuk OpenRouter:
hermes config set model.provider openrouter
hermes config set model.default qwen/qwen3-coder:free

Atau gunakan pemilih interaktif:

hermes model

Langkah 3: Membuat Telegram Bot

3.1 Buat Bot via @botfather

1. Buka Telegram, cari @botfather (bot resmi Telegram untuk membuat bot)
2. Kirim perintah: /newbot
3. BotFather akan menanyakan:
   • Nama bot: Misal "My AI Agent"
   • Username bot: Harus diakhiri dengan bot, misal my_ai_agent_bot
4. BotFather akan memberikan Bot Token — salin dan simpan token ini

Contoh token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3.2 Dapatkan Chat ID Anda

Agent perlu tahu siapa yang boleh mengirim pesan. Untuk mendapatkan Chat ID Anda:

1. Kirim pesan apa saja ke bot yang baru dibuat
2. Buka browser, akses: https://api.telegram.org/bot<TOKEN_ANDA>/getUpdates (ganti <TOKEN_ANDA> dengan token dari BotFather)
3. Cari nilai "id" di bagian "chat" — itu adalah Chat ID Anda

Contoh: jika Chat ID Anda adalah 123456789, simpan nomor ini.

Langkah 4: Konfigurasi Telegram di Hermes

4.1 Edit File Environment

Buka file environment Hermes:

nano ~/.hermes/.env

Tambahkan baris berikut (ganti dengan nilai Anda):

# Telegram Bot Token dari @BotFather
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

# Chat ID Anda (hanya Anda yang bisa berinteraksi dengan bot)
TELEGRAM_ALLOWED_USERS=123456789

# Channel default untuk cron job delivery (opsional)
TELEGRAM_HOME_CHANNEL=123456789

Penjelasan:

• TELEGRAM_BOT_TOKEN — Token dari @botfather
• TELEGRAM_ALLOWED_USERS — Chat ID yang diizinkan berinteraksi (keamanan)
• TELEGRAM_HOME_CHANNEL — Chat ID default untuk mengirim notifikasi otomatis

Simpan file (Ctrl+X, Y, Enter jika menggunakan nano).

4.2 Konfigurasi Gateway

Jalankan setup gateway interaktif:

hermes gateway setup

Wizard ini akan memandu Anda mengkonfigurasi platform Telegram (dan platform lain jika diperlukan).

Langkah 5: Menjalankan AI Agent

5.1 Test Mode (Foreground)

Jalankan gateway di foreground untuk testing:

hermes gateway run

Anda akan melihat log seperti:

[Hermes Gateway] Starting...
[Hermes Gateway] Telegram connected
[Hermes Gateway] Listening for messages...

Buka Telegram, kirim pesan ke bot Anda. Agent akan merespons!

Untuk menghentikan: Tekan Ctrl+C

5.2 Production Mode (Background Service)

Untuk menjalankan agent 24/7, install sebagai systemd service:

# Install service
sudo hermes gateway install

# Start service
sudo hermes gateway start

# Cek status
hermes gateway status

Service akan otomatis start saat server boot. Untuk mengelola:

# Restart service
sudo hermes gateway restart

# Stop service
sudo hermes gateway stop

# Lihat log
hermes logs

Langkah 6: Menggunakan AI Agent

Sekarang agent Anda sudah berjalan dan terhubung ke Telegram. Berikut cara menggunakannya:

6.1 Perintah Dasar

Kirim pesan ke bot di Telegram:

Menjalankan perintah shell:

Cek penggunaan disk di server ini

Agent akan menjalankan df -h dan mengirimkan hasilnya.

Membuat file:

Buat file Python hello.py yang mencetak "Hello World" dan jalankan

Agent akan membuat file, lalu menjalankannya.

Mencari informasi di web:

Cari berita terbaru tentang AI di Indonesia

Agent akan melakukan web search dan merangkum hasilnya.

6.2 Perintah Lanjutan

Menjadwalkan tugas:

Ingatkan saya setiap hari jam 8 pagi untuk minum obat

Agent akan membuat cron job yang mengirim pesan setiap jam 8 pagi.

Mengelola project:

Clone repository https://github.com/user/repo dan jalankan test-nya

Agent akan clone repo, install dependencies, dan menjalankan test.

Menganalisis data:

Baca file data.csv dan buat grafik penjualan per bulan

Agent akan membaca file, menganalisis data, dan membuat visualisasi.

6.3 Slash Commands (Perintah Khusus)

Selama chat, Anda bisa menggunakan perintah khusus:

• /new — Mulai sesi baru
• /model — Lihat atau ganti AI model
• /skills — Cari dan install skill baru
• /cron — Kelola scheduled tasks
• /tools — Lihat tools yang tersedia
• /help — Lihat semua perintah

Langkah 7: Fitur Lanjutan

7.1 Memory (Ingatan Persisten)

Agent mengingat informasi antar sesi. Anda bisa menyimpan preferensi:

Ingat: saya lebih suka kode Python, gunakan type hints, dan format black

Agent akan menyimpan ini dan menyesuaikan perilakunya di sesi berikutnya.

7.2 Skills (Keahlian yang Dipelajari)

Agent dapat mempelajari prosedur baru dan menyimpannya:

Simpan cara deploy ke Railway sebagai skill

Agent akan menyimpan prosedur tersebut dan menggunakannya kembali saat diperlukan.

7.3 Multi-Model (Fallback)

Jika model utama rate-limited, agent otomatis beralih ke model cadangan:

# Tambah fallback provider
hermes config set fallback_providers '["openrouter", "google", "groq"]'

7.4 Delegation (Sub-Agent)

Untuk tugas kompleks, agent dapat mendelegasikan ke sub-agent:

Riset 5 framework web Python terpopuler dan buat perbandingan lengkap

Agent akan spawn sub-agent untuk riset, lalu merangkum hasilnya.

Troubleshooting

Bot tidak merespons di Telegram

1. Cek gateway berjalan: hermes gateway status
2. Cek log error: hermes logs
3. Pastikan TELEGRAM_BOT_TOKEN benar di ~/.hermes/.env
4. Pastikan TELEGRAM_ALLOWED_USERS mencakup Chat ID Anda

"Model not found" atau error API

1. Cek API key: hermes config check
2. Ganti model: hermes model
3. Jalankan doctor: hermes doctor

Gateway mati setelah SSH logout

# Enable linger agar service tetap jalan
sudo loginctl enable-linger $USER

# Atau install sebagai system service
sudo hermes gateway install
sudo hermes gateway start

Rate limit exceeded

Gunakan fallback provider:

hermes fallback add openrouter
hermes fallback add google
hermes fallback add groq

Agent otomatis beralih ke provider cadangan saat rate-limited.

Arsitektur Sistem

Berikut gambaran bagaimana seluruh sistem bekerja:

Anda (Telegram) ──────► Telegram Server ──────► Hermes Gateway
                                                    │
                                                    ▼
                                             AI Agent Core
                                           ┌────────────────┐
                                           │  LLM (Gemini/  │
                                           │  Groq/OpenRouter)│
                                           └───────┬────────┘
                                                   │
                    ┌──────────────────────────────┼──────────────────┐
                    ▼              ▼               ▼                  ▼
               Terminal      Browser         File System         Memory
            (shell cmd)    (web browse)    (read/write/edit)   (persistent)

1. Anda mengirim pesan di Telegram
2. Telegram meneruskan ke Hermes Gateway
3. Gateway mengirim ke AI Agent Core (LLM)
4. LLM memutuskan tools apa yang akan digunakan
5. Agent mengeksekusi tools (terminal, browser, file, dll)
6. Hasil dikirim kembali ke Anda di Telegram

Ringkasan Langkah

Total waktu setup: ~15 menit

Perbandingan dengan Solusi Lain

Dokumentasi dan Sumber

• Dokumentasi resmi: https://hermes-agent.nousresearch.com/docs/
• GitHub: https://github.com/NousResearch/hermes-agent
• Discord komunitas: Tersedia di dokumentasi
• Telegram BotFather: https://t.me/BotFather

Kesimpulan

Dalam 15 menit, Anda dapat memiliki AI Agent yang:

✅ Terhubung ke Telegram dan merespons pesan Anda
✅ Menjalankan perintah shell dan mengelola server
✅ Browsing web dan mengambil informasi
✅ Mengelola file dan project
✅ Menjadwalkan tugas otomatis
✅ Mengingat konteks antar sesi
✅ Bekerja 24/7 tanpa intervensi
✅ Biaya $0 untuk software

AI Agent ini bukan sekadar chatbot — ia adalah asisten digital yang benar-benar dapat melakukan tindakan nyata. Dari mengelola server hingga mencari informasi, dari menulis kode hingga menganalisis data — semuanya bisa dilakukan melalui percakapan sederhana di Telegram.

Mulai hari ini. Install Hermes, hubungkan ke Telegram, dan biarkan AI Agent bekerja untuk Anda.

Tentang Penulis:
Rakha — mahasiswa Teknik Informatika semester 6 di UNSIQ Wonosobo. Menjalankan AI Agent (ZKA) yang terhubung ke Telegram dan bekerja 24/7. Terhubung melalui GitHub atau Dev.to.

Tutorial ini telah diuji pada Hermes Agent v0.14.0 (Mei 2026). Untuk versi terbaru, kunjungi dokumentasi resmi.