Blog

Plugin untuk bot Telegram agen AI: pemasangan dan pemeriksaan

Markdown

Di mana plugin dipasang, apa bedanya dengan skill dan MCP, cara memuat ulang agen, dan cara memeriksa perintah melalui Telegram.

Baca artikel lengkap

Agen saya berjalan di server, dan saya memberinya perintah lewat Telegram: saya menulis di chat, agen membaca file, menjalankan tugas, lalu mengirimkan hasilnya kepada saya. Pada titik tertentu, Anda mencapai batas: bot dasar hanya bisa melakukan sedikit hal, dan Anda ingin bot meninjau kode, membuat commit ke GitHub, atau menyusun ringkasan terjadwal. Solusinya adalah plugin.

Orang mencari “cara memasang plugin di Telegram” tepat untuk hal ini. Mereka bukan sedang membicarakan toko stiker. Mereka ingin tahu cara memberi bot kemampuan baru. Berikut penjelasan langkah demi langkah: apa itu plugin, di mana plugin sebenarnya dipasang, cara memasangnya dalam lima menit, dan cara menghindari kode berbahaya masuk ke agen Anda. Uraian ini didasarkan pada dokumentasi resmi.

Informasi praktis tentang penggunaan Ailoot tersedia di dokumentasi.

Apa itu plugin agen AI, secara sederhana?

Poin utama

Plugin adalah kumpulan kemampuan siap pakai yang Anda tambahkan ke agen dengan satu perintah. Plugin mencakup skill, helper terpisah, tindakan otomatis, dan koneksi ke layanan eksternal. Pasang plugin, dan bot mendapatkan perintah baru yang sebelumnya tidak tersedia. Hapus plugin, dan perintah itu pun menghilang. Ibarat memasang aplikasi di ponsel, hanya saja aplikasinya dipasang pada agen AI Anda.

Mari kita uraikan. Agen AI pada dasarnya dapat melakukan hal-hal dasar: membaca file, menulis kode, dan menjawab pertanyaan. Plugin adalah folder berisi kemampuan tambahan yang dikenali dan mulai digunakan oleh agen. Dokumentasi resmi Claude Code menjelaskan plugin persis seperti ini: plugin memperluas kemampuan agen dengan skill, agen helper terpisah, tindakan otomatis, dan koneksi ke layanan eksternal.

Berikut contoh sederhana. Pasang plugin untuk bekerja dengan GitHub, dan agen mendapatkan perintah untuk membuat commit, membuka pull request, dan meninjau riwayat perubahan. Pasang plugin peninjauan, dan agen memeriksa kode Anda untuk mencari kesalahan dan celah keamanan menggunakan daftar periksa yang sudah ditentukan. Anda tidak perlu mengatur semua ini sendiri: pembuat plugin telah menyusunnya, dan Anda tinggal menghubungkannya.

Satu hal penting lagi: plugin tidak mengajari agen sesuatu “selamanya.” Plugin adalah modul yang bisa dilepas. Hubungkan hari ini, putuskan besok, dan bot kembali ke kumpulan kemampuan yang dimilikinya sebelum plugin dipasang. Karena itu, plugin mudah dicoba: pilih satu, jalankan untuk tugas nyata, dan jika tidak cocok, hapus tanpa meninggalkan jejak.

Apa bedanya plugin dengan skill, MCP, dan subagen?

Poin utama

Skill adalah satu kemampuan, agen helper terpisah menangani subtugas yang lebih besar, dan koneksi ke layanan eksternal memberi bot akses ke program lain. Plugin adalah paket yang berisi semua ini, beserta file deskripsi. Pasang satu paket dan dapatkan seluruh rangkaian kemampuan sekaligus, alih-alih menyusunnya satu per satu.

Istilah seputar agen bisa membingungkan, jadi saya merangkum perbedaannya dalam tabel. Tabel ini juga menjawab separuh pertanyaan yang biasanya diajukan para pemula.

