Developer and self-hosted

Tlon

Tlon è un messenger decentralizzato basato su Urbit. OpenClaw si connette alla tua ship Urbit e può rispondere ai messaggi diretti e ai messaggi di chat di gruppo. Per impostazione predefinita, le risposte nei gruppi richiedono una menzione @ e possono essere ulteriormente limitate tramite allowlist.

Stato: Plugin in bundle. Sono supportati messaggi diretti, menzioni nei gruppi, risposte nei thread, formattazione rich text e caricamenti di immagini. Reazioni e sondaggi non sono ancora supportati.

Plugin in bundle

Tlon viene distribuito come Plugin in bundle nelle versioni correnti di OpenClaw, quindi le normali build pacchettizzate non richiedono un'installazione separata.

Se usi una build precedente o un'installazione personalizzata che esclude Tlon, installa un pacchetto npm corrente:

Installa tramite CLI (registry npm):

openclaw plugins install @openclaw/tlon

Usa il pacchetto senza versione per seguire il tag di rilascio ufficiale corrente. Fissa una versione esatta solo quando ti serve un'installazione riproducibile.

Checkout locale (quando esegui da un repository git):

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

Dettagli: Plugin

Configurazione

Assicurati che il Plugin Tlon sia disponibile.
- Le versioni pacchettizzate correnti di OpenClaw lo includono già.
- Le installazioni precedenti/personalizzate possono aggiungerlo manualmente con i comandi sopra.
Recupera l'URL della tua ship e il codice di accesso.
Configura channels.tlon.
Riavvia il Gateway.
Invia un messaggio diretto al bot o menzionalo in un canale di gruppo.

Configurazione minima (account singolo):

{
  channels: {
    tlon: {
      enabled: true,
      ship: "~sampel-palnet",
      url: "https://your-ship-host",
      code: "lidlut-tabwed-pillex-ridrup",
      ownerShip: "~your-main-ship", // recommended: your ship, always allowed
    },
  },
}

Ship private/LAN

Per impostazione predefinita, OpenClaw blocca nomi host privati/interni e intervalli IP per la protezione SSRF. Se la tua ship è in esecuzione su una rete privata (localhost, IP LAN o nome host interno), devi abilitarlo esplicitamente:

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

Questo si applica a URL come:

http://localhost:8080
http://192.168.x.x:8080
http://my-ship.local:8080

⚠️ Abilita questa opzione solo se ti fidi della tua rete locale. Questa impostazione disabilita le protezioni SSRF per le richieste all'URL della tua ship.

Canali di gruppo

Il rilevamento automatico è abilitato per impostazione predefinita. Puoi anche fissare i canali manualmente:

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

Disabilita il rilevamento automatico:

{
  channels: {
    tlon: {
      autoDiscoverChannels: false,
    },
  },
}

Controllo accessi

Allowlist dei messaggi diretti (vuota = nessun messaggio diretto consentito, usa ownerShip per il flusso di approvazione):

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

Autorizzazione di gruppo (limitata per impostazione predefinita):

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

Owner e sistema di approvazione

Imposta una ship owner per ricevere richieste di approvazione quando utenti non autorizzati provano a interagire:

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

La ship owner è automaticamente autorizzata ovunque — gli inviti ai messaggi diretti vengono accettati automaticamente e i messaggi nei canali sono sempre consentiti. Non devi aggiungere l'owner a dmAllowlist o defaultAuthorizedShips.

Quando è impostata, l'owner riceve notifiche tramite messaggio diretto per:

Richieste di messaggi diretti da ship non presenti nell'allowlist
Menzioni in canali senza autorizzazione
Richieste di invito a gruppi

Impostazioni di accettazione automatica

Accetta automaticamente gli inviti ai messaggi diretti (per le ship in dmAllowlist):

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

Accetta automaticamente gli inviti ai gruppi da ship attendibili:

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

autoAcceptGroupInvites non accetta nulla quando groupInviteAllowlist è vuota. Imposta la allowlist sulle ship i cui inviti ai gruppi devono essere accettati automaticamente.

Destinazioni di consegna (CLI/Cron)

Usale con openclaw message send o con la consegna Cron:

DM: ~sampel-palnet o dm/~sampel-palnet
Gruppo: chat/~host-ship/channel o group:~host-ship/channel

Skill in bundle

