Messaggi avanzati e approvazioni Telegram in OpenClaw

Il testo è solo l’inizio di ciò che un bot Telegram può inviare: blocchi formattati, una tastiera sotto un messaggio, un launcher di Mini App, una reazione al messaggio di qualcun altro, una richiesta di approvazione con due pulsanti. OpenClaw espone ciascuno di questi elementi tramite un piccolo insieme di chiavi di configurazione e azioni sui messaggi, per lo più disattivate finché non le attivi. Ecco il contratto di formattazione, gli ambiti dei pulsanti, le azioni con i loro interruttori e come un’approvazione exec raggiunge un approvatore dentro Telegram.

Formattazione

• Il testo in uscita usa per impostazione predefinita l’HTML standard di Telegram, leggibile su tutti i client attuali, con grassetto, corsivo, link, codice, spoiler e citazioni, e il codice delimitato mantiene il contenuto e la spaziatura letterali, compresi gli esempi di delimitatori all’interno del blocco; i blocchi esclusivi dei messaggi avanzati della Bot API 10.3, cioè tabelle native, dettagli, contenuti multimediali avanzati e formule, non vengono usati a meno che tu non li attivi.
• Con il flag dei messaggi avanzati attivo, all’agente viene comunicato che i messaggi avanzati sono disponibili per questo bot o account, con il contratto di scrittura supportato basato su Markdown e isole HTML; il Markdown viene reso tramite la rappresentazione intermedia Markdown di OpenClaw come blocchi avanzati tipizzati (titoli, tabelle, dettagli, checklist, contenuti multimediali avanzati, formule, mappe e collage), mentre le didascalie dei contenuti multimediali usano ancora didascalie HTML limitate a 1024 caratteri; il normale testo avanzato conserva gli spazi e gli a capo analizzati, le entità vengono decodificate una sola volta, i tag con escape restano testo visibile, l’HTML non supportato resta visibile senza sopprimere il Markdown al suo interno, il testo avanzato lungo viene suddiviso automaticamente secondo i limiti di Telegram, e le tabelle oltre il limite di 20 colonne ripiegano su un blocco di codice.
• Il flag è disattivato per impostazione predefinita per compatibilità con i client, perché alcuni client attuali Desktop, Web, Android e di terze parti mostrano come non supportati i messaggi avanzati accettati; lascialo disattivato a meno che ogni client usato con il bot non sia in grado di renderli, e il comando di stato mostra se la sessione corrente ha i messaggi avanzati attivati o no.
• Le anteprime dei link sono attive per impostazione predefinita, e la chiave dell’anteprima dei link impostata su false disattiva il rilevamento automatico delle entità per il testo avanzato; tenere il testo del modello lontano dai simboli del Markdown avanzato di Telegram è anche il motivo per cui un intervallo di valuta come da 400 a 600 K dollari non viene interpretato come una formula.

I pulsanti delle Mini App funzionano solo nelle chat private tra un utente e il bot.

Pulsanti inline

La funzionalità dei pulsanti inline ha cinque ambiti, off, dm, group, all e allowlist, con allowlist come valore predefinito, impostati a livello di canale e sovrascrivibili per account; la vecchia forma ad array corrisponde ad all, un account con un array di capacità vuoto eredita le capacità del canale, e un off esplicito disattiva i pulsanti. Lo strumento per fare domande all’utente usa questi controlli nativi per una sola domanda a scelta singola, una riga per ogni scelta, con una scelta Other che apre il campo di risposta di Telegram. Un’azione sui messaggi porta una presentazione con un blocco di pulsanti, ciascuno con un’etichetta, un’azione e uno stile facoltativo come success o danger; un’azione callback restituisce il suo valore, e un’azione web-app apre l’URL di una Mini App, cosa che funziona solo nelle chat private tra un utente e il bot. I valori di callback non rivendicati da un gestore interattivo di plugin registrato vengono passati all’agente come testo con il prefisso callback data. Con la ricezione persistente, la conferma della callback viene inviata subito dopo la memorizzazione dell’aggiornamento, senza attendere i gestori precedenti nella corsia di quella chat, così Telegram rimuove presto l’indicatore di caricamento, mentre l’azione del pulsante segue comunque la normale autorizzazione e l’elaborazione ordinata.