Apa ituFungsinyaCara memasangnya
SkillSatu kemampuan spesifik: “buat commit dengan gaya kami”Letakkan file instruksi di folder agen
Agen helperMenangani subtugas yang lebih besar dalam percakapan terpisah tanpa menghabiskan konteks AndaJelaskan di file terpisah
Tindakan otomatisTerpicu otomatis saat terjadi suatu peristiwa: sebelum menyimpan, setelah responsTambahkan aturan di pengaturan
Koneksi layanan (MCP)Memberi bot akses ke program eksternal: GitHub, basis data, browserAtur alamat dan kunci akses
PluginPaket berisi semua hal ini, yang telah disusun dan dikemasSatu perintah instalasi

Di dunia Claude Code, koneksi ke layanan eksternal disebut MCP. Ini adalah standar yang memungkinkan agen mengakses GitHub, basis data, atau browser. Empat baris pertama dalam tabel adalah komponen terpisah.

Perhatikan baris terakhir. Plugin berada satu tingkat di atas empat komponen lainnya. Plugin menyatukan skill, helper, tindakan otomatis, dan MCP dalam satu paket. Pembuatnya telah menyusun semuanya, menambahkan file deskripsi, lalu menerbitkannya. Dengan satu perintah, Anda mendapatkan paket siap pakai, alih-alih menyusun empat bagian secara terpisah.

Dengan begitu, Anda punya aturan sederhana untuk memilih. Jika tugas Anda hanya membutuhkan satu kemampuan kecil, buat sendiri skill-nya; hanya perlu lima belas menit. Jika Anda membutuhkan paket siap pakai dari orang-orang yang sudah memecahkan masalah Anda, gunakan plugin. Saya punya panduan terpisah tentang cara memilih skill untuk Claude Code, termasuk cara agar agen Anda tidak dibebani terlalu banyak skill.

Apa maksud “memasang plugin di Telegram”, dan apa hubungannya dengan Telegram?

Poin utama

Plugin dipasang pada agen yang merespons Anda melalui Telegram, bukan di Telegram. Messenger hanya menjadi kendali jarak jauh: Anda menggunakannya untuk memberi perintah kepada bot, sementara agen berjalan di komputer atau server. Jadi, “memasang plugin di Telegram” sebenarnya berarti “memasang plugin pada agen dan tetap mengendalikannya lewat chat.”

Di sinilah kebingungan umum muncul. Telegram sendiri tidak memiliki plugin: messenger tidak menyimpan kemampuan bot. Telegram meneruskan pesan Anda kepada agen dan menampilkan balasannya. Otaknya berada di tempat lain—di laptop Anda atau di server yang menjalankan agen seperti Hermes Agent, OpenClaw, atau Claude Code yang terhubung ke chat.

Ada dua cara untuk memasang plugin, dan keduanya bisa digunakan:

  1. Langsung dari chat. Kirim permintaan dengan bahasa biasa kepada agen di Telegram: “pasang plugin GitHub untuk Anda sendiri.” Agen memasangnya di mesin sendiri, lalu membalas bahwa plugin siap digunakan. Cara ini praktis saat server berada jauh dan Anda menggunakan ponsel.
  2. Lewat terminal. Masuk ke mesin tempat agen berjalan, lalu pasang plugin di sana dengan perintah. Cara ini lebih andal untuk pertama kali: Anda bisa melihat semua keluarannya dan tidak akan melewatkan apa pun.

Metode yang dipilih bergantung pada apakah Anda percaya bot untuk memasang ekstensi sendiri tanpa pengawasan. Saya memasang plugin pertama secara manual lewat terminal agar dapat melihat dengan tepat apa yang dihubungkan. Setelah terbiasa, saya mulai mempercayakan pemasangannya kepada agen langsung dari chat. Berikut saya tunjukkan kedua cara tersebut.

Bagaimana cara memasang plugin pada agen dalam lima menit?

Poin utama

Pertama, hubungkan marketplace plugin, lalu pasang plugin yang diinginkan berdasarkan namanya, kemudian muat ulang agen agar mengenali plugin baru. Di Claude Code, prosesnya memerlukan tiga perintah: tambahkan marketplace, pasang plugin, dan muat ulang plugin. Hermes Agent dan OpenClaw mengikuti logika yang sama, dengan nama perintah berbeda.

