Vtičniki za Telegramovega bota z umetno inteligenco: namestitev in preverjanje

Moj agent deluje na strežniku, ukaze pa mu dajem prek Telegrama: v klepet napišem sporočilo, agent prebere datoteke, opravi naloge in mi pošlje rezultat. Čez čas naletiš na omejitve: osnovni bot zmore zelo malo, ti pa želiš, da pregleda kodo, ustvari objavo v GitHubu ali pripravi načrtovani povzetek. Rešitev so vtičniki.

Ljudje iščejo »kako namestiti vtičnik v Telegramu« prav zaradi tega. Ne govorijo o trgovini z nalepkami. Želijo vedeti, kako botu dodati nove zmogljivosti. V nadaljevanju je vse po korakih: kaj je vtičnik, kam ga dejansko namestiti, kako ga namestiti v petih minutah in kako preprečiti, da bi v agent prišla zlonamerna koda. Ta opis temelji na uradni dokumentaciji.

Praktične informacije o uporabi Ailoota najdete v dokumentaciji.

Kaj je vtičnik za agenta z umetno inteligenco, preprosto povedano?#

Poglejmo podrobneje. Agent z umetno inteligenco že ob namestitvi zmore osnovna opravila: bere datoteke, piše kodo in odgovarja na vprašanja. Vtičnik je mapa z dodatnimi zmogljivostmi, ki jih agent prevzame in začne uporabljati. Uradna dokumentacija Claude Code vtičnik opisuje prav tako: agentu doda veščine, ločene pomožne agente, avtomatizirana dejanja in povezave z zunanjimi storitvami.

Preprost primer: namesti vtičnik za delo z GitHubom in agent bo dobil ukaze za ustvarjanje objave, odpiranje pull requesta in pregled zgodovine sprememb. Namesti vtičnik za pregledovanje in agent bo po vnaprej določenem seznamu preverjal kodo za napake in varnostne pomanjkljivosti. Ničesar od tega ti ni bilo treba nastavljati ročno: avtor vtičnika je vse pripravil, ti pa si ga samo povezal.

Še ena pomembna stvar: vtičnik agenta ničesar ne nauči »za vedno«. Je odstranljiv modul. Danes ga povežeš, jutri odklopiš, bot pa se vrne k naboru zmogljivosti, ki jih je imel prej. Zato je vtičnike priročno preizkusiti: izberi enega, uporabi ga pri resnični nalogi in ga brez sledu odstrani, če ti ne ustreza.

Kako se vtičnik razlikuje od veščine, MCP in podagenta?#

Izrazi, povezani z agenti, so lahko zmedeni, zato sem razlike povzel v tabeli. Odgovarja tudi na polovico vprašanj, ki jih imajo začetniki.

V svetu Claude Code se povezava z zunanjo storitvijo imenuje MCP. To je standard, ki agentu omogoča dostop do GitHuba, podatkovne zbirke ali brskalnika. Prve štiri vrstice tabele predstavljajo ločene gradnike.

Poglej zadnjo vrstico. Vtičnik je eno raven nad drugimi štirimi gradniki. Združuje veščino, pomočnika, avtomatizirano dejanje in MCP v enem paketu. Avtor je vse pripravil, dodal datoteko z opisom in paket objavil. Z enim ukazom dobiš pripravljeno celoto, namesto da bi ločeno sestavljal štiri dele.

Tako lahko izbiraš po preprostem pravilu. Če za svojo nalogo potrebuješ eno manjšo zmogljivost, veščino napiši sam; vzelo ti bo petnajst minut. Če potrebuješ pripravljen nabor od ljudi, ki so tvoj problem že rešili, uporabi vtičnik. Napisal sem tudi ločen vodič o tem, kako izbrati veščine za Claude Code, vključno s tem, kako agenta ne preobremeniti z dodatnimi veščinami.

Kaj pomeni »namestiti vtičnik v Telegram« in kaj ima Telegram s tem?#

Tu pogosto pride do zmede. Telegram sam nima vtičnikov: sporočilnik ne shranjuje zmogljivosti bota. Tvoja sporočila posreduje agentu in prikaže njegove odgovore. Možgani so drugje — v tvojem prenosniku ali na strežniku, kjer deluje agent, kot so Hermes Agent, OpenClaw ali Claude Code, povezan s klepetom.

Vtičnik lahko namestiš na dva načina in oba delujeta:

1. Neposredno iz klepeta. Agenta v Telegramu zaprosi v običajnem jeziku: »namesti si vtičnik za GitHub«. Agent ga namesti na svoj računalnik in ti sporoči, da je pripravljen. To je priročno, ko je strežnik daleč, ti pa uporabljaš telefon.
2. V terminalu. Prijavi se v napravo, kjer deluje agent, in tam namesti vtičnik z ukazom. Prvič je to zanesljiveje: vidiš ves izpis in ničesar ne spregledaš.

