Developer and self-hosted

Tlon

Tlon es un mensajero descentralizado construido sobre Urbit. OpenClaw se conecta a tu ship de Urbit y puede responder a MD y mensajes de chat grupal. Las respuestas en grupo requieren una mención @ de forma predeterminada y pueden restringirse aún más mediante listas de permitidos.

Estado: plugin incluido. Se admiten MD, menciones en grupos, respuestas en hilos, formato de texto enriquecido y cargas de imágenes. Las reacciones y las encuestas aún no son compatibles.

Plugin incluido

Tlon se distribuye como un plugin incluido en las versiones actuales de OpenClaw, por lo que las compilaciones empaquetadas normales no necesitan una instalación separada.

Si estás usando una compilación anterior o una instalación personalizada que excluye Tlon, instala un paquete npm actual:

Instalar mediante CLI (registro npm):

openclaw plugins install @openclaw/tlon

Usa el paquete básico para seguir la etiqueta de lanzamiento oficial actual. Fija una versión exacta solo cuando necesites una instalación reproducible.

Checkout local (al ejecutar desde un repositorio git):

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

Detalles: Plugins

Configuración

Asegúrate de que el plugin de Tlon esté disponible.
- Las versiones empaquetadas actuales de OpenClaw ya lo incluyen.
- Las instalaciones anteriores/personalizadas pueden añadirlo manualmente con los comandos anteriores.
Reúne la URL de tu ship y el código de inicio de sesión.
Configura channels.tlon.
Reinicia el gateway.
Envía un MD al bot o menciónalo en un canal de grupo.

Configuración mínima (una sola cuenta):

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

Ships privadas/LAN

De forma predeterminada, OpenClaw bloquea nombres de host y rangos de IP privados/internos para protección contra SSRF. Si tu ship se ejecuta en una red privada (localhost, IP de LAN o nombre de host interno), debes habilitarlo explícitamente:

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

Esto se aplica a URL como:

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

⚠️ Habilita esto solo si confías en tu red local. Esta opción desactiva las protecciones contra SSRF para las solicitudes a la URL de tu ship.

Canales de grupo

El descubrimiento automático está habilitado de forma predeterminada. También puedes fijar canales manualmente:

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

Desactivar el descubrimiento automático:

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

Control de acceso

Lista de permitidos para MD (vacía = no se permiten MD, usa ownerShip para el flujo de aprobación):

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

Autorización de grupos (restringida de forma predeterminada):

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

Sistema de propietario y aprobación

Define una ship propietaria para recibir solicitudes de aprobación cuando usuarios no autorizados intenten interactuar:

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

La ship propietaria está autorizada automáticamente en todas partes: las invitaciones de MD se aceptan automáticamente y los mensajes de canal siempre se permiten. No necesitas añadir el propietario a dmAllowlist ni a defaultAuthorizedShips.

Cuando se configura, el propietario recibe notificaciones por MD para:

Solicitudes de MD de ships que no están en la lista de permitidos
Menciones en canales sin autorización
Solicitudes de invitación a grupos

Opciones de aceptación automática

Aceptar automáticamente invitaciones de MD (para ships en dmAllowlist):

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

Aceptar automáticamente invitaciones a grupos de ships de confianza:

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

autoAcceptGroupInvites falla de forma cerrada cuando groupInviteAllowlist está vacía. Define la lista de permitidos con las ships cuyas invitaciones a grupos deben aceptarse automáticamente.

Destinos de entrega (CLI/cron)

Úsalos con openclaw message send o entrega por cron:

MD: ~sampel-palnet o dm/~sampel-palnet
Grupo: chat/~host-ship/channel o group:~host-ship/channel

Skill incluida

El plugin de Tlon incluye una Skill incluida (@tloncorp/tlon-skill) que proporciona acceso mediante CLI a operaciones de Tlon:

Contactos: obtener/actualizar perfiles, listar contactos
Canales: listar, crear, publicar mensajes, obtener historial
Grupos: listar, crear, gestionar miembros
MD: enviar mensajes, reaccionar a mensajes
Reacciones: añadir/eliminar reacciones con emoji a publicaciones y MD
Configuración: gestionar permisos del plugin mediante comandos slash

La Skill está disponible automáticamente cuando el plugin está instalado.

Capacidades

Funcionalidad	Estado
Mensajes directos	✅ Compatible
Grupos/canales	✅ Compatible (requiere mención de forma predeterminada)
Hilos	✅ Compatible (respuestas automáticas en el hilo)
Texto enriquecido	✅ Markdown convertido al formato de Tlon
Imágenes	✅ Cargadas al almacenamiento de Tlon
Reacciones	✅ Mediante Skill incluida
Encuestas	❌ Aún no compatibles
Comandos nativos	✅ Compatibles (solo propietario de forma predeterminada)

Solución de problemas

Ejecuta primero esta secuencia:

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

Errores comunes:

MD ignorados: el remitente no está en dmAllowlist y no hay ningún ownerShip configurado para el flujo de aprobación.
Mensajes de grupo ignorados: el canal no se descubrió o el remitente no está autorizado.
Errores de conexión: comprueba que se pueda acceder a la URL de la ship; habilita allowPrivateNetwork para ships locales.
Errores de autenticación: verifica que el código de inicio de sesión esté vigente (los códigos rotan).

Referencia de configuración

Configuración completa: Configuración

Opciones del proveedor:

channels.tlon.enabled: habilitar/deshabilitar el inicio del canal.
channels.tlon.ship: nombre de la ship de Urbit del bot (p. ej., ~sampel-palnet).
channels.tlon.url: URL de la ship (p. ej., https://sampel-palnet.tlon.network).
channels.tlon.code: código de inicio de sesión de la ship.
channels.tlon.allowPrivateNetwork: permitir URL de localhost/LAN (omisión de SSRF).
channels.tlon.ownerShip: ship propietaria para el sistema de aprobación (siempre autorizada).
channels.tlon.dmAllowlist: ships autorizadas a enviar MD (vacía = ninguna).
channels.tlon.autoAcceptDmInvites: aceptar automáticamente MD de ships en la lista de permitidos.
channels.tlon.autoAcceptGroupInvites: aceptar automáticamente invitaciones a grupos de ships en la lista de permitidos.
channels.tlon.groupInviteAllowlist: ships cuyas invitaciones a grupos pueden aceptarse automáticamente.
channels.tlon.autoDiscoverChannels: descubrir automáticamente canales de grupo (predeterminado: true).
channels.tlon.groupChannels: nidos de canal fijados manualmente.
channels.tlon.defaultAuthorizedShips: ships autorizadas para todos los canales.
channels.tlon.authorization.channelRules: reglas de autorización por canal.
channels.tlon.showModelSignature: añadir el nombre del modelo a los mensajes.

Notas

Las respuestas de grupo requieren una mención (p. ej., ~your-bot-ship) para responder.
Respuestas en hilos: si el mensaje entrante está en un hilo, OpenClaw responde dentro del hilo.
Texto enriquecido: el formato Markdown (negrita, cursiva, código, encabezados, listas) se convierte al formato nativo de Tlon.
Imágenes: las URL se cargan al almacenamiento de Tlon y se insertan como bloques de imagen.

Relacionado

Resumen de canales — todos los canales compatibles
Emparejamiento — autenticación por MD y flujo de emparejamiento
Grupos — comportamiento de chat grupal y activación por mención
Enrutamiento de canales — enrutamiento de sesiones para mensajes
Seguridad — modelo de acceso y endurecimiento

# Plugin incluido

# Configuración

# Ships privadas/LAN

# Canales de grupo

# Control de acceso

# Sistema de propietario y aprobación

# Opciones de aceptación automática

# Destinos de entrega (CLI/cron)

# Skill incluida

# Capacidades

# Solución de problemas

# Referencia de configuración

# Notas

# Relacionado