Plugins voor een AI-agent in een Telegram-bot: installatie en controle

Mijn agent draait op een server en ik geef hem opdrachten via Telegram: ik schrijf iets in de chat, hij leest bestanden, voert taken uit en stuurt me het resultaat. Op een gegeven moment loop je tegen een grens aan: de standaardbot kan heel weinig, en je wilt dat hij code nakijkt, commits naar GitHub maakt of op vaste tijden een samenvatting samenstelt. De oplossing is plugins.

Mensen zoeken precies daarom naar “hoe installeer ik een plugin in Telegram”. Ze hebben het niet over een stickerwinkel. Ze willen weten hoe ze een bot nieuwe mogelijkheden kunnen geven. Hieronder lees je stap voor stap wat een plugin is, waar die daadwerkelijk wordt geïnstalleerd, hoe je er in vijf minuten een installeert en hoe je voorkomt dat er schadelijke code in je agent terechtkomt. Deze uitleg is gebaseerd op de officiële documentatie en het installatieproces.

Praktische informatie over werken met Ailoot vind je in de documentatie.

Wat is een plugin voor een AI-agent, eenvoudig uitgelegd?#

Laten we het uit elkaar halen. Een AI-agent kan standaard de basisdingen: bestanden lezen, code schrijven en vragen beantwoorden. Een plugin is een map met extra mogelijkheden die de agent oppikt en gaat gebruiken. De officiële Claude Code-documentatie beschrijft een plugin precies zo: hij breidt de agent uit met skills, afzonderlijke hulpagents, geautomatiseerde acties en verbindingen met externe diensten.

Een eenvoudig voorbeeld. Installeer een plugin voor GitHub en de agent krijgt opdrachten om een commit te maken, een pull request te openen en de wijzigingsgeschiedenis te bekijken. Installeer een plugin voor codebeoordeling en de agent controleert je code op fouten en beveiligingsproblemen aan de hand van een vooraf bepaalde checklist. Je hebt dit niet handmatig ingesteld: de auteur van de plugin heeft alles samengebracht en jij hebt de plugin alleen maar aangesloten.

Nog iets belangrijks: een plugin leert de agent niet voor “altijd” iets nieuws. Het is een module die je kunt verwijderen. Sluit hem vandaag aan en verbreek morgen de verbinding; dan heeft de bot weer dezelfde mogelijkheden als vóór de plugin. Daardoor zijn plugins handig om uit te proberen: kies er een, gebruik hem voor een echte taak en verwijder hem spoorloos als hij niet bevalt.

Wat is het verschil tussen een plugin, een skill, MCP en een subagent?#

De termen rond agents kunnen verwarrend zijn, dus ik heb de verschillen in een tabel samengevat. Die beantwoordt ook de helft van de vragen die beginners hebben.

In de wereld van Claude Code heet een verbinding met een externe dienst MCP. Het is een standaard waarmee de agent toegang krijgt tot GitHub, een database of een browser. De eerste vier rijen van de tabel zijn afzonderlijke bouwstenen.

Kijk naar de onderste rij. Een plugin staat één niveau boven de andere vier. Hij brengt een skill, een hulpagent, een geautomatiseerde actie en MCP samen in één pakket. De auteur heeft alles samengesteld, een beschrijvingsbestand toegevoegd en het gepubliceerd. Met één opdracht krijg je een kant-en-klaar geheel in plaats van vier onderdelen afzonderlijk samen te stellen.

Dat levert een eenvoudige keuzeregel op. Heb je voor je taak één kleine mogelijkheid nodig, schrijf de skill dan zelf; dat kost vijftien minuten. Heb je een kant-en-klare set nodig van mensen die je probleem al hebben opgelost, neem dan een plugin. Ik heb een aparte gids over hoe je skills voor Claude Code kiest, inclusief hoe je voorkomt dat je agent te veel skills krijgt.

Wat betekent “een plugin installeren in Telegram” en wat heeft Telegram ermee te maken?#

Hier ontstaat vaak verwarring. Telegram zelf heeft geen plugins: de berichtenapp bewaart de mogelijkheden van de bot niet. Hij geeft je berichten door aan de agent en toont diens antwoorden. Het brein bevindt zich ergens anders — op je laptop of op een server waarop een agent zoals Hermes Agent, OpenClaw of Claude Code draait, verbonden met de chat.

Er zijn twee manieren om een plugin te installeren, en beide werken:

1. Rechtstreeks vanuit de chat. Schrijf in Telegram in gewone taal een verzoek aan de agent: “installeer een GitHub-plugin voor jezelf”. De agent installeert hem op zijn eigen machine en laat weten dat hij klaar is. Dat is handig als de server ver weg staat en je je telefoon gebruikt.
2. In de terminal. Log in op de machine waarop de agent draait en installeer de plugin daar met een opdracht. De eerste keer is dit betrouwbaarder: je kunt alle uitvoer zien en mist niets.