Il Plugin Tlon include una skill in bundle (@tloncorp/tlon-skill) che fornisce accesso CLI alle operazioni Tlon:

Contatti: ottenere/aggiornare profili, elencare contatti
Canali: elencare, creare, pubblicare messaggi, recuperare cronologia
Gruppi: elencare, creare, gestire membri
Messaggi diretti: inviare messaggi, reagire ai messaggi
Reazioni: aggiungere/rimuovere reazioni emoji a post e messaggi diretti
Impostazioni: gestire le autorizzazioni del Plugin tramite comandi slash

La skill è disponibile automaticamente quando il Plugin è installato.

Funzionalità

Funzionalità	Stato
Messaggi diretti	✅ Supportati
Gruppi/canali	✅ Supportati (richiedono menzione per impostazione predefinita)
Thread	✅ Supportati (risposte automatiche nel thread)
Rich text	✅ Markdown convertito nel formato Tlon
Immagini	✅ Caricate nello storage Tlon
Reazioni	✅ Tramite skill in bundle
Sondaggi	❌ Non ancora supportati
Comandi nativi	✅ Supportati (solo owner per impostazione predefinita)

Risoluzione dei problemi

Esegui prima questa sequenza:

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor

Errori comuni:

Messaggi diretti ignorati: il mittente non è in dmAllowlist e non è configurato alcun ownerShip per il flusso di approvazione.
Messaggi di gruppo ignorati: canale non rilevato o mittente non autorizzato.
Errori di connessione: verifica che l'URL della ship sia raggiungibile; abilita allowPrivateNetwork per ship locali.
Errori di autenticazione: verifica che il codice di accesso sia corrente (i codici ruotano).

Riferimento di configurazione

Configurazione completa: Configurazione

Opzioni del provider:

channels.tlon.enabled: abilita/disabilita l'avvio del canale.
channels.tlon.ship: nome della ship Urbit del bot (ad es. ~sampel-palnet).
channels.tlon.url: URL della ship (ad es. https://sampel-palnet.tlon.network).
channels.tlon.code: codice di accesso della ship.
channels.tlon.allowPrivateNetwork: consenti URL localhost/LAN (bypass SSRF).
channels.tlon.ownerShip: ship owner per il sistema di approvazione (sempre autorizzata).
channels.tlon.dmAllowlist: ship autorizzate a inviare messaggi diretti (vuota = nessuna).
channels.tlon.autoAcceptDmInvites: accetta automaticamente messaggi diretti da ship presenti nell'allowlist.
channels.tlon.autoAcceptGroupInvites: accetta automaticamente inviti ai gruppi da ship presenti nell'allowlist.
channels.tlon.groupInviteAllowlist: ship i cui inviti ai gruppi possono essere accettati automaticamente.
channels.tlon.autoDiscoverChannels: rileva automaticamente i canali di gruppo (predefinito: true).
channels.tlon.groupChannels: nest di canale fissati manualmente.
channels.tlon.defaultAuthorizedShips: ship autorizzate per tutti i canali.
channels.tlon.authorization.channelRules: regole di autorizzazione per canale.
channels.tlon.showModelSignature: aggiungi il nome del modello ai messaggi.

Note

Le risposte nei gruppi richiedono una menzione (ad es. ~your-bot-ship) per rispondere.
Risposte nei thread: se il messaggio in ingresso è in un thread, OpenClaw risponde nel thread.
Rich text: la formattazione Markdown (grassetto, corsivo, codice, intestazioni, elenchi) viene convertita nel formato nativo di Tlon.
Immagini: gli URL vengono caricati nello storage Tlon e incorporati come blocchi immagine.

Correlati

Panoramica dei canali — tutti i canali supportati
Pairing — autenticazione tramite messaggi diretti e flusso di pairing
Gruppi — comportamento delle chat di gruppo e controllo tramite menzioni
Instradamento dei canali — instradamento delle sessioni per i messaggi
Sicurezza — modello di accesso e hardening

# Plugin in bundle

# Configurazione

# Ship private/LAN

# Canali di gruppo

# Controllo accessi

# Owner e sistema di approvazione

# Impostazioni di accettazione automatica

# Destinazioni di consegna (CLI/Cron)

# Skill in bundle

# Funzionalità

# Risoluzione dei problemi

# Riferimento di configurazione

# Note

# Correlati