Saya akan menunjukkan Claude Code karena prosesnya dijelaskan secara terperinci dalam dokumentasinya dan mudah diikuti. Perintahnya sama, baik di terminal maupun saat Anda mengirimkannya kepada agen lewat Telegram.

  1. Buka daftar plugin. Perintah /plugin membuka panel langsung di terminal, dengan tab yang menampilkan semua ekstensi yang tersedia serta direktori di claude.com/plugins. Ini adalah etalase tempat Anda bisa melihat-lihat sebelum memasang.
  2. Hubungkan marketplace resmi. Masukkan /plugin marketplace add anthropics/claude-plugins-official. Marketplace adalah direktori tempat agen mengunduh plugin. Marketplace resmi dikelola oleh Anthropic.
  3. Pasang plugin yang dibutuhkan. Gunakan nama plugin, diikuti nama marketplace yang dipisahkan dengan tanda at:
/plugin install github@claude-plugins-official
  1. Muat ulang plugin. Jika setelah pemasangan bot mengatakan “Run /reload-plugins to activate.”, jalankan /reload-plugins. Sebelum dimuat ulang, perintah baru tidak akan muncul dalam percakapan yang sedang berlangsung. Jika Anda mendapat peringatan bahwa pemuatan ulang akan membaca ulang percakapan, ulangi perintah sebagai /reload-plugins --force.

Selesai. Kini agen memiliki perintah dari plugin tersebut. Di Claude Code, perintah menggunakan nama plugin sebagai awalan, misalnya /commit-commands:commit, sehingga Anda bisa langsung melihat bahwa perintah itu berasal dari plugin.

Saat Anda mengirim perintah kepada bot lewat Telegram alih-alih menggunakan terminal, Claude Code juga menyediakan perintah instalasi mandiri tanpa panel interaktif: claude plugin install. Dokumentasi mencatat satu detail: perintah ini tidak memuat plugin ke percakapan yang sudah terbuka. Agen akan mengenali plugin saat peluncuran berikutnya atau setelah /reload-plugins. Dengan kata lain, setelah memasang, Anda perlu memulai ulang bot atau memuat ulang plugin agar perintah baru tersedia.

Di Hermes Agent, ekstensi diaktifkan dan dinonaktifkan dengan perintah hermes tools, sementara skill berada di foldernya sendiri. OpenClaw bekerja dengan cara serupa: hubungkan satu paket, lalu mulai ulang bot. Nama perintahnya berbeda, tetapi urutannya sama: hubungkan sumber, pasang berdasarkan nama, lalu mulai ulang agen.

Plugin adalah salah satu komponen rekayasa konteks: Anda menentukan kemampuan apa yang tersedia bagi agen sebelum permintaan pertama.

Dari mana mendapatkan plugin, dan mana yang bisa dipercaya?

Poin utama

Ada tiga sumber dengan tingkat keandalan berbeda: marketplace resmi Anthropic, marketplace komunitas yang telah diperiksa, dan direktori pihak ketiga mana pun di GitHub. Vendor sendiri mengelola yang pertama; plugin di marketplace kedua telah lolos pemeriksaan otomatis dan dikunci ke versi tertentu; penggunaan sumber ketiga menjadi tanggung jawab Anda. Semakin jauh dari sumber resmi, semakin cermat Anda perlu memeriksa isinya.

Plugin adalah kode milik orang lain, dan plugin mendapat izin yang sama dengan agen Anda: akses ke file, terminal, dan layanan. Karena itu, sumbernya lebih penting daripada deskripsi yang menarik. Berikut sumbernya, dari yang paling andal hingga yang paling meragukan.