Welke methode je kiest, hangt ervan af of je erop vertrouwt dat de bot zelfstandig en zonder toezicht uitbreidingen installeert. Mijn eerste plugins heb ik handmatig in de terminal geïnstalleerd, zodat ik precies kon zien wat er werd aangesloten. Toen ik er eenmaal aan gewend was, vertrouwde ik de agent toe om ze zelf vanuit de chat te installeren. Hieronder laat ik beide manieren zien.

Hoe installeer je in vijf minuten een plugin in een agent?#

Ik laat Claude Code zien, omdat het proces letterlijk in de documentatie staat en eenvoudig te herhalen is. De opdrachten zijn hetzelfde in de terminal en wanneer je ze via Telegram naar de agent stuurt.

1. Open de lijst met plugins. Met de opdracht /plugin open je een paneel in de terminal, met een tabblad waarin alle beschikbare uitbreidingen staan en een directory op claude.com/plugins. Dit is een winkel waar je rond kunt kijken voordat je iets installeert.
2. Sluit de officiële marktplaats aan. Voer /plugin marketplace add anthropics/claude-plugins-official in. Een marktplaats is een directory waar de agent plugins vandaan downloadt. Anthropic beheert de officiële marktplaats.
3. Installeer de plugin die je nodig hebt. Gebruik de naam van de plugin, gevolgd door de naam van de marktplaats, gescheiden door een apenstaartje:

/plugin install github@claude-plugins-official

4. Laad de plugins opnieuw. Als de bot na de installatie zegt “Run /reload-plugins to activate.”, voer dan /reload-plugins uit. Zolang je ze niet opnieuw laadt, verschijnen de nieuwe opdrachten niet in het huidige gesprek. Krijg je de waarschuwing dat opnieuw laden het gesprek opnieuw zal inlezen, herhaal de opdracht dan als /reload-plugins --force.

Dat is alles. De agent heeft nu de opdrachten van de plugin. In Claude Code gebruiken ze de naam van de plugin als voorvoegsel, bijvoorbeeld /commit-commands:commit, zodat je meteen ziet dat de opdracht bij een plugin hoort.

Als je de bot in Telegram een opdracht stuurt in plaats van de terminal te gebruiken, heeft Claude Code ook een afzonderlijke installatieopdracht zonder het interactieve paneel: claude plugin install. In de documentatie staat een belangrijk detail: deze opdracht laadt de plugin niet in een gesprek dat al geopend is. De agent pikt hem op bij de volgende start of nadat je /reload-plugins uitvoert. Met andere woorden: na de installatie moet je de bot opnieuw starten, anders krijg je de nieuwe opdrachten niet.

In Hermes Agent schakel je uitbreidingen in en uit met de opdracht hermes tools, terwijl skills in hun eigen map staan. OpenClaw werkt op vergelijkbare wijze: sluit een set aan en start de bot opnieuw. De namen verschillen, maar de volgorde is dezelfde: sluit een bron aan, installeer op naam en start de agent opnieuw.

Plugins zijn een bouwsteen van context engineering: je bepaalt welke mogelijkheden de agent paraat heeft voordat je je eerste verzoek doet. Voor systematisch werk is deze combinatie nuttig: AI-kloon (jouw expertise in skills en plugins) + Second Brain (de structuur van projectkennis) + context engineering (wat je de agent geeft en wanneer). Dat zijn de drie pijlers die voorkomen dat AI gaat gokken.

Waar haal je plugins vandaan en welke kun je vertrouwen?#

Een plugin is code van iemand anders en krijgt dezelfde rechten als je agent: toegang tot bestanden, de terminal en diensten. Daarom is de bron belangrijker dan een mooie beschrijving. Hier zijn de bronnen, van betrouwbaar naar twijfelachtig.

Gebruik voor installatie vanuit de communitymarktplaats een vergelijkbare opdracht, maar met een andere marktplaats: /plugin install plugin-name@claude-community. De documentatie vermeldt nadrukkelijk dat deze plugins een automatische beveiligingscontrole hebben doorstaan en elk zijn vastgezet op een specifieke versie van de code. Dat betekent dat je precies krijgt wat is gecontroleerd, zonder latere wijzigingen die de auteur er ongemerkt in heeft aangebracht.

Voordat je iets installeert, toont Claude Code een gedeelte met de titel “Will install”: een lijst van de opdrachten, hulpagents, skills, geautomatiseerde acties en verbindingen die de plugin toevoegt. Lees die lijst. Zo kun je bijvoorbeeld ontdekken dat een uitbreiding voor notities om een of andere reden toegang tot de terminal vraagt. De officiële documentatie formuleert de regel duidelijk:

Kort gezegd: de officiële en gecontroleerde marktplaatsen geven gemoedsrust; gebruik een willekeurige GitHub-repository alleen nadat je hebt gelezen wat erin zit en begrijpt waarom hij de gevraagde rechten nodig heeft. Vertrouwen in code van derden gaat verder dan het installeren van plugins; ik bespreek dat in mijn artikel over vibe-coding-beveiliging.

Hoe controleer je of de plugin is geïnstalleerd en werkt in Telegram?#

Neem een minuut om dit te controleren: “geïnstalleerd” zien betekent nog niet dat de bot de plugin daadwerkelijk heeft opgepikt. Volg deze stappen:

1. Controleer de lijst. Open het paneel /plugin opnieuw of vraag de agent om zijn beschikbare opdrachten te tonen. De opdrachten van de nieuwe plugin moeten in de lijst staan, in Claude Code met de naam van de plugin als voorvoegsel.
2. Geef een testtaak. Kies iets veiligs, geen taak die je echt moet uitvoeren. Als je een GitHub-plugin hebt geïnstalleerd, vraag dan om de meest recente commits te tonen. Heb je een plugin voor codebeoordeling geïnstalleerd, geef dan een klein bestand. Let op één ding: pakt de bot de taak op met de nieuwe mogelijkheid?
3. Controleer dit vanuit dezelfde chat die je voor je werk gebruikt. Als je de agent vanuit Telegram bedient, stuur de testopdracht dan via Telegram. Soms is de plugin zichtbaar in de terminal, maar heeft de bot in de chat hem nog niet opnieuw geladen.

De meest voorkomende reden dat de opdrachten van een geïnstalleerde plugin niet werken, is dat je vergeten bent de agent opnieuw te laden. De installatieopdracht is geslaagd, maar de agent in het open gesprek gebruikt nog steeds zijn oude set mogelijkheden. /reload-plugins helpt; werkt dat niet, start de bot dan volledig opnieuw. Een tweede reden is dat je de plugin vanuit een andere marktplaats hebt geïnstalleerd: de naam klopt, maar de directory is verkeerd en de agent zegt terecht dat de plugin niet in de aangesloten marktplaatsen staat.

Als de bot antwoordt in de chat maar de nieuwe opdracht niet begrijpt, betekent dat niet dat de agent kapot is of dat je iets verkeerd hebt gedaan. Bijna altijd is een van twee dingen aan de hand: de plugins zijn niet opnieuw geladen, of je hebt de verkeerde marktplaats aangesloten. Beide zijn binnen een minuut op te lossen.

Hoe werk je plugins bij en verwijder je ze zonder je agent te overladen?#

Bij updates is er een detail dat niet meteen opvalt. Wanneer de auteur een nieuwe versie van een plugin uitbrengt, verschijnt die niet vanzelf. Werk eerst de directory van de marktplaats bij met /plugin marketplace update en installeer daarna pas de nieuwe versie. Zolang je de marktplaats niet bijwerkt, beschouwt de agent de versie die hij de vorige keer heeft gedownload als actueel. Dat is bewust zo: wijzigingen van anderen worden niet achteraf en zonder jouw medeweten toegevoegd.

Verwijder een plugin via hetzelfde paneel /plugin dat je voor de installatie hebt gebruikt: zoek de plugin in de lijst met geïnstalleerde plugins en verwijder hem. Hij laat geen spoor achter in de agent en de opdrachten verdwijnen zodra je opnieuw laadt. Daarom hoef je niet bang te zijn om plugins uit te proberen: installeer er een stel, houd de twee die werken en verwijder de rest.

Houd het ook overzichtelijk. Elke aangesloten plugin voegt opdrachten toe die de agent moet onthouden en gebruikt een deel van zijn contextvenster voor beschrijvingen. Vijf plugins die je niet gebruikt vertragen de bot en brengen hem zonder reden in verwarring. De regel is eenvoudig: als een plugin twee weken lang niet nuttig is geweest, verwijder hem dan. Je kunt hem met één opdracht terugzetten.

Welke plugins zou ik als eerste installeren?#

Ik geef je geen top 100 — dat verdient een aparte gids, en ik heb al een artikel over de top 10 Claude Code-plugins. Dit zijn drie gebieden die ik aan beginners aanbeveel die een agent vanuit Telegram beheren.

1. Werken met GitHub. Een plugin die de agent opdrachten geeft voor commits, branches en pull requests. Schrijf in de chat tegen de bot: “sla het werk op en push het naar de repository”, en hij doet het. Zo verdwijnt de grootste zorg van mensen die zonder ervaring aan vibe-coding doen: de angst om code kwijt te raken.
2. Codebeoordeling. Een plugin met een checklist voor het opsporen van fouten, beveiligingsproblemen en zwakke plekken. Hij is bijzonder handig met Telegram: stuur een stukje code in de chat en krijg een beoordeling zonder een editor te openen.
3. Commits in een consistente stijl. Een kleine plugin die de agent commits volgens één sjabloon laat opmaken. Dat lijkt misschien onbelangrijk, maar na een maand ziet de projectgeschiedenis er netjes uit, alsof een team eraan heeft gewerkt, in plaats van een rommeltje te zijn.

Kies daarna plugins voor specifieke taken. Werk je met een database? Neem een databaseplugin. Stel je samenvattingen samen? Neem een planningsplugin. De algemene regel blijft hetzelfde: begin met een taak en zoek daar vervolgens een plugin bij. Plugins vooraf installeren “voor het geval dat” is een zekere manier om de bot te laten verdrinken in opdrachten die je nooit gebruikt.

Wat vragen mensen nog meer over plugins in een Telegram-agent?#

Voor systematisch werk is deze combinatie nuttig: AI-kloon + Second Brain + context engineering.

Open Ailoot.