Tlon

Tlon es un mensajero descentralizado creado sobre Urbit. OpenClaw se conecta a la nave de Urbit y responde a mensajes directos y mensajes de chats grupales. De forma predeterminada, las respuestas grupales requieren una mención con @, con reglas de autorización y un flujo de aprobación del propietario añadidos como capas adicionales.

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 antigua o una instalación personalizada que lo excluya, instálelo desde npm:

openclaw plugins install @openclaw/tlon

Use el nombre simple del paquete para seguir la etiqueta de la versión actual. Fije una versión (@openclaw/tlon@x.y.z) solo para instalaciones reproducibles.

Desde un checkout 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 edite 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", // recomendado: su nave, siempre autorizada    },  },}

Reinicie el Gateway después de editar directamente la configuración. A continuación, envíe un mensaje directo al bot o menciónelo con @ en un canal grupal.

Durabilidad de la entrada

OpenClaw conserva los eventos aceptados de mensajes directos y chats grupales de Tlon antes de enviarlos al agente. Los turnos pendientes o reintentables sobreviven a un reinicio del Gateway, y el trabajo permanece serializado por canal grupal o interlocutor directo. Los identificadores estables de mensajes de Urbit también suprimen un evento vuelto a entregar mientras exista su registro en la cola o su registro de finalización retenido.

La entrega se realiza al menos una vez en el límite entre la cola y el agente: un fallo durante la transferencia puede reproducir un turno. Por lo tanto, las acciones del agente que produzcan efectos secundarios externos deben permanecer idempotentes siempre que resulte práctico.

Naves privadas o de LAN

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

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

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

Canales grupales

Fije los canales manualmente o active el descubrimiento automático:

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

autoDiscoverChannels adopta de forma predeterminada false cuando no se establece en la configuración; el asistente de configuración establece de forma predeterminada la respuesta sí y escribe true explícitamente. Cuando está activado, OpenClaw consulta los grupos unidos durante el inicio, 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 adopta de forma predeterminada restricted para cada canal. Establezca defaultAuthorizedShips como base y sobrescríbala para cada anidamiento 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.

Establezca channels.tlon.implicitMentions.threadParticipation: false para exigir una nueva mención explícita en esos mensajes de seguimiento. Las sobrescrituras de cuenta usan channels.tlon.accounts.<id>.implicitMentions. Actualmente, Tlon no produce datos replyToBot ni quotedBot, por lo que esas opciones no tienen efecto aquí.

Propietario y sistema de aprobación

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

La nave del propietario está autorizada en todas partes: las invitaciones a mensajes directos siempre se aceptan automáticamente, las invitaciones a grupos se aceptan siempre automáticamente y los mensajes de los 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 pone en cola una aprobación pendiente 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 activada pero el remitente de la invitación no está 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 de canal no autorizados simplemente se descartan y registran; no se muestra ninguna solicitud de aprobación.

Ajustes de aceptación automática

Acepte automáticamente las invitaciones a mensajes directos de naves que ya estén en dmAllowlist (el propietario siempre se acepta automáticamente, independientemente de esta opción):

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

Acepte automáticamente las invitaciones a grupos de una lista de permitidos (fallo seguro: con autoAcceptGroupInvites: true y un valor vacío para groupInviteAllowlist, no se acepta ninguna invitación de alguien que no sea el 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 después se leen en tiempo real desde allí, por lo que los cambios realizados mediante un cliente de Landscape o los comandos de ajustes de la skill incluida se aplican sin reiniciar el Gateway. channelRules y las aprobaciones pendientes también se conservan allí como JSON. La configuración de 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)

Úselos 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

Skill incluida

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

• Actividad: menciones, respuestas, mensajes no leídos
• Canales: enumerar, crear, cambiar el nombre
• Contactos: enumerar, obtener y actualizar perfiles
• Grupos: crear, unirse, flujos de invitación o 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

Fallos habituales:

• Mensajes directos ignorados: el remitente no está en dmAllowlist y no se ha configurado ownerShip para el flujo de aprobación.
• Mensajes grupales ignorados: el canal no se ha descubierto ni 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: compruebe que se pueda acceder a la URL de la nave; establezca network.dangerouslyAllowPrivateNetwork para naves locales.
• Errores de autenticación: los códigos de inicio de sesión rotan; copie el código actual de la nave.

Referencia de configuración

Configuración completa: Configuración

Notas

• Las respuestas de grupo necesitan una mención con @ (p. ej., ~your-bot-ship), a menos 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, 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 normal de respuestas.

Contenido relacionado

• Descripción general de los canales — todos los canales compatibles
• Vinculación — autenticación por mensaje directo y flujo de vinculación
• Grupos — comportamiento del chat grupal y requisito de menciones
• Enrutamiento de canales — enrutamiento de sesiones para mensajes
• Seguridad — modelo de acceso y refuerzo de la seguridad