Tlon

Tlon è un servizio di messaggistica decentralizzato basato su Urbit. OpenClaw si connette alla tua nave Urbit e risponde ai messaggi diretti e ai messaggi delle chat di gruppo. Per impostazione predefinita, le risposte nei gruppi richiedono una menzione @, con regole di autorizzazione e un flusso di approvazione del proprietario aggiuntivi.

Stato: plugin incluso. Sono supportati messaggi diretti, menzioni nei gruppi, thread, testo formattato, caricamento/scaricamento di immagini e un sistema di approvazione del proprietario. Reazioni e sondaggi non sono supportati.

Plugin incluso

Tlon è incluso nelle versioni attuali di OpenClaw; le build distribuite non richiedono un'installazione separata.

In una build precedente o in un'installazione personalizzata che lo esclude, installalo da npm:

openclaw plugins install @openclaw/tlon

Usa il nome semplice del pacchetto per seguire il tag della versione corrente. Blocca una versione (@openclaw/tlon@x.y.z) solo per installazioni riproducibili.

Da un checkout locale:

openclaw plugins install ./path/to/local/tlon-plugin

Dettagli: Plugin

Configurazione

openclaw channels add --channel tlon --ship ~sampel-palnet --url https://your-ship-host --code lidlut-tabwed-pillex-ridrup

In alternativa, modifica direttamente la configurazione:

{  channels: {    tlon: {      enabled: true,      ship: "~sampel-palnet",      url: "https://your-ship-host",      code: "lidlut-tabwed-pillex-ridrup",      ownerShip: "~your-main-ship", // consigliato: la tua nave, sempre autorizzata    },  },}

Riavvia il Gateway dopo aver modificato direttamente la configurazione. Quindi invia un messaggio diretto al bot oppure menzionalo con @ in un canale di gruppo.

Navi private/LAN

Per impostazione predefinita, OpenClaw blocca nomi host e intervalli IP privati/interni per proteggere dagli attacchi SSRF. Se la tua nave è in esecuzione su una rete privata (localhost, IP LAN, nome host interno), abilitala esplicitamente:

{  channels: {    tlon: {      url: "http://localhost:8080",      network: {        dangerouslyAllowPrivateNetwork: true,      },    },  },}

Si applica a destinazioni quali http://localhost:8080, http://192.168.x.x:8080 e http://my-ship.local:8080. Abilita questa opzione solo per l'URL di una nave attendibile; disabilita la protezione SSRF per le richieste HTTP di quell'account.

Canali di gruppo

Fissa manualmente i canali oppure attiva il rilevamento automatico:

{  channels: {    tlon: {      groupChannels: ["chat/~host-ship/general", "chat/~host-ship/support"],      autoDiscoverChannels: true,    },  },}

Quando non è impostato nella configurazione, il valore predefinito di autoDiscoverChannels è false; la procedura guidata di configurazione propone sì come risposta predefinita e scrive esplicitamente true. Quando è attivo, OpenClaw esegue lo scry dei gruppi a cui si è iscritti all'avvio, monitora i nuovi canali man mano che gli inviti ai gruppi vengono accettati e ricontrolla ogni 2 minuti.

Controllo degli accessi

Elenco consentiti per i messaggi diretti (vuoto = nessun messaggio diretto consentito, a meno che il mittente non sia ownerShip):

{  channels: {    tlon: {      dmAllowlist: ["~zod", "~nec"],    },  },}

Per impostazione predefinita, l'autorizzazione dei gruppi è restricted per ogni canale. Imposta defaultAuthorizedShips come base e applica sostituzioni per ogni nest di canale:

{  channels: {    tlon: {      defaultAuthorizedShips: ["~zod"],      authorization: {        channelRules: {          "chat/~host-ship/general": {            mode: "restricted",            allowedShips: ["~zod", "~nec"],          },          "chat/~host-ship/announcements": {            mode: "open",          },        },      },    },  },}

Dopo che il bot ha risposto all'interno di un thread, continua a rispondere ai messaggi successivi in quel thread senza richiedere un'altra menzione.

Proprietario e sistema di approvazione

{  channels: {    tlon: {      ownerShip: "~your-main-ship",    },  },}

La nave del proprietario è autorizzata ovunque: gli inviti ai messaggi diretti vengono sempre accettati automaticamente, gli inviti ai gruppi vengono sempre accettati automaticamente e i messaggi dei canali superano sempre l'autorizzazione. Non è necessario che il proprietario sia presente in dmAllowlist, defaultAuthorizedShips o groupInviteAllowlist.

Quando ownerShip è impostato, le richieste non autorizzate non vengono semplicemente ignorate: vengono aggiunte alla coda delle approvazioni in sospeso e viene inviato un messaggio diretto al proprietario:

• Richieste di messaggi diretti da navi non presenti in dmAllowlist
• Menzioni in canali in cui il mittente non supera l'autorizzazione
• Inviti ai gruppi da navi non presenti in groupInviteAllowlist (quando l'accettazione automatica è disattivata, oppure è attiva ma chi ha inviato l'invito non è nell'elenco consentiti)

Il proprietario risponde tramite messaggio diretto per intervenire su una richiesta:

Senza ownerShip configurato, i messaggi diretti e le menzioni nei canali non autorizzati vengono semplicemente ignorati e registrati; non viene mostrata alcuna richiesta di approvazione.

Impostazioni di accettazione automatica

Accetta automaticamente gli inviti ai messaggi diretti dalle navi già presenti in dmAllowlist (il proprietario viene sempre accettato automaticamente indipendentemente da questo flag):

{  channels: {    tlon: {      autoAcceptDmInvites: true,    },  },}

Accetta automaticamente gli inviti ai gruppi da un elenco consentiti (in caso di dubbio, rifiuta: con autoAcceptGroupInvites: true e un groupInviteAllowlist vuoto, non viene accettato alcun invito da parte di soggetti diversi dal proprietario):

{  channels: {    tlon: {      autoAcceptGroupInvites: true,      groupInviteAllowlist: ["~zod"],    },  },}

Ricaricamento a caldo tramite l'archivio delle impostazioni di Urbit

La maggior parte delle impostazioni precedenti (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) viene replicata nell'agente %settings della nave (desk moltbot, bucket tlon) al primo avvio e poi letta in tempo reale da lì, quindi le modifiche apportate tramite un client Landscape o i comandi per le impostazioni della skill inclusa vengono applicate senza riavviare il Gateway. Anche channelRules e le approvazioni in sospeso vengono archiviate lì in formato JSON. La configurazione nel file rimane la fonte autorevole per i valori mai scritti nell'archivio delle impostazioni.

Destinazioni di consegna (CLI/cron)

Da usare con openclaw message send o la consegna tramite cron:

• Messaggio diretto: ~sampel-palnet o dm/~sampel-palnet
• Gruppo: chat/~host-ship/channel o group:~host-ship/channel

Skill inclusa

Il plugin include @tloncorp/tlon-skill, una CLI per operazioni dirette su Urbit, disponibile automaticamente dopo l'installazione del plugin:

• Attività: menzioni, risposte, elementi non letti
• Canali: elencare, creare, rinominare
• Contatti: elencare/ottenere/aggiornare i profili
• Gruppi: creare, partecipare, flussi di invito/richiesta, ruoli
• Hook: gestire gli hook dei canali
• Messaggi: cronologia, ricerca
• Messaggi diretti: inviare, reagire, accettare/rifiutare
• Post: reagire, eliminare
• Taccuino: pubblicare nei canali diario
• Impostazioni: ricaricare a caldo la configurazione del plugin tramite l'archivio delle impostazioni descritto sopra

Funzionalità

Risoluzione dei problemi

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Problemi comuni:

• Messaggi diretti ignorati: il mittente non è presente in dmAllowlist e non è configurato alcun ownerShip per il flusso di approvazione.
• Messaggi di gruppo ignorati: il canale non è stato rilevato/fissato oppure il mittente non supera l'autorizzazione e non è presente alcun ownerShip a cui accodare un'approvazione.
• Errori di connessione: verifica che l'URL della nave sia raggiungibile; imposta network.dangerouslyAllowPrivateNetwork per le navi locali.
• Errori di autenticazione: i codici di accesso cambiano; copia il codice corrente dalla tua nave.

Riferimento per la configurazione

Configurazione completa: Configurazione

Note

• Le risposte nei gruppi richiedono una menzione @ (ad es. ~your-bot-ship), a meno che il bot non abbia già partecipato a quel thread.
• Le risposte ai thread vengono pubblicate nel thread; inoltre, al bot vengono anteposti gli ultimi 10 messaggi del contesto del thread per l'agente.
• Il testo formattato (grassetto, corsivo, codice, intestazioni, elenchi) viene convertito nel formato nativo di Tlon.
• L'invio di un messaggio in entrata che richiede un riepilogo del canale (ad esempio "riassumi questo canale") attiva un riepilogo integrato della cronologia anziché il normale flusso di risposta.

Contenuti correlati

• Panoramica dei canali — tutti i canali supportati
• Associazione — flusso di autenticazione e associazione dei messaggi diretti
• Gruppi — comportamento delle chat di gruppo e requisito di menzione
• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Sicurezza — modello di accesso e rafforzamento della sicurezza