Plugin per un bot Telegram con agente AI: installazione e verifica

Il mio agente gira su un server e gli do comandi da Telegram: scrivo nella chat, lui legge file, esegue attività e mi invia il risultato. A un certo punto si raggiunge un limite: il bot di base sa fare molto poco e vuoi che esamini il codice, faccia commit su GitHub o prepari un riepilogo programmato. La risposta sono i plugin.

È proprio questo che cercano le persone quando digitano «come installare un plugin in Telegram». Non parlano di un negozio di sticker. Vogliono sapere come dare nuove capacità a un bot. Qui sotto, passo dopo passo: cos’è un plugin, dove si installa davvero, come installarne uno in cinque minuti e come evitare di introdurre codice dannoso nel proprio agente. Questa descrizione si basa sulla documentazione ufficiale.

Le informazioni pratiche sull’uso di Ailoot sono disponibili nella documentazione.

Cos’è un plugin per agenti AI, in parole semplici?#

Vediamolo più da vicino. Un agente AI, così com’è, sa fare le cose di base: leggere file, scrivere codice e rispondere alle domande. Un plugin è una cartella di capacità aggiuntive che l’agente acquisisce e inizia a usare. La documentazione ufficiale di Claude Code descrive un plugin proprio così: estende l’agente con skill, agenti helper separati, azioni automatiche e connessioni a servizi esterni.

Ecco un esempio semplice. Installa un plugin per lavorare con GitHub e l’agente ottiene comandi per creare un commit, aprire una pull request e consultare la cronologia delle modifiche. Installa un plugin di revisione e l’agente controlla il codice per individuare errori e falle di sicurezza usando una checklist predefinita. Non hai configurato nulla a mano: l’autore del plugin ha preparato tutto e tu l’hai solo collegato.

Un’altra cosa importante: un plugin non insegna nulla all’agente «per sempre». È un modulo rimovibile. Lo colleghi oggi, lo scolleghi domani e il bot torna alle capacità che aveva prima del plugin. Questo rende i plugin comodi da provare: scegline uno, usalo per un’attività reale e, se non fa per te, rimuovilo senza lasciare traccia.

In cosa differisce un plugin da una skill, da MCP e da un subagente?#

I termini che riguardano gli agenti possono confondere, quindi ho riassunto le differenze in una tabella. Risponde anche a metà delle domande che si pongono i principianti.

Nel mondo di Claude Code, una connessione a un servizio esterno si chiama MCP. È uno standard che permette all’agente di raggiungere GitHub, un database o un browser. Le prime quattro righe della tabella rappresentano elementi distinti.

Guarda l’ultima riga. Un plugin si trova un livello sopra gli altri quattro elementi. Riunisce in una scatola una skill, un helper, un’azione automatica e MCP. L’autore ha assemblato tutto, aggiunto un file di descrizione e pubblicato il plugin. Ottieni un insieme già pronto con un solo comando, invece di assemblare quattro componenti separatamente.

Questo ti dà una regola semplice per scegliere. Se ti serve una piccola capacità per un’attività, scrivi tu la skill: ci vogliono quindici minuti. Se vuoi un insieme già pronto, realizzato da persone che hanno già risolto il tuo problema, scegli un plugin. Ho una guida separata su come scegliere le skill per Claude Code, compreso come evitare di sovraccaricare l’agente con skill aggiuntive.

Cosa significa «installare un plugin in Telegram» e cosa c’entra Telegram?#

È qui che nasce un equivoco comune. Telegram non ha plugin: il messenger non conserva le capacità del bot. Trasmette i tuoi messaggi all’agente e ne mostra le risposte. Il cervello si trova altrove, sul tuo portatile o su un server dove gira un agente come Hermes Agent, OpenClaw o Claude Code collegato alla chat.

Ci sono due modi per installare un plugin e funzionano entrambi:

1. Direttamente dalla chat. Scrivi all’agente su Telegram una richiesta in linguaggio naturale: «installa un plugin per GitHub per te». L’agente lo installa sulla propria macchina e ti risponde che è pronto. È comodo quando il server è lontano e tu sei al telefono.
2. Dal terminale. Accedi alla macchina su cui gira l’agente e installa lì il plugin con un comando. La prima volta è più affidabile: puoi vedere tutto l’output e non ti perdi nulla.

Il metodo da scegliere dipende da quanto ti fidi che il bot installi estensioni da solo, senza supervisione. Ho installato a mano i miei primi plugin dal terminale, così potevo vedere esattamente cosa veniva collegato. Quando ci ho preso la mano, ho iniziato a fidarmi dell’agente e a lasciarglieli installare dalla chat. Qui sotto ti mostro entrambi i metodi.