SumberPihak yang bertanggung jawabCara menghubungkannya
Marketplace resmiAnthropic mengelola direktorinya sendiri/plugin marketplace add anthropics/claude-plugins-official
Marketplace komunitasPlugin pihak ketiga telah lolos pemeriksaan otomatis, dan masing-masing dikunci ke suatu versi/plugin marketplace add anthropics/claude-plugins-community
Contoh vendorAnthropic, plugin contoh/plugin marketplace add anthropics/claude-code
Direktori pihak ketigaPembuatnya di GitHub; tidak ada yang memeriksanyaGunakan alamat repositori, dengan risiko Anda sendiri

Untuk memasang dari marketplace komunitas, gunakan perintah serupa dengan marketplace berbeda: /plugin install plugin-name@claude-community. Dokumentasi secara khusus menyebut bahwa plugin ini telah lolos pemeriksaan keamanan otomatis dan masing-masing dikunci ke versi kode tertentu. Artinya, Anda mendapatkan versi yang persis sama dengan yang telah diperiksa, tanpa perubahan susulan dari pembuatnya.

Sebelum pemasangan, Claude Code menampilkan bagian “Will install”: daftar perintah, helper, skill, tindakan otomatis, dan koneksi yang akan ditambahkan oleh plugin. Bacalah. Di sinilah Anda bisa melihat, misalnya, ekstensi catatan yang meminta akses terminal tanpa alasan jelas. Dokumentasi resmi menyampaikan aturannya dengan tegas:

Pastikan Anda memercayai suatu plugin sebelum memasangnya. Anthropic tidak mengendalikan koneksi, file, atau kode lain yang disertakan dalam plugin dan tidak dapat menjamin bahwa plugin akan berfungsi sesuai harapan. Tinjau halaman setiap plugin.

— Dokumentasi Claude Code, https://docs.claude.com/en/docs/claude-code/discover-plugins

Sederhananya: marketplace resmi dan yang telah diperiksa memberi Anda ketenangan; gunakan repositori GitHub sembarang hanya setelah membaca isinya dan memahami alasan plugin membutuhkan izin yang dimintanya. Kepercayaan terhadap kode pihak ketiga tidak hanya menyangkut pemasangan plugin, dan saya membahasnya dalam artikel tentang keamanan vibe-coding.

Bagaimana cara memeriksa apakah plugin sudah terpasang dan berfungsi di Telegram?

Poin utama

Minta agen menampilkan daftar perintahnya atau buka panel plugin. Jika perintah dari plugin ada dalam daftar, artinya plugin telah terhubung. Selanjutnya, berikan tugas uji kecil langsung di chat dan lihat apakah bot menanganinya dengan kemampuan barunya. Jika tidak ada yang muncul, Anda mungkin lupa memuat ulang plugin atau menghubungkan marketplace yang salah.

Luangkan waktu sebentar untuk memeriksanya: pesan “installed” belum berarti bot benar-benar telah mengenali plugin. Ikuti langkah berikut:

  1. Periksa daftarnya. Buka kembali panel /plugin atau minta agen menampilkan perintah yang tersedia. Perintah dari plugin baru seharusnya muncul dalam daftar, dengan nama plugin sebagai awalan di Claude Code.
  2. Berikan tugas uji. Pilih sesuatu yang aman, bukan tugas langsung. Jika Anda memasang plugin GitHub, minta agen menampilkan commit terbaru. Jika Anda memasang plugin peninjauan, berikan sebuah file kecil. Perhatikan satu hal: apakah bot menangani tugas tersebut dengan kemampuan barunya?
  3. Periksa dari chat yang sama dengan yang Anda gunakan untuk bekerja. Jika Anda mengendalikan agen lewat Telegram, kirim perintah uji melalui Telegram. Terkadang plugin terlihat di terminal, tetapi bot di chat belum memuat ulang plugin tersebut.

Alasan paling umum plugin sudah terpasang tetapi perintahnya tidak berfungsi adalah karena Anda lupa memuat ulang. Perintah pemasangan berhasil, tetapi agen dalam percakapan yang terbuka masih menggunakan kemampuan lamanya. /reload-plugins dapat membantu; jika tidak berhasil, mulai ulang bot sepenuhnya. Alasan kedua adalah memasang dari marketplace lain: nama pluginnya cocok, tetapi direktorinya salah, sehingga agen dengan tepat mengatakan bahwa plugin tidak ada dalam marketplace yang terhubung.

