Tlon

Tlon es un mensajero descentralizado creado sobre Urbit. OpenClaw se conecta a tu nave de Urbit y responde a mensajes directos y mensajes de chats grupales. De forma predeterminada, las respuestas en grupos requieren una mención @, además de reglas de autorización y un flujo de aprobación del propietario.

Estado: plugin incluido. Se admiten mensajes directos, menciones en grupos, hilos, texto enriquecido, carga y descarga de imágenes y un sistema de aprobación del propietario. No se admiten reacciones ni encuestas.

Plugin incluido

Tlon se incluye en las versiones actuales de OpenClaw; las compilaciones empaquetadas no necesitan una instalación independiente.

En una compilación anterior o una instalación personalizada que lo excluya, instálalo desde npm:

openclaw plugins install @openclaw/tlon

Usa el nombre de paquete sin versión para seguir la etiqueta de la versión actual. Fija una versión (@openclaw/tlon@x.y.z) solo para instalaciones reproducibles.

Desde un repositorio local:

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

Detalles: Plugins

Configuración

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

O edita directamente la configuración:

{  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 authorized    },  },}

Reinicia el Gateway después de editar directamente la configuración. Luego envía un mensaje directo al bot o menciónalo con @ en un canal grupal.

Naves privadas o de LAN

De forma predeterminada, OpenClaw bloquea los nombres de host internos o privados y los intervalos de IP privados para proteger contra SSRF. Si tu nave se ejecuta en una red privada (localhost, IP de LAN o nombre de host interno), habilítala explícitamente:

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

Esto se aplica a destinos como http://localhost:8080, http://192.168.x.x:8080 y http://my-ship.local:8080. Habilítalo únicamente para una URL de nave en la que confíes; desactiva la protección contra SSRF para las solicitudes HTTP de esa cuenta.

Canales grupales

Fija canales manualmente o activa la detección automática:

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

El valor predeterminado de autoDiscoverChannels es false cuando no se especifica en la configuración; el asistente de configuración propone sí de forma predeterminada y escribe true explícitamente. Cuando está activado, OpenClaw consulta mediante scry los grupos unidos al iniciarse, observa los canales nuevos a medida que se aceptan invitaciones a grupos y vuelve a comprobarlos cada 2 minutos.

Control de acceso

Lista de permitidos para mensajes directos (vacía = no se permite ningún mensaje directo, salvo que el remitente sea ownerShip):

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

La autorización de grupos utiliza restricted de forma predeterminada en cada canal. Establece defaultAuthorizedShips como base y sobrescríbela para cada nido de canal:

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

Una vez que el bot haya respondido dentro de un hilo, seguirá respondiendo a los mensajes posteriores de ese hilo sin requerir otra mención.

Propietario y sistema de aprobación

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

La nave propietaria está autorizada en todas partes: sus invitaciones a mensajes directos siempre se aceptan automáticamente, sus invitaciones a grupos siempre se aceptan automáticamente y sus mensajes en canales siempre superan la autorización. No es necesario que el propietario esté en dmAllowlist, defaultAuthorizedShips ni groupInviteAllowlist.

Cuando se establece ownerShip, las solicitudes no autorizadas no se descartan sin más: se ponen en cola como aprobaciones pendientes y se envía un mensaje directo al propietario:

• Solicitudes de mensajes directos de naves que no están en dmAllowlist
• Menciones en canales donde el remitente no supera la autorización
• Invitaciones a grupos de naves que no están en groupInviteAllowlist (cuando la aceptación automática está desactivada o está activada, pero el remitente de la invitación no figura en la lista de permitidos)

El propietario responde por mensaje directo para actuar sobre una solicitud:

Si no se configura ownerShip, los mensajes directos y las menciones en canales no autorizados simplemente se descartan y se registran; no se muestra ninguna solicitud de aprobación.

Ajustes de aceptación automática

Acepta automáticamente invitaciones a mensajes directos de naves que ya estén en dmAllowlist (el propietario siempre se acepta automáticamente, independientemente de este indicador):

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

Acepta automáticamente invitaciones a grupos desde una lista de permitidos (falla de forma cerrada: con autoAcceptGroupInvites: true y una groupInviteAllowlist vacía, no se acepta ninguna invitación que no sea del propietario):

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

Recarga en caliente mediante el almacén de ajustes de Urbit

La mayoría de los ajustes anteriores (dmAllowlist, groupInviteAllowlist, groupChannels, defaultAuthorizedShips, autoDiscoverChannels, autoAcceptDmInvites, autoAcceptGroupInvites, ownerShip, showModelSignature) se reflejan en el agente %settings de la nave (escritorio moltbot, depósito tlon) durante la primera ejecución y, a partir de entonces, se leen desde allí en tiempo real. Por tanto, los cambios realizados mediante un cliente Landscape o los comandos de ajustes de la habilidad incluida se aplican sin reiniciar el Gateway. channelRules y las aprobaciones pendientes también se conservan allí como JSON. La configuración del archivo sigue siendo la fuente de verdad para los valores que nunca se escriben en el almacén de ajustes.

Destinos de entrega (CLI/cron)

Úsalos con openclaw message send o la entrega mediante cron:

• Mensaje directo: ~sampel-palnet o dm/~sampel-palnet
• Grupo: chat/~host-ship/channel o group:~host-ship/channel

Habilidad incluida

El plugin incluye @tloncorp/tlon-skill, una CLI para realizar operaciones directas en Urbit, disponible automáticamente una vez instalado el plugin:

• Actividad: menciones, respuestas, mensajes no leídos
• Canales: listar, crear, cambiar el nombre
• Contactos: listar, obtener y actualizar perfiles
• Grupos: crear, unirse, flujos de invitación y solicitud, roles
• Hooks: administrar hooks de canales
• Mensajes: historial, búsqueda
• Mensajes directos: enviar, reaccionar, aceptar o rechazar
• Publicaciones: reaccionar, eliminar
• Cuaderno: publicar en canales de diario
• Ajustes: recargar en caliente la configuración del plugin mediante el almacén de ajustes anterior

Capacidades

Solución de problemas

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctor

Errores habituales:

• Se ignoran los mensajes directos: el remitente no está en dmAllowlist y no se ha configurado ownerShip para el flujo de aprobación.
• Se ignoran los mensajes grupales: el canal no se ha detectado o fijado, o el remitente no supera la autorización y no hay ningún ownerShip para poner una aprobación en cola.
• Errores de conexión: comprueba que se pueda acceder a la URL de la nave; establece network.dangerouslyAllowPrivateNetwork para las naves locales.
• Errores de autenticación: los códigos de inicio de sesión rotan; copia el código actual de tu nave.

Referencia de configuración

Configuración completa: Configuración

Notas

• Las respuestas en grupos necesitan una mención @ (p. ej., ~your-bot-ship), salvo que el bot ya se haya unido a ese hilo.
• Las respuestas a hilos se publican dentro del hilo; el bot también recibe antepuestos los últimos 10 mensajes del contexto del hilo para el agente.
• El texto enriquecido (negrita, cursiva, código, encabezados y listas) se convierte al formato nativo de Tlon.
• Enviar un mensaje entrante que solicite un resumen del canal (por ejemplo, «resume este canal») activa un resumen integrado del historial en lugar del flujo de respuesta normal.

Contenido relacionado

• Descripción general de los canales — todos los canales admitidos
• Vinculación — flujo de autenticación y vinculación de mensajes directos
• Grupos — comportamiento de los chats grupales y requisito de menciones
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y protección