Come si installa un plugin in un agente in cinque minuti?#

Ti mostro Claude Code perché il processo è descritto parola per parola nella sua documentazione ed è facile da ripetere. I comandi sono gli stessi nel terminale e quando li invii all’agente su Telegram.

1. Apri l’elenco dei plugin. Il comando /plugin apre un pannello direttamente nel terminale, con una scheda che mostra tutte le estensioni disponibili e una directory su claude.com/plugins. È una vetrina da consultare prima dell’installazione.
2. Collega il marketplace ufficiale. Inserisci /plugin marketplace add anthropics/claude-plugins-official. Un marketplace è una directory da cui l’agente scarica i plugin. Quello ufficiale è gestito da Anthropic.
3. Installa il plugin che ti serve. Usa il nome del plugin seguito dal nome del marketplace, separati dal simbolo @:

/plugin install github@claude-plugins-official

4. Ricarica i plugin. Se dopo l’installazione il bot dice «Run /reload-plugins to activate.», esegui /reload-plugins. Finché non li ricarichi, i nuovi comandi non appariranno nella conversazione corrente. Se ricevi un avviso che il ricaricamento rileggerà la conversazione, ripeti il comando come /reload-plugins --force.

Ecco fatto. Ora l’agente dispone dei comandi del plugin. In Claude Code, usano il nome del plugin come prefisso, per esempio /commit-commands:commit, così puoi vedere subito che il comando proviene da un plugin.

Quando invii un comando al bot su Telegram invece di usare il terminale, Claude Code offre anche un comando autonomo per l’installazione, senza il pannello interattivo: claude plugin install. La documentazione segnala un dettaglio: questo comando non carica il plugin in una conversazione già aperta. L’agente lo rileverà al successivo avvio o dopo /reload-plugins. In altre parole, dopo l’installazione devi riavviare il bot, altrimenti non otterrai i nuovi comandi.

In Hermes Agent, le estensioni si abilitano e disabilitano con il comando hermes tools, mentre le skill si trovano nella propria cartella. OpenClaw funziona in modo simile: collega un insieme e riavvia il bot. I nomi cambiano, ma l’ordine è lo stesso: collega una fonte, installa per nome e riavvia l’agente.

I plugin sono uno degli elementi dell’ingegneria del contesto: prima della prima richiesta, decidi quali capacità l’agente deve avere a portata di mano. Per lavorare in modo sistematico, è utile questa combinazione: clone AI (la tua esperienza nelle skill e nei plugin) + Second Brain (la struttura delle conoscenze del progetto) + ingegneria del contesto (cosa dare all’agente e quando). Sono i tre pilastri senza i quali l’AI inizia a tirare a indovinare.

Dove trovare i plugin e di quali puoi fidarti?#

Un plugin è codice di qualcun altro e riceve gli stessi permessi del tuo agente: accesso ai file, al terminale e ai servizi. Per questo la fonte conta più di una descrizione accattivante. Ecco le fonti, dalla più affidabile alla più discutibile.

Per installare dal marketplace della community, usa un comando simile ma con un marketplace diverso: /plugin install plugin-name@claude-community. La documentazione specifica che questi plugin hanno superato un controllo di sicurezza automatico e ognuno è bloccato a una versione specifica del codice. Questo significa che riceverai esattamente ciò che è stato controllato, senza modifiche successive introdotte di nascosto dall’autore.

Prima dell’installazione, Claude Code mostra una sezione «Will install»: un elenco dei comandi, degli helper, delle skill, delle azioni automatiche e delle connessioni che il plugin aggiungerà. Leggilo. È l’occasione per accorgerti, per esempio, che un’estensione per le note chiede accesso al terminale senza un motivo apparente. La documentazione ufficiale enuncia chiaramente la regola:

In parole semplici: i marketplace ufficiale e selezionato offrono maggiore tranquillità; usa un repository GitHub qualsiasi solo dopo aver letto cosa contiene e aver capito perché richiede i permessi che chiede. La fiducia nel codice di terze parti va oltre l’installazione dei plugin e ne parlo nel mio articolo sulla sicurezza nel vibe coding.

Come verificare che il plugin sia installato e funzioni su Telegram?#

Dedica un minuto alla verifica: vedere la dicitura «installed» non significa ancora che il bot abbia effettivamente acquisito il plugin. Segui questi passaggi:

1. Controlla l’elenco. Riapri il pannello /plugin oppure chiedi all’agente di mostrarti i comandi disponibili. I comandi del nuovo plugin dovrebbero comparire nell’elenco, preceduti dal nome del plugin in Claude Code.
2. Assegnagli un’attività di prova. Scegli qualcosa di sicuro, non un’attività reale. Se hai installato un plugin per GitHub, chiedigli di mostrarti gli ultimi commit. Se hai installato un plugin di revisione, passagli un piccolo file. Verifica una cosa: il bot svolge l’attività usando la nuova capacità?
3. Verifica dalla stessa chat che usi per lavorare. Se controlli l’agente da Telegram, invia il comando di prova su Telegram. A volte il plugin è visibile nel terminale, ma il bot in chat non lo ha ancora ricaricato.

Il motivo più comune per cui un plugin è installato ma i suoi comandi non funzionano è che hai saltato il ricaricamento. Il comando di installazione è riuscito, ma l’agente nella conversazione aperta sta ancora usando il vecchio insieme di capacità. /reload-plugins può aiutare; se non basta, riavvia completamente il bot. Il secondo motivo è che l’installazione è stata fatta da un marketplace diverso: il nome del plugin corrisponde, ma la directory è sbagliata e l’agente dice correttamente che il plugin non si trova nei marketplace collegati.

Se il bot risponde in chat ma non capisce il nuovo comando, non significa che l’agente sia guasto o che tu abbia sbagliato qualcosa. Quasi sempre, si tratta di una di queste due cose: non ha ricaricato i plugin oppure hai collegato il marketplace sbagliato. Per risolvere entrambe basta un minuto.

Come aggiornare e rimuovere i plugin senza ingombrare l’agente?#

C’è un dettaglio sugli aggiornamenti che non è ovvio. Quando l’autore pubblica una nuova versione di un plugin, questa non arriva da sola. Prima aggiorna la directory del marketplace con /plugin marketplace update e solo dopo installa la nuova versione. Finché non aggiorni il marketplace, l’agente considera attuale la versione scaricata l’ultima volta. È intenzionale: le modifiche di altri non verranno introdotte in un secondo momento a tua insaputa.

Rimuovi un plugin dallo stesso pannello /plugin che hai usato per installarlo: trovalo nell’elenco dei plugin installati e rimuovilo. Non lascia traccia nell’agente e i comandi scompaiono non appena ricarichi. Ecco perché i plugin non fanno paura da provare: installane diversi, tieni i due che funzionano e rimuovi gli altri.

E mantieni tutto in ordine. Ogni plugin collegato aggiunge comandi che l’agente deve tenere a mente e usa parte della sua finestra di contesto per le relative descrizioni. Cinque plugin che non usi rallentano il bot e lo confondono senza motivo. La regola è semplice: se un plugin non è stato utile per due settimane, rimuovilo. Puoi ripristinarlo con un comando.

Quali plugin installerei per primi?#

Non ti darò una lista delle prime 100 opzioni: merita una guida a parte e ho già un articolo sui 10 migliori plugin per Claude Code. Ecco tre ambiti che consiglio ai principianti che gestiscono un agente da Telegram.

1. Lavorare con GitHub. Un plugin che fornisce all’agente comandi per commit, branch e pull request. Scrivi al bot in chat: «salva il lavoro e invialo al repository», e lui lo fa. Questo elimina la principale preoccupazione di chi fa vibe coding senza esperienza: la paura di perdere il codice.
2. Revisione del codice. Un plugin con una checklist per controllare errori, falle di sicurezza e punti deboli. È particolarmente utile con Telegram: invia un pezzo di codice in chat e ottieni una revisione senza aprire un editor.
3. Commit con uno stile coerente. Un piccolo plugin che fa formattare all’agente i commit secondo un unico modello. Può sembrare un dettaglio, ma dopo un mese la cronologia del progetto sarà ordinata, come quella di un team, invece di diventare un caos.

Da lì, scegli i plugin per attività specifiche. Lavori con un database? Scegli un plugin per database. Prepari riepiloghi? Scegli un plugin di pianificazione. La regola generale è la stessa: parti da un’attività, poi trova un plugin adatto. Installare plugin in anticipo, «per ogni evenienza», è un modo sicuro per sommergere il bot di comandi che non userai mai.

Cos’altro chiedono le persone sui plugin in un agente Telegram?#

Per lavorare in modo sistematico, è utile questa combinazione: clone AI + Second Brain + ingegneria del contesto.

Apri Ailoot.