OpenClaw su Telegram: il tuo assistente AI self-hosted in una chat

Telegram è il modo più veloce per mettere OpenClaw in tasca. Creare un token del bot richiede circa un minuto, non c'è alcun processo di approvazione e non serve un numero di telefono dedicato; una volta collegato, parli con il tuo assistente self-hosted allo stesso modo in cui parli con chiunque altro nei tuoi contatti.

Perché Telegram è l'integrazione più semplice

Ogni piattaforma di messaggistica chiede qualcosa prima di lasciare che un programma parli per tuo conto. WhatsApp vuole un numero di telefono e, per qualsiasi uso oltre quello personale, un account business Meta. Discord vuole un'applicazione, un URL di invito e una decisione sugli intent privilegiati. Telegram vuole una conversazione con un bot chiamato BotFather, e poi ti consegna un token.

• Sempre in tasca. Scrivi al tuo assistente come a qualsiasi altro contatto Telegram, dal telefono, dal desktop o dal client web, con la conversazione sincronizzata su tutti.
• Nessun numero, nessuna approvazione. Un bot non è legato a un numero di telefono, quindi non ti costa nulla crearlo e nulla abbandonarlo se cambi idea.
• Indipendente dal modello. Il bot è solo l'interfaccia. Dietro di lui, OpenClaw può essere puntato su OpenAI, Anthropic, Google o un modello locale, e puoi cambiarlo senza toccare Telegram.
• Più del testo. Messaggi vocali, immagini e documenti arrivano tutti come messaggi su cui il tuo assistente può agire, il che fa di una finestra di chat un'interfaccia sorprendentemente capace.

Come collegare OpenClaw a Telegram

1. Crea un bot. In Telegram scrivi a @BotFather, esegui /newbot e scegli un nome visualizzato e uno username che finisce con bot. BotFather risponde con un token, una lunga stringa di cifre e lettere.
2. Tratta il token come una password. Chiunque lo possieda può agire come il tuo bot. Se viene divulgato, /revoke in BotFather lo invalida subito e ne emette uno nuovo.
3. Distribuisci OpenClaw. Se non l'hai ancora fatto, distribuisci la tua istanza su Flux in circa 30 secondi.
4. Incolla il token. Nella tua dashboard OpenClaw aggiungi l'integrazione Telegram e incolla il token.
5. Inizia a chattare. Apri la chat con il tuo bot e invia un messaggio. La risposta arriva dalla tua istanza.

Mentre sei ancora in BotFather, due impostazioni facoltative conviene farle subito. /setdescription e /setabouttext controllano cosa vedono le persone prima di iniziare una conversazione, e /setcommands dà al tuo bot un menu di comandi, che è la differenza tra un assistente che sembra finito e uno che sembra un prototipo.

Usarlo in un gruppo

Un bot Telegram si comporta diversamente in un gruppo rispetto a un messaggio diretto, e la differenza sorprende quasi tutti almeno una volta. I bot vengono creati con la Privacy Mode attiva, il che significa che in un gruppo ricevono solo i messaggi che iniziano con un comando slash, o che rispondono o menzionano direttamente il bot. Ogni altro messaggio di quel gruppo non viene mai consegnato al tuo server.

Ecco perché lo stesso bot può rispondere perfettamente ai tuoi messaggi diretti e sembrare completamente morto in un gruppo. Non sta ignorando nessuno: semplicemente non li ha mai sentiti. Disattiva Group Privacy in BotFather nelle Bot Settings, poi rimuovi il bot dal gruppo e aggiungilo di nuovo, perché l'impostazione ha effetto quando il bot entra. La nostra guida su un assistente che smette di rispondere copre questo e la trappola equivalente su Discord in modo più dettagliato.

Vale però la pena fermarsi invece di cliccare avanti. Con la Privacy Mode disattivata, l'assistente riceve tutto ciò che viene detto in quel gruppo. È esattamente quello che vuoi per una chat piccola di famiglia o di squadra, ed esattamente quello che non vuoi in una grande.

Cosa vede Telegram e cosa no

Il self-hosting cambia molto in termini di privacy, e vale la pena essere precisi su cosa cambia invece di venderlo come più di quanto sia.

Cosa cambia: i tuoi messaggi vengono elaborati da un'istanza che controlli. Non c'è nessun fornitore terzo del bot tra te e il tuo assistente, nessun servizio condiviso che accumula la cronologia delle tue conversazioni e nessun prodotto i cui termini possano cambiare sotto di te. Se punti OpenClaw a un modello locale, il contenuto delle tue conversazioni non lascia mai il tuo server.

Cosa non cambia: i messaggi dei bot Telegram passano attraverso Telegram. La Bot API non è cifrata end-to-end, e i messaggi a un bot non sono in una Secret Chat, quindi Telegram stesso gestisce il contenuto in transito, indipendentemente da chi gestisce il bot. Il self-hosting elimina l'intermediario in più; non elimina la piattaforma. Per la maggior parte delle persone è un buon compromesso, da fare consapevolmente. Se per una certa conversazione non è un compromesso accettabile, quella conversazione va nell'interfaccia web di OpenClaw invece che in una piattaforma di chat.

Limiti da conoscere prima di farci affidamento

La Bot API di Telegram ha alcuni confini che diventano visibili solo quando li incontri:

• Dimensione dei file. I bot possono scaricare file fino a 20 MB tramite la Bot API e inviarne fino a 50 MB. Un video grande o una registrazione lunga semplicemente non arriveranno al tuo assistente, e il guasto è silenzioso invece che rumoroso.
• Rate limit. Telegram limita la velocità con cui un bot può inviare messaggi, il che conta se il tuo assistente produce lunghi flussi di output invece di singole risposte.
• Lunghezza dei messaggi. Un singolo messaggio Telegram è limitato a 4,096 caratteri, quindi le risposte lunghe arrivano divise in più messaggi.

Nessuno di questi è un problema per l'uso quotidiano. Sono il tipo di cosa utile da sapere in anticipo, così che un guasto silenzioso appaia come un limite documentato e non come un'integrazione rotta.

Per cosa la gente lo usa davvero

Lo schema che rende un assistente in chat utile non è fargli domande, cosa che una scheda del browser già fa bene. Sono le cose che beneficiano di essere a un messaggio di distanza: inoltrare un articolo e chiedere l'argomentazione in tre righe, inviare la foto di un documento e chiedere cosa dice, dettare un messaggio vocale mentre cammini e ricevere indietro un riassunto scritto, oppure attivare qualcosa sulla tua rete senza aprire un portatile. Una finestra di chat è un'interfaccia a basso attrito, e il basso attrito è ciò che trasforma uno strumento in un'abitudine.

Inizia

Telegram è una delle oltre 20 integrazioni. Dai un'occhiata anche a WhatsApp e Discord, dimensiona la tua istanza con i requisiti del server oppure leggi la guida completa al self-hosting di OpenClaw. Sei pronto? Distribuisci dalla homepage.