Jika bot membalas di chat tetapi tidak memahami perintah baru, bukan berarti agennya rusak atau Anda melakukan kesalahan. Hampir selalu penyebabnya salah satu dari dua hal: plugin belum dimuat ulang, atau marketplace yang dihubungkan salah. Keduanya bisa diperbaiki dalam satu menit.

Bagaimana cara memperbarui dan menghapus plugin agar agen tetap rapi?

Poin utama

Perbarui marketplace dengan satu perintah; setelah itu, versi plugin terbaru akan tersedia. Menghapus plugin sama mudahnya dengan memasangnya: gunakan panel yang sama. Hubungkan hanya plugin yang benar-benar Anda gunakan: setiap plugin tambahan menambah perintah untuk bot dan memenuhi konteksnya.

Ada detail tentang pembaruan yang mungkin tidak langsung terpikirkan. Saat pembuat plugin merilis versi baru, versi itu tidak langsung tersedia. Pertama, perbarui direktori marketplace dengan /plugin marketplace update, lalu pasang versi terbaru. Sebelum marketplace diperbarui, agen menganggap versi yang diunduh terakhir kali sebagai versi terkini. Ini disengaja: perubahan dari orang lain tidak akan disisipkan begitu saja tanpa sepengetahuan Anda.

Hapus plugin melalui panel /plugin yang sama dengan yang Anda gunakan untuk memasangnya: temukan plugin di daftar yang terpasang, lalu hapus. Plugin tidak meninggalkan jejak pada agen, dan perintahnya menghilang setelah Anda memuat ulang. Inilah sebabnya Anda tidak perlu takut bereksperimen dengan plugin: pasang beberapa, pertahankan dua yang berfungsi, lalu hapus sisanya.

Jaga juga agar semuanya tetap rapi. Setiap plugin yang terhubung menambah perintah yang harus diingat agen dan menggunakan sebagian jendela konteksnya untuk deskripsi. Lima plugin yang tidak Anda gunakan akan memperlambat bot dan membingungkannya tanpa alasan. Aturannya sederhana: jika sebuah plugin tidak berguna selama dua minggu, hapus. Anda bisa memasangnya kembali dengan satu perintah.

Plugin mana yang akan saya pasang lebih dulu?

Poin utama

Mulailah dengan tiga bidang: bekerja dengan GitHub, peninjauan kode, dan commit dengan gaya yang konsisten. Hampir semua orang yang membangun proyek dan mengelola agen lewat chat membutuhkan hal-hal ini. Tambahkan sisanya untuk tugas tertentu. Anda tidak perlu memasang plugin sebelumnya: plugin yang tidak digunakan hanya memperlambat bot.

Saya tidak akan memberi Anda daftar 100 teratas—ini layak mendapat panduan tersendiri, dan saya sudah punya artikel 10 plugin Claude Code teratas. Berikut tiga bidang yang saya rekomendasikan untuk pemula yang mengelola agen lewat Telegram.

  1. Bekerja dengan GitHub. Plugin yang memberi agen perintah untuk commit, branch, dan pull request. Tulis kepada bot di chat, “simpan pekerjaan dan dorong ke repositori,” lalu bot akan melakukannya. Ini menghilangkan kekhawatiran utama bagi orang yang melakukan vibe-coding tanpa pengalaman: takut kehilangan kode.
  2. Peninjauan kode. Plugin dengan daftar periksa untuk menemukan kesalahan, celah keamanan, dan titik lemah. Plugin ini sangat berguna dengan Telegram: kirim potongan kode lewat chat dan dapatkan tinjauan tanpa membuka editor.
  3. Commit dengan gaya konsisten. Plugin kecil yang membuat agen memformat commit sesuai satu templat. Kelihatannya sepele, tetapi setelah sebulan riwayat proyek terlihat rapi seperti milik sebuah tim, alih-alih menjadi berantakan.

