Le regole push di Matrix in OpenClaw per le anteprime silenziose

Lo streaming quiet risolve metà del problema delle notifiche su Matrix: il bot smette di suonare a ogni modifica. L’altra metà è lato homeserver, perché solo una regola push sull’account del destinatario può dire quale modifica merita una notifica. Questa pagina è per gli operatori che ospitano in proprio Synapse o Tuwunel e vogliono installare quella regola per ogni destinatario. Ecco il meccanismo, i passaggi, la regola per più bot e le due note sugli homeserver.

Il meccanismo

• Con la modalità di streaming impostata su quiet, OpenClaw trasmette la risposta modificando sul posto un unico evento di anteprima; le anteprime vengono inviate come eventi notice che non generano notifiche, la modifica finale viene contrassegnata con una proprietà finalised-preview di OpenClaw, e i client notificano su quella modifica finale solo se una regola push per utente corrisponde al marcatore.
• La modalità progress finalizza le sue bozze attraverso lo stesso percorso, quindi la stessa regola scatta anche per le modifiche finalizzate in modalità progress, e gli operatori che vogliono solo il comportamento standard delle notifiche usano la modalità partial o lasciano lo streaming disattivato.
• I prerequisiti sono un utente destinatario che deve ricevere la notifica, l’utente bot che invia la risposta, il token di accesso del destinatario per le chiamate API, l’ID Matrix completo del bot come corrispondenza del mittente nella regola, e un account destinatario che abbia già pusher funzionanti, perché le regole per le anteprime quiet funzionano solo quando la normale consegna delle notifiche push è in salute.
• I passaggi iniziano configurando la modalità quiet nel blocco del canale e ottenendo il token di accesso del destinatario, riutilizzando se possibile il token di una sessione client esistente o generandone uno con una richiesta di login con password all’homeserver, ed esportandolo per le chiamate successive.

Le regole push hanno come chiave il ruleId: rieseguire PUT sullo stesso ID aggiorna un’unica regola.

Installare la regola

Verifica i pusher con l’endpoint dei pusher usando il token del destinatario, e se non ne torna nessuno sistema la normale consegna delle notifiche push per quell’account prima di continuare. Poi installa una regola push override con un ID di regola univoco per bot e per destinatario, seguendo lo schema finalised-preview con il nome del bot, le cui quattro condizioni corrispondono a un tipo di evento messaggio di stanza, a un tipo di relazione replace, alla proprietà finalised-preview impostata su true e al mittente uguale all’ID completo del bot, con le azioni notify, il tweak sound predefinito e highlight disattivato; sostituisci l’URL dell’homeserver, il token, l’ID della regola e l’ID del bot, ricordando che il mittente è il bot e non il destinatario. Verifica recuperando lo stesso URL della regola, poi prova una risposta in streaming: in modalità quiet la stanza mostra un’anteprima di bozza silenziosa e notifica quando il blocco o il turno finisce, e la regola si rimuove in seguito eliminando lo stesso URL con il token del destinatario.

Più bot e più homeserver

• Le regole push hanno come chiave l’ID della regola, quindi rieseguire l’installazione sullo stesso ID aggiorna un’unica regola, e più bot OpenClaw che notificano lo stesso destinatario richiedono una regola per bot con una corrispondenza del mittente distinta; le nuove regole override definite dall’utente vengono inserite prima delle regole suppress predefinite del server, quindi non serve alcun parametro di ordinamento.
• La regola riguarda solo le modifiche di anteprima solo testuali che possono essere finalizzate sul posto: le risposte con media, i fallback per anteprime obsolete e i testi finali che attiverebbero menzioni Matrix vengono invece consegnati come normali messaggi con notifica.
• Synapse non richiede alcuna modifica alla configurazione dell’homeserver, solo che il percorso delle regole push raggiunga Synapse attraverso qualsiasi proxy o configurazione di worker e che il processo dei pusher sia in salute, e poiché la regola usa la condizione event-property-is aggiunta a Synapse nel 2023, le release più vecchie accettano la chiamata di installazione ma silenziosamente non trovano mai corrispondenze, quindi una modifica finale che non notifica mai significa che devi aggiornare; Tuwunel segue lo stesso flusso senza configurazione specifica, e le notifiche che spariscono mentre l’utente è attivo altrove indicano la sua opzione suppress-push-when-active aggiunta nella 1.4.2, che sopprime intenzionalmente le notifiche push verso gli altri dispositivi mentre uno è attivo.

OpenClaw su Matrix è l’articolo sul canale a cui serve questa regola, mentre la guida al comportamento dei messaggi Matrix in OpenClaw descrive la modalità di streaming quiet che la regola completa.

Una regola per destinatario, per bot

Il design lascia la decisione dal lato del destinatario: il bot si limita a contrassegnare la sua modifica finale, e ogni persona installa una regola che dice se quel marcatore debba far suonare una notifica, bot per bot, ed è per questo che l’ID della regola contiene il nome del bot. La guida ad account e homeserver Matrix in OpenClaw copre l’esecuzione di più account bot su un unico homeserver, mentre la guida alla cifratura Matrix in OpenClaw spiega la verifica che mantiene attendibili quegli account.

Su Diali

Matrix è nell’elenco dei canali collegabili di Diali, insieme a WhatsApp, Telegram, Discord, Slack, Mattermost, SMS e voce: l’account sull’homeserver e l’elenco delle stanze autorizzate sono tuoi, il Gateway è nostro. OpenClaw ospitato su Diali è l’assistente e la pagina sulla sicurezza di Diali descrive il confine che si applica a ogni canale collegato.

• La modalità quiet contrassegna la modifica finale; la regola del destinatario la fa suonare.
• Prima pusher funzionanti, poi la regola override.
• Un Synapse vecchio accetta la regola ma non trova mai corrispondenze.