Pluginy pro Telegramového bota s AI agentem: instalace a ověření

Můj agent běží na serveru a já mu zadávám příkazy přes Telegram: píšu do chatu, on čte soubory, plní úkoly a posílá mi výsledek. V určité chvíli narazíte na limit: základní bot toho umí velmi málo a vy chcete, aby kontroloval kód, vytvářel commity na GitHubu nebo sestavoval pravidelný přehled. Řešením jsou pluginy.

Lidé hledají „jak nainstalovat plugin do Telegramu“ právě kvůli tomu. Nemluví o obchodě s nálepkami. Chtějí vědět, jak botovi přidat nové schopnosti. Níže si krok za krokem ukážeme, co je plugin, kde se skutečně instaluje, jak jej nainstalovat za pět minut a jak do agenta nezavléct škodlivý kód. Tento popis vychází z oficiální dokumentace.

Praktické informace o práci s Ailootem najdete v dokumentaci.

Co je plugin AI agenta, jednoduše řečeno?#

Pojďme si to rozebrat. AI agent toho po instalaci zvládá jen základ: číst soubory, psát kód a odpovídat na otázky. Plugin je složka dalších schopností, které agent načte a začne používat. Oficiální dokumentace Claude Code popisuje plugin přesně takto: rozšiřuje agenta o dovednosti, samostatné pomocné agenty, automatizované akce a propojení s externími službami.

Jednoduchý příklad: nainstalujete plugin pro práci s GitHubem a agent získá příkazy k vytvoření commitu, otevření pull requestu a kontrole historie změn. Nainstalujete plugin pro revize a agent bude podle předem stanoveného kontrolního seznamu hledat v kódu chyby a bezpečnostní nedostatky. Nic z toho nemusíte nastavovat ručně: autor pluginu vše připravil a vy jste jej jen připojili.

Ještě jedna důležitá věc: plugin agenta nic nenaučí „navždy“. Je to odnímatelný modul. Dnes ho připojíte, zítra odpojíte a bot se vrátí k souboru schopností, který měl před instalací pluginu. Díky tomu se pluginy snadno zkoušejí: vyberete si jeden, použijete ho na skutečný úkol, a pokud vám nevyhovuje, beze stopy ho odeberete.

Jak se plugin AI agenta liší od dovednosti, MCP a subagenta?#

Pojmy kolem agentů mohou být matoucí, proto jsem rozdíly shrnul do tabulky. Odpovídá také na polovinu otázek, které mají nováčci.

Ve světě Claude Code se propojení s externí službou nazývá MCP. Jde o standard, který agentovi umožňuje přistupovat ke GitHubu, databázi nebo prohlížeči. První čtyři řádky tabulky představují samostatné stavební bloky.

Podívejte se na poslední řádek. Plugin stojí o úroveň výš než ostatní čtyři součásti. Spojuje v jednom balíčku dovednost, pomocného agenta, automatizovanou akci a MCP. Autor vše sestavil, přidal soubor s popisem a zveřejnil to. Jediným příkazem získáte hotový celek místo toho, abyste čtyři části skládali zvlášť.

Díky tomu si můžete snadno vybrat. Potřebujete-li pro svůj úkol jednu drobnou schopnost, napište si dovednost sami; zabere to patnáct minut. Pokud chcete hotovou sadu od lidí, kteří už váš problém vyřešili, pořiďte si plugin. Samostatný návod o tom, jak vybírat dovednosti pro Claude Code, vysvětluje i to, jak agenta nepřetížit zbytečnými dovednostmi.

Co znamená „nainstalovat plugin do Telegramu“ a co s tím má Telegram společného?#

Tady často dochází k nedorozumění. Samotný Telegram žádné pluginy nemá: messenger neuchovává schopnosti bota. Předává vaše zprávy agentovi a zobrazuje jeho odpovědi. Mozek je někde jinde — na vašem notebooku nebo na serveru, kde běží agent, například Hermes Agent, OpenClaw nebo Claude Code připojený k chatu.

Plugin lze nainstalovat dvěma způsoby a oba fungují:

1. Přímo z chatu. Napište agentovi v Telegramu běžným jazykem: „nainstaluj si plugin pro GitHub“. Agent si ho nainstaluje na vlastním počítači a odpoví, že je připraven. Hodí se to, když je server daleko a vy máte u sebe telefon.
2. V terminálu. Přihlaste se k počítači, na kterém agent běží, a nainstalujte tam plugin příkazem. Při prvním pokusu je to spolehlivější: uvidíte celý výstup a nic vám neunikne.