Selanjutnya, pilih plugin untuk tugas tertentu. Bekerja dengan basis data? Gunakan plugin basis data. Menyusun ringkasan? Gunakan plugin penjadwalan. Aturan umumnya tetap sama: mulai dari tugas, lalu cari plugin yang sesuai. Memasang plugin sebelumnya “untuk berjaga-jaga” adalah cara pasti untuk membanjiri bot dengan perintah yang tidak pernah Anda gunakan.

Apa lagi yang ditanyakan orang tentang plugin pada agen Telegram?

Poin utama

Jawaban singkat untuk pertanyaan umum: kebanyakan plugin gratis, berfungsi dengan bot cloud maupun lokal, dan “plugin Telegram” dari toko stiker berbeda dengan ekstensi agen AI. Anda bisa melihat izin berbahaya sebelum pemasangan dan membatalkan pemasangan dalam satu menit.

Pertanyaan yang sering diajukan

Apakah plugin agen berbayar?

Plugin di marketplace resmi dan komunitas gratis: plugin tersebut bersifat sumber terbuka dan tidak ada biaya untuk menghubungkannya. Model yang terhubung ke agen mungkin berbayar, begitu pula layanan eksternal yang digunakan plugin. Namun, Anda tidak perlu membayar hanya untuk memasang plugin.

Bisakah saya memasang plugin jika bot berjalan di server?

Ya, dan inilah kasus yang paling umum. Pasang plugin dengan perintah yang sama, baik dengan masuk ke terminal server maupun dengan memberikan perintah kepada agen langsung lewat Telegram jika Anda percaya agen untuk memasangnya tanpa pengawasan. Setelah pemasangan, Anda perlu memulai ulang bot atau menyuruhnya memuat ulang plugin, kalau tidak bot tidak akan mengenali kemampuan baru tersebut.

Apa bedanya plugin agen AI dengan plugin Telegram?

Keduanya adalah hal yang berbeda, tetapi orang sering bingung karena sama-sama menggunakan kata “plugin.” Telegram sendiri tidak memiliki ekstensi bot: messenger hanya meneruskan pesan. Plugin dipasang pada agen AI yang merespons Anda lewat Telegram, sementara agennya berjalan di komputer atau server. Plugin itu tidak berada di dalam messenger.

Bagaimana cara mengetahui apakah plugin dapat dipercaya?

Periksa sumber dan daftar izinnya. Vendor mengelola marketplace resmi, sedangkan plugin komunitas telah lolos pemeriksaan otomatis dan dikunci ke suatu versi. Sebelum pemasangan, agen menunjukkan dengan tepat apa yang akan ditambahkan plugin: jika ekstensi catatan meminta akses terminal, itu alasan untuk berhati-hati dan tidak memasangnya.

Apa yang harus saya lakukan jika plugin tidak berfungsi setelah dipasang?

Hampir selalu, penyebabnya salah satu dari dua hal: Anda tidak memuat ulang plugin setelah pemasangan, atau menghubungkan marketplace yang salah. Minta agen untuk memuat ulang plugin, dan jika itu tidak membantu, mulai ulang bot sepenuhnya. Periksa lewat chat yang sama dengan yang Anda gunakan untuk bekerja: plugin mungkin terlihat di terminal, sementara bot di Telegram belum mengenalinya.

Kunjungi Ailoot.

Rincian selengkapnya

Pertanyaan tentang Plugin untuk bot Telegram agen AI: pemasangan dan pemeriksaan

Mengapa plugin yang terpasang belum bekerja melalui Telegram?

Agen yang sedang berjalan mungkin belum memuatnya. Muat ulang plugin atau mulai ulang bot, lalu periksa perintah dan jalankan uji yang tidak berbahaya dari chat Telegram yang sama; keluaran instalasi saja tidak membuktikan sesi aktif memuatnya.

Di mana plugin dipasang jika bot berjalan pada server?

Pasang pada agen di mesin yang menjalankan bot. Telegram meneruskan pesan dan menampilkan balasan; Telegram tidak menyimpan ekstensi agen. Verifikasi sumber dan hal yang ditambahkan plugin sebelum memasangnya di sana.

Semua artikel