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.

channels.tlon.allowPrivateNetwork (clave plana) se ha retirado. openclaw doctor --fix la traslada a channels.tlon.network.dangerouslyAllowPrivateNetwork automáticamente.

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:

Respuesta del propietario	Efecto
`approve` / `deny` / `block`	Actúa sobre la aprobación pendiente más reciente
`approve <id>` / `deny <id>`	Actúa sobre una aprobación específica mediante su id
`block`	También bloquea la nave de forma nativa para impedir que vuelva a conectarse
`unblock ~ship`	Revierte un bloqueo nativo
`blocked`	Enumera las naves bloqueadas actualmente
`pending`	Enumera las solicitudes de aprobación pendientes

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

Función	Estado
Mensajes directos	Admitidos
Grupos/canales	Admitidos (requieren mención de forma predeterminada)
Hilos	Admitidos (continúa respondiendo una vez que se ha unido)
Texto enriquecido	Markdown convertido al formato nativo de Tlon
Imágenes	Se descargan al recibirlas y se cargan al enviarlas
Reacciones	Solo mediante la skill incluida
Encuestas	No admitidas
Comandos nativos	Solo para el propietario de forma predeterminada

Solución de problemas

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw 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

Clave	Significado
`channels.tlon.enabled`	Habilita o deshabilita el inicio del canal.
`channels.tlon.ship`	Nombre de la nave de Urbit del bot (p. ej., `~sampel-palnet`).
`channels.tlon.url`	URL de la nave (p. ej., `https://sampel-palnet.tlon.network`).
`channels.tlon.code`	Código de inicio de sesión de la nave.
`channels.tlon.network.dangerouslyAllowPrivateNetwork`	Permite URL de naves en localhost o LAN (habilitación explícita de SSRF).
`channels.tlon.ownerShip`	Nave del propietario: siempre autorizada, recibe solicitudes de aprobación.
`channels.tlon.dmAllowlist`	Naves que pueden enviar mensajes directos (vacío = ninguna salvo el propietario).
`channels.tlon.autoAcceptDmInvites`	Acepta automáticamente mensajes directos de naves en `dmAllowlist`.
`channels.tlon.autoAcceptGroupInvites`	Acepta automáticamente invitaciones a grupos de `groupInviteAllowlist`.
`channels.tlon.groupInviteAllowlist`	Naves cuyas invitaciones a grupos se aceptan automáticamente.
`channels.tlon.autoDiscoverChannels`	Descubre automáticamente los canales grupales unidos (valor predeterminado: `false`).
`channels.tlon.implicitMentions.threadParticipation`	Permite que los seguimientos de hilos en los que se ha participado omitan el requisito de mención.
`channels.tlon.groupChannels`	Anidamientos de canales fijados manualmente.
`channels.tlon.defaultAuthorizedShips`	Naves autorizadas para todos los canales (se usa cuando ninguna regla coincide).
`channels.tlon.authorization.channelRules`	Modo de autenticación y lista de permitidos por anidamiento de canal.
`channels.tlon.showModelSignature`	Añade `_[Generated by <model>]_` a las respuestas.
`channels.tlon.responsePrefix`	Prefijo estático que se antepone a las respuestas salientes.
`channels.tlon.accounts.<id>`	Cuentas adicionales con nombre (configuraciones con varias naves).

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

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Plugin incluido

Configuración

Durabilidad de la entrada

Naves privadas o de LAN

Canales grupales

Control de acceso

Propietario y sistema de aprobación

Ajustes de aceptación automática

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

Destinos de entrega (CLI/Cron)

Skill incluida

Capacidades

Solución de problemas

Referencia de configuración

Notas

Contenido relacionado

​Plugin incluido

​Configuración

​Durabilidad de la entrada

​Naves privadas o de LAN

​Canales grupales

​Control de acceso

​Propietario y sistema de aprobación

​Ajustes de aceptación automática

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

​Destinos de entrega (CLI/Cron)

​Skill incluida

​Capacidades

​Solución de problemas

​Referencia de configuración

​Notas

​Contenido relacionado

Plugin incluido

Configuración

Durabilidad de la entrada

Naves privadas o de LAN

Canales grupales

Control de acceso

Propietario y sistema de aprobación

Ajustes de aceptación automática

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

Destinos de entrega (CLI/Cron)

Skill incluida

Capacidades

Solución de problemas

Referencia de configuración

Notas

Contenido relacionado