Volba metody závisí na tom, zda botovi důvěřujete, že si rozšíření nainstaluje sám bez dohledu. Své první pluginy jsem instaloval ručně v terminálu, abych přesně viděl, co se připojuje. Jakmile jsem získal jistotu, začal jsem agentovi důvěřovat, že si je nainstaluje sám z chatu. Níže vám ukážu oba způsoby.

Jak nainstalovat plugin do agenta za pět minut?#

Ukážu vám Claude Code, protože postup je v jeho dokumentaci popsán doslova a snadno se opakuje. Příkazy jsou stejné v terminálu i při jejich odeslání agentovi v Telegramu.

1. Otevřete seznam pluginů. Příkaz /plugin otevře přímo v terminálu panel s kartou všech dostupných rozšíření a adresářem na claude.com/plugins. Jde o obchod, kde si je můžete prohlédnout před instalací.
2. Připojte oficiální tržiště. Zadejte /plugin marketplace add anthropics/claude-plugins-official. Tržiště je adresář, ze kterého agent stahuje pluginy. Oficiální tržiště provozuje Anthropic.
3. Nainstalujte požadovaný plugin. Použijte název pluginu a za něj název tržiště, oddělené zavináčem:

/plugin install github@claude-plugins-official

4. Znovu načtěte pluginy. Pokud bot po instalaci řekne „Run /reload-plugins to activate.“, spusťte /reload-plugins. Dokud je znovu nenačtete, nové příkazy se v aktuální konverzaci neobjeví. Pokud se zobrazí upozornění, že opětovné načtení znovu načte konverzaci, zopakujte příkaz jako /reload-plugins --force.

A je to. Agent teď má příkazy pluginu. V Claude Code používají název pluginu jako předponu, například /commit-commands:commit, takže hned poznáte, že příkaz pochází z pluginu.

Když botovi v Telegramu místo použití terminálu pošlete příkaz, Claude Code nabízí také samostatný instalační příkaz bez interaktivního panelu: claude plugin install. Dokumentace upozorňuje na jeden detail: tento příkaz nenačte plugin do již otevřené konverzace. Agent ho načte při příštím spuštění nebo po použití /reload-plugins. Jinými slovy, po instalaci musíte bota restartovat, jinak nové příkazy nezískáte.

V Hermes Agent se rozšíření zapínají a vypínají příkazem hermes tools, zatímco dovednosti mají vlastní složku. OpenClaw funguje podobně: připojte sadu a restartujte bota. Názvy se liší, ale pořadí zůstává stejné: připojit zdroj, nainstalovat podle názvu a restartovat agenta.

Pluginy jsou jedním ze stavebních bloků práce s kontextem: ještě před prvním požadavkem rozhodujete, které schopnosti má mít agent po ruce. Pro systematickou práci se hodí tato kombinace: klon AI (vaše znalosti v dovednostech a pluginech) + Druhý mozek (struktura znalostí o projektu) + práce s kontextem (co agentovi předat a kdy). To jsou tři pilíře, bez kterých AI začne hádat.

Kde pluginy získat a kterým můžete důvěřovat?#

Plugin je cizí kód a má stejná oprávnění jako váš agent: k souborům, terminálu i službám. Proto je zdroj důležitější než pěkný popis. Tady jsou zdroje seřazené od nejspolehlivějšího po nejméně důvěryhodný.

Pro instalaci z komunitního tržiště použijte podobný příkaz, ale jiné tržiště: /plugin install plugin-name@claude-community. Dokumentace výslovně uvádí, že tyto pluginy prošly automatickou bezpečnostní kontrolou a každý je připnutý ke konkrétní verzi kódu. To znamená, že získáte přesně to, co bylo zkontrolováno, bez pozdějších změn, které by tam autor mezitím přidal.

Před instalací Claude Code zobrazí část „Will install“: seznam příkazů, pomocníků, dovedností, automatizovaných akcí a propojení, která plugin přidá. Přečtěte si ho. Můžete tak například zjistit, že rozšíření pro poznámky z nějakého důvodu požaduje přístup k terminálu. Oficiální dokumentace pravidlo formuluje jasně:

Jednoduše řečeno: oficiální a prověřená tržiště vám poskytnou klid; náhodný repozitář na GitHubu použijte až poté, co si přečtete jeho obsah a pochopíte, proč potřebuje požadovaná oprávnění. Důvěra v kód třetích stran se netýká jen instalace pluginů. Věnuji se jí v článku o bezpečnosti vibe-codingu.

Jak ověřit, že je plugin nainstalovaný a funguje v Telegramu?#

Věnujte ověření minutu: hláška „nainstalováno“ ještě neznamená, že bot plugin skutečně načetl. Postupujte takto:

1. Zkontrolujte seznam. Znovu otevřete panel /plugin nebo požádejte agenta, aby zobrazil dostupné příkazy. V seznamu by se měly objevit příkazy nového pluginu, v Claude Code s předponou jeho názvu.
2. Zadejte mu testovací úkol. Vyberte něco bezpečného, ne živý úkol. Pokud jste nainstalovali plugin pro GitHub, požádejte ho, aby zobrazil nejnovější commity. Pokud jste nainstalovali plugin pro revize, dejte mu malý soubor. Sledujte jednu věc: ujme se bot úkolu pomocí nové schopnosti?
3. Ověřte to ve stejném chatu, který používáte k práci. Pokud agenta ovládáte přes Telegram, odešlete testovací příkaz v Telegramu. Někdy je plugin viditelný v terminálu, ale bot v chatu ho ještě nenačetl.

Nejčastějším důvodem, proč nainstalovaný plugin nefunguje, je vynechání opětovného načtení. Instalační příkaz proběhl úspěšně, ale agent v otevřené konverzaci stále používá původní sadu schopností. Pomůže /reload-plugins; pokud to nezabere, bota úplně restartujte. Druhým důvodem je instalace z jiného tržiště: název pluginu souhlasí, ale adresář je nesprávný a agent správně oznámí, že plugin není v připojených tržištích.

Pokud bot v chatu odpovídá, ale novému příkazu nerozumí, neznamená to, že je agent rozbitý nebo že jste udělali něco špatně. Téměř vždy jde o jednu ze dvou věcí: pluginy ještě nenačetl znovu, nebo jste připojili nesprávné tržiště. Obojí opravíte za minutu.

Jak aktualizovat a odebrat pluginy, aby agent nebyl zahlcený?#

Aktualizace má jeden méně zřejmý háček. Když autor vydá novou verzi pluginu, nedorazí sama. Nejprve aktualizujte adresář tržiště příkazem /plugin marketplace update a až potom nainstalujte novou verzi. Dokud tržiště neaktualizujete, agent považuje za aktuální verzi, kterou stáhl naposledy. Je to záměr: změny od jiných lidí se bez vašeho vědomí nepřidají dodatečně.

Plugin odeberte ve stejném panelu /plugin, který jste použili k instalaci: najděte ho v seznamu nainstalovaných pluginů a odeberte jej. V agentovi po něm nezůstane žádná stopa a po opětovném načtení příkazy zmizí. Právě proto není třeba bát se experimentování s pluginy: nainstalujte jich několik, ponechte si dva, které fungují, a zbytek odeberte.

Udržujte v tom pořádek. Každý připojený plugin přidává příkazy, které si agent musí pamatovat, a zabírá část jeho kontextového okna popisy. Pět nepoužívaných pluginů bota zpomaluje a zbytečně mate. Pravidlo je jednoduché: pokud plugin nebyl užitečný dva týdny, odeberte ho. Jedním příkazem ho můžete obnovit.

Které pluginy bych nainstaloval jako první?#

Nebudu vám dávat seznam 100 nejlepších — zaslouží si samostatný návod a ten už mám v článku 10 nejlepších pluginů Claude Code. Tady jsou tři oblasti, které doporučuji začátečníkům spravujícím agenta z Telegramu.

1. Práce s GitHubem. Plugin, který agentovi poskytne příkazy pro commity, větve a pull requesty. Napište botovi do chatu „ulož práci a nahraj ji do repozitáře“ a on to provede. Tím odpadá hlavní obava lidí, kteří tvoří pomocí vibe-codingu bez zkušeností: strach ze ztráty kódu.
2. Revize kódu. Plugin s kontrolním seznamem pro hledání chyb, bezpečnostních nedostatků a slabých míst. Hodí se hlavně v kombinaci s Telegramem: pošlete do chatu část kódu a dostanete revizi bez otevírání editoru.
3. Commity v jednotném stylu. Malý plugin, který agenta přiměje formátovat commity podle jedné šablony. Může to působit jako maličkost, ale po měsíci bude historie projektu přehledná jako ve firemním týmu místo toho, aby se změnila v nepořádek.

Pak si vyberte pluginy pro konkrétní úkoly. Pracujete s databází? Pořiďte si databázový plugin. Sestavujete přehledy? Pořiďte si plugin pro plánování. Obecné pravidlo je stejné: začněte úkolem a potom pro něj najděte plugin. Instalovat pluginy dopředu „pro jistotu“ je spolehlivý způsob, jak bota zaplavit příkazy, které nikdy nepoužijete.

Na co dalšího se lidé ptají ohledně pluginů v agentovi pro Telegram?#

Pro systematickou práci se hodí tato kombinace: klon AI + Druhý mozek + práce s kontextem.

Otevřete Ailoot.