Izbira metode je odvisna od tega, ali zaupaš botu, da sam namesti razširitve brez nadzora. Prve vtičnike sem namestil ročno v terminalu, da sem lahko natančno videl, kaj povezujem. Ko sem se navadil, sem agentu začel zaupati, da jih sam namesti iz klepeta. Spodaj ti pokažem oba načina.

Kako vtičnik namestiš v agenta v petih minutah?#

Pokazal ti bom Claude Code, ker je postopek v njegovi dokumentaciji opisan dobesedno in ga je preprosto ponoviti. Ukazi so enaki v terminalu in takrat, ko jih agentu pošlješ prek Telegrama.

1. Odpri seznam vtičnikov. Ukaz /plugin neposredno v terminalu odpre ploščo z zavihkom, na katerem so prikazane vse razpoložljive razširitve, ter katalog na claude.com/plugins. To je izložba, po kateri lahko brskaš pred namestitvijo.
2. Poveži uradno tržnico. Vnesi /plugin marketplace add anthropics/claude-plugins-official. Tržnica je katalog, iz katerega agent prenaša vtičnike. Uradno tržnico upravlja Anthropic.
3. Namesti potrebni vtičnik. Uporabi ime vtičnika, ki mu sledi ime tržnice, ločena z znakom at:

/plugin install github@claude-plugins-official

4. Znova naloži vtičnike. Če bot po namestitvi napiše “Run /reload-plugins to activate.”, zaženi /reload-plugins. Dokler vtičnikov ne naložiš znova, se novi ukazi ne bodo prikazali v trenutnem pogovoru. Če dobiš opozorilo, da bo ponovno nalaganje znova prebralo pogovor, ponovi ukaz kot /reload-plugins --force.

To je vse. Agent ima zdaj ukaze iz vtičnika. V Claude Code se ime vtičnika uporablja kot predpona ukaza, na primer /commit-commands:commit, zato takoj vidiš, da ukaz prihaja iz vtičnika.

Če botu namesto prek terminala pošlješ ukaz v Telegramu, ima Claude Code tudi samostojen ukaz za namestitev brez interaktivne plošče: claude plugin install. Dokumentacija opozarja na eno podrobnost: ta ukaz ne naloži vtičnika v že odprt pogovor. Agent ga bo prevzel ob naslednjem zagonu ali po ukazu /reload-plugins. Z drugimi besedami, po namestitvi moraš znova zagnati bota, sicer ne boš dobil novih ukazov.

V Hermes Agent se razširitve omogočajo in onemogočajo z ukazom hermes tools, veščine pa imajo svojo mapo. OpenClaw deluje podobno: poveži nabor in znova zaženi bota. Imena so različna, vrstni red pa enak: poveži vir, namesti po imenu in znova zaženi agenta.

Kje poiskati vtičnike in katerim lahko zaupaš?#

Vtičnik je koda nekoga drugega in ima enaka dovoljenja kot tvoj agent: dostop do datotek, terminala in storitev. Zato je vir pomembnejši od privlačnega opisa. Tukaj so viri, od najbolj zanesljivega do najbolj vprašljivega.

Za namestitev iz skupnostne tržnice uporabi podoben ukaz, vendar z drugo tržnico: /plugin install plugin-name@claude-community. Dokumentacija izrecno navaja, da so ti vtičniki prestali samodejno varnostno preverjanje in da je vsak pripet na določeno različico kode. To pomeni, da dobiš natančno tisto, kar je bilo preverjeno, brez poznejših sprememb, ki bi jih avtor neopazno dodal.

Pred namestitvijo Claude Code prikaže razdelek “Will install”: seznam ukazov, pomočnikov, veščin, avtomatiziranih dejanj in povezav, ki jih bo vtičnik dodal. Preberi ga. Tako lahko na primer opaziš, da razširitev za zapiske iz nekega razloga zahteva dostop do terminala. Uradna dokumentacija pravilo pove naravnost:

Preprosto povedano: uradna in preverjena tržnica ponujata več brezskrbnosti; naključni repozitorij GitHub uporabi šele, ko prebereš njegovo vsebino in razumeš, zakaj potrebuje zahtevana dovoljenja. Zaupanje kodi tretjih oseb sega dlje od nameščanja vtičnikov; o tem pišem v članku o varnosti vibe-codinga.

Kako preveriš, ali je vtičnik nameščen in deluje v Telegramu?#

Vzemi si minuto za preverjanje: sporočilo “installed” še ne pomeni, da je bot dejansko prevzel vtičnik. Sledi tem korakom:

1. Preveri seznam. Znova odpri ploščo /plugin ali prosi agenta, naj pokaže razpoložljive ukaze. Ukazi novega vtičnika bi morali biti na seznamu; v Claude Code jim kot predpona sledi ime vtičnika.
2. Dodeli mu preizkusno nalogo. Izberi nekaj varnega, ne naloge v živo. Če si namestil vtičnik za GitHub, ga prosi, naj pokaže zadnje objave. Če si namestil vtičnik za pregledovanje, mu daj manjšo datoteko. Pozoren bodi na eno stvar: ali se bot loti naloge z novo zmogljivostjo?
3. Preveri v istem klepetu, ki ga uporabljaš za delo. Če agenta upravljaš prek Telegrama, preizkusni ukaz pošlji v Telegramu. Včasih je vtičnik viden v terminalu, vendar ga bot v klepetu še ni znova naložil.

Najpogostejši razlog, da nameščeni vtičnik ne deluje, je preskočeno ponovno nalaganje. Ukaz za namestitev je uspel, agent v odprtem pogovoru pa še vedno uporablja stari nabor zmogljivosti. Pomaga /reload-plugins; če to ne deluje, bota v celoti znova zaženi. Drugi razlog je namestitev iz druge tržnice: ime vtičnika se ujema, imenik pa je napačen, zato agent pravilno sporoči, da vtičnika ni v povezanih tržnicah.

Če bot v klepetu odgovori, vendar ne razume novega ukaza, to ne pomeni, da je agent pokvarjen ali da si naredil kaj narobe. Skoraj vedno gre za eno od dveh stvari: vtičnikov ni znova naložil ali pa si povezal napačno tržnico. Oboje lahko popraviš v minuti.

Kako posodabljati in odstranjevati vtičnike, ne da bi z njimi zasul agenta?#

Pri posodobitvah je ena podrobnost, ki ni očitna. Ko avtor izda novo različico vtičnika, se ta ne pojavi sama od sebe. Najprej posodobi imenik tržnice z ukazom /plugin marketplace update in šele nato namesti najnovejšo različico. Dokler ne posodobiš tržnice, agent za trenutno šteje različico, ki jo je prenesel zadnjič. To je namerno: spremembe drugih ne bodo naknadno dodane brez tvoje vednosti.

Vtičnik odstrani prek iste plošče /plugin, s katero si ga namestil: poišči ga na seznamu nameščenih in ga odstrani. V agentu ne pusti sledi, ukazi pa izginejo takoj, ko znova naložiš vtičnike. Prav zato preizkušanje vtičnikov ni strašljivo: namesti jih več, obdrži dva, ki delujeta, ostale pa odstrani.

Poskrbi tudi za red. Vsak povezan vtičnik agentu doda ukaze, ki si jih mora zapomniti, njihovi opisi pa zasedejo del njegovega kontekstnega okna. Pet vtičnikov, ki jih ne uporabljaš, po nepotrebnem upočasnjuje in zmede bota. Pravilo je preprosto: če vtičnik dva tedna ni bil uporaben, ga odstrani. Z enim ukazom ga lahko znova namestiš.

Katere vtičnike bi namestil najprej?#

Ne bom ti dal seznama 100 najboljših — to si zasluži ločen vodič, že zdaj pa imam članek o 10 najboljših vtičnikih za Claude Code. Za začetnike, ki upravljajo agenta prek Telegrama, priporočam ta tri področja.

1. Delo z GitHubom. Vtičnik, ki agentu doda ukaze za objave, veje in pull requeste. Botu v klepet napiši: »shrani delo in ga pošlji v repozitorij«, pa bo to naredil. S tem se odpravi glavna skrb ljudi, ki se brez izkušenj ukvarjajo z vibe-codingom: strah, da bodo izgubili kodo.
2. Pregledovanje kode. Vtičnik s seznamom za preverjanje napak, varnostnih pomanjkljivosti in šibkih točk. V Telegramu je še posebej uporaben: pošlji del kode v klepet in prejmi pregled, ne da bi odprl urejevalnik.
3. Objave v enotnem slogu. Majhen vtičnik, ki poskrbi, da agent oblikuje objave po eni predlogi. Morda se zdi nepomemben, toda po enem mesecu je zgodovina projekta urejena kot pri ekipi, namesto da bi postala zmedena.

Nato izbiraj vtičnike za določene naloge. Delaš s podatkovno zbirko? Poišči vtičnik zanjo. Sestavljaš povzetke? Poišči vtičnik za načrtovanje. Splošno pravilo je enako: začni z nalogo in nato poišči vtičnik zanjo. Vnaprejšnje nameščanje vtičnikov »za vsak primer« je zanesljiv način, da bot zasuješ z ukazi, ki jih nikoli ne uporabljaš.

Kaj še ljudje sprašujejo o vtičnikih v Telegramovem agentu?#

Odpri Ailoot.