Azioni e approvazioni

• Le azioni sono send-message con una destinazione, un contenuto e, facoltativamente, un URL di contenuto multimediale, un ID di risposta e un ID di thread; react con una chat, un messaggio e un’emoji; emoji-list con chat e limite facoltativi; delete-message; edit-message con contenuto o didascalia e pulsanti inline facoltativi, dove una modifica dei soli pulsanti aggiorna il reply markup; e create-forum-topic con un nome e un colore dell’icona o un’emoji personalizzata facoltativi, più gli alias send, react, delete, edit, sticker, sticker-search e topic-create; gli interruttori di send-message, delete-message, reactions e sticker sono disattivati per impostazione predefinita, reactions copre sia react sia emoji-list, edit e le azioni sugli argomenti del forum sono attive senza un interruttore dedicato, e gli invii in fase di esecuzione usano l’istantanea di configurazione e segreti dell’avvio o del ricaricamento invece di risolvere di nuovo i riferimenti ai segreti a ogni invio.
• L’azione emoji-list ispeziona le reazioni consentite nella chat e nell’account attendibili correnti; gli agenti non possono ispezionare un’altra chat, mentre gli operatori diretti possono passare un ID di chat diverso; il limite predefinito è 100 e non può superare questo valore; una chat senza restrizioni restituisce le reazioni standard con una nota che dice che sono tutte consentite; una reazione rifiutata restituisce un breve campione di reazioni standard consentite e di identificatori di emoji personalizzate, a meno che la ricerca stessa non sia fallita; e un’emoji Unicode o un identificatore numerico di emoji personalizzata si passa direttamente a react.
• Le approvazioni exec funzionano nei messaggi diretti degli approvatori e possono facoltativamente pubblicare le richieste nella chat o nell’argomento di origine; gli approvatori devono essere ID utente numerici; la chiave enabled su auto le attiva quando almeno un approvatore è risolvibile; l’elenco degli approvatori ripiega sugli ID numerici dei proprietari presi dall’elenco degli autorizzati dei proprietari; la destinazione è dm per impostazione predefinita, con channel e both come alternative; i filtri per agente e sessione le restringono; gli elenchi degli autorizzati che decidono chi può parlare con il bot non rendono nessuno approvatore, anche se il primo abbinamento approvato inizializza l’elenco dei proprietari; la consegna nel canale mostra il testo del comando, quindi channel o both vanno usati solo in gruppi attendibili; una richiesta che arriva in un argomento del forum mantiene quell’argomento per il seguito; le approvazioni scadono dopo 30 minuti per impostazione predefinita; i pulsanti di approvazione inline richiedono che la funzionalità dei pulsanti consenta la superficie di destinazione; e gli ID di approvazione con prefisso plugin vengono risolti tramite le approvazioni dei plugin, mentre gli altri provano prima le approvazioni exec.

OpenClaw su Telegram è l’articolo sul canale che queste superfici estendono, mentre il comportamento dei messaggi Telegram in OpenClaw descrive il modello di consegna sottostante.

I pulsanti tra i canali

Il blocco dei pulsanti, il valore della callback e la richiesta di approvazione mantengono la stessa forma su ogni canale che ha componenti nativi, ed è per questo che un agente può fare una domanda sì o no senza sapere dove riceverà risposta. La guida a componenti e approvazioni Discord in OpenClaw mostra il lato Discord di questo contratto, mentre l’articolo sulle reazioni in OpenClaw descrive la semantica delle reazioni che react ed emoji-list implementano.

Su Diali

Telegram è uno dei canali che Diali collega dalla dashboard, e la configurazione del motore generata viene sostituita a ogni rilascio, quindi le chiavi di formattazione e dei pulsanti descritte qui indicano cosa può fare un bot ospitato, non impostazioni da modificare a mano. Telegram su Diali è la pagina del canale su Diali, mentre la pagina sulla sicurezza di Diali descrive il confine che si applica a ogni azione che un bot può compiere.

• HTML per impostazione predefinita; blocchi avanzati solo quando ogni client è in grado di renderli.
• I pulsanti seguono un ambito; le Mini App si aprono solo nelle chat private.
• Invii, eliminazioni, reazioni e sticker restano disattivati finché non vengono abilitati.