Canal Tlon de OpenClaw
Descentralizado
Avanzado
Conecta OpenClaw a Tlon, el mensajero descentralizado construido sobre Urbit. Esta integración permite a tu asistente de IA recibir y responder mensajes directos y menciones de grupo a través de la red peer-to-peer de Tlon — sin servidores centralizados, sin cuentas corporativas, solo tu identidad de nave Urbit y un código de autenticación. Ideal para entusiastas de la computación soberana y organizaciones que valoran la verdadera propiedad de los datos.
Info rápida
DificultadAvanzado
CategoríaDescentralizado
Funciones compatibles1 / 6
Tlon Funciones compatibles
Mensajes de texto
Compatible
Medios y archivos
No compatible
Reacciones
No compatible
Hilos
No compatible
Mensajes de voz
No compatible
Chat grupal
No compatible
Tlon Requisitos previos
- OpenClaw Gateway instalado y en funcionamiento
- Una nave Urbit en funcionamiento (planeta, estrella o cometa) accesible vía HTTP
- El código de autenticación de la nave (obtenible desde la interfaz web de la nave)
- Node.js 18+ instalado en tu servidor
Tlon Configuración rápida
1
Instalar el plugin de Tlon
Ejecuta 'openclaw plugins install @openclaw/tlon' para añadir el canal Tlon. Alternativamente, usa 'openclaw onboard' o 'openclaw channels add' y selecciona Tlon de la lista de plugins. Reinicia el Gateway después de la instalación.
2
Configurar las credenciales de la nave Urbit
Establece tu identificador de nave Urbit (ej: ~sampel-palnet), la URL del host de la nave (ej: http://localhost:8080) y el código de autenticación como variables de entorno. Referéncialos en tu configuración openclaw.json usando ${URBIT_SHIP}, ${URBIT_URL} y ${URBIT_CODE}.
3
Iniciar y enviar un mensaje de prueba
Reinicia el Gateway con 'openclaw start'. Abre la app Tlon en tu nave Urbit y envía un mensaje directo a la nave del bot. El bot debería descifrar, procesar y responder automáticamente.
Tlon Ejemplo de configuración
config.json
{
"channels": {
"tlon": {
"ship": "${URBIT_SHIP}",
"url": "${URBIT_URL}",
"code": "${URBIT_CODE}",
"enabled": true
}
}
}Tlon Documentación Detallada
Visión general de la arquitectura
Tlon es una aplicación de mensajería construida sobre Urbit, una plataforma de computación peer-to-peer donde cada usuario ejecuta su propio servidor (llamado "nave"). A diferencia de las plataformas centralizadas, tus datos residen en tu nave y los controlas completamente.
El flujo de mensajes funciona de la siguiente manera:
1. Un usuario envía un DM o menciona al bot en un chat de grupo de Tlon
2. El mensaje se entrega vía el protocolo de red Ames de Urbit a la nave del bot
3. OpenClaw recibe el mensaje a través de la API HTTP de la nave
4. El Gateway procesa el mensaje a través de tu agente de IA y publica la respuesta vía la misma API
Como Urbit es una red peer-to-peer, no hay un servidor central que pueda ser apagado o censurado. Cada nave mantiene su propio estado, y los mensajes se entregan directamente entre naves a través del protocolo Ames.
El bot se ejecuta como un proceso compañero junto a tu nave Urbit — se conecta vía la API HTTP local de la nave, no a través de ningún servicio externo.
Las naves Urbit tienen identidad permanente: un planeta como ~sampel-palnet es tu dirección permanente en la red.
Instalación del plugin
El canal Tlon se distribuye como un plugin opcional de OpenClaw en lugar de estar integrado en el Gateway principal. Esto mantiene la instalación base ligera mientras te permite añadir soporte Tlon/Urbit cuando sea necesario.
Métodos de instalación:
• **npm (recomendado):** Ejecuta 'openclaw plugins install @openclaw/tlon' para instalar la versión estable.
• **Desarrollo local:** Clona el repositorio del plugin y usa 'openclaw plugins install ./extensions/tlon' para instalar desde un directorio local.
• **Configuración interactiva:** Ejecuta 'openclaw onboard' o 'openclaw channels add' y selecciona Tlon de la lista.
Después de la instalación, reinicia el Gateway para que el plugin surta efecto.
Ejecuta 'openclaw plugins list' para verificar que el plugin Tlon está instalado y activo.
Configuración y autenticación de la nave Urbit
Para conectar OpenClaw a Tlon, necesitas tres datos de tu nave Urbit:
1. **Identificador de la nave** — Tu identidad Urbit (ej: ~sampel-palnet). Esta es la nave que actuará como bot.
2. **URL del host** — El endpoint HTTP donde la nave es accesible. Urbit usa el puerto 80 por defecto, y recurre al 8080 si el puerto 80 está en uso (ej: http://localhost:8080). Consulta los logs de inicio de tu nave para el puerto real.
3. **Código de autenticación** — Un código secreto usado para autenticar las solicitudes API. Puedes encontrarlo en la interfaz web de tu nave en Configuración, o ejecutando '+code' en el Dojo (la línea de comandos de Urbit).
OpenClaw usa estas credenciales para autenticarse con la API HTTP de la nave y suscribirse a los mensajes entrantes.
openclaw.json
{
"channels": {
"tlon": {
"ship": "${URBIT_SHIP}",
"url": "${URBIT_URL}",
"code": "${URBIT_CODE}"
}
}
}Nunca codifiques tu código de autenticación directamente en openclaw.json. Siempre usa variables de entorno (ej: ${URBIT_CODE}) y establécelas vía 'export URBIT_CODE="sampel-ticlyt-migfun-falmel"' en tu shell o un archivo .env.
Descubrimiento automático y fijación de canales
Por defecto, OpenClaw descubre automáticamente los canales de grupo en tu nave Urbit, permitiendo al bot responder a menciones en cualquier grupo al que se haya unido. Puedes desactivar el descubrimiento automático y fijar canales específicos manualmente.
Las rutas de canales en Tlon siguen el formato: chat/~host-ship/channel-name. Por ejemplo, 'chat/~host-ship/general' se refiere al canal de chat 'general' alojado por ~host-ship.
Cuando el descubrimiento automático está desactivado, solo se monitorean los canales fijados. Esto es útil cuando quieres que el bot participe solo en conversaciones específicas sin ser activado en cada grupo.
openclaw.json
{
"channels": {
"tlon": {
"autoDiscovery": false,
"channels": [
"chat/~host-ship/general",
"chat/~host-ship/support"
]
}
}
}El descubrimiento automático está habilitado por defecto. Establece autoDiscovery: false para restringir el bot solo a canales fijados.
Las rutas de canales usan el formato chat/~host-ship/channel-name. Verifica la ruta exacta de cada canal en la app Tlon.
Políticas de DM
Las políticas de DM (Mensaje Directo) controlan quién puede interactuar con tu asistente de IA vía Tlon. Como las naves Urbit tienen identidades permanentes, el control de acceso se basa en direcciones de naves.
OpenClaw soporta las siguientes políticas de DM para el canal Tlon:
• **open (por defecto)** — Cualquier nave puede enviar un DM al bot. Como los DMs de Tlon requieren que ambas partes estén en la red Urbit, esto es relativamente seguro.
• **allowlist** — Solo las naves listadas en allowFrom pueden enviar mensajes al bot. Las demás son ignoradas.
Cuando allowFrom se establece como un array vacío, todas las naves están permitidas (equivalente al modo open). Añade direcciones de naves específicas para restringir el acceso.
openclaw.json
{
"channels": {
"tlon": {
"allowFrom": [
"~sampel-palnet",
"~timluc-miptev"
]
}
}
}Control de acceso de grupos
Los canales de grupo en Tlon tienen su propia capa de control de acceso. Por defecto, los grupos están restringidos — el bot solo responderá en grupos donde las naves autorizadas están explícitamente listadas.
Cada canal de grupo puede configurarse con:
• **authorized** — Una lista de direcciones de naves que pueden activar el bot en este grupo
• **mode** — 'restricted' (solo naves autorizadas pueden activar) o 'open' (cualquier miembro del grupo puede activar)
En grupos, el bot solo responde cuando es mencionado explícitamente con @. Esto evita que el bot responda a cada mensaje en un chat de grupo activo.
openclaw.json
{
"channels": {
"tlon": {
"groups": {
"chat/~host-ship/general": {
"mode": "restricted",
"authorized": ["~sampel-palnet"]
},
"chat/~host-ship/public": {
"mode": "open"
}
}
}
}
}En modo restringido, solo las naves listadas en 'authorized' pueden activar respuestas del bot.
Las respuestas de grupo requieren menciones @ — incluso en modo abierto, el bot no responderá a mensajes normales.
Objetivos de entrega (CLI y tareas programadas)
OpenClaw soporta el envío de mensajes proactivos vía CLI o tareas cron programadas. Para el canal Tlon, puedes dirigirte tanto a DMs como a canales de grupo.
Objetivos de entrega DM:
• ~sampel-palnet — Enviar un DM a esta nave
• dm/~sampel-palnet — Formato DM explícito
Objetivos de entrega de grupo:
• chat/~host-ship/channel — Publicar en un canal de grupo específico
• group:~host-ship/channel — Formato de grupo alternativo
Esto es útil para enviar notificaciones programadas, alertas o informes periódicos a naves o canales de grupo específicos.
CLI examples
# Send a DM to a specific ship
openclaw send tlon ~sampel-palnet "Your daily report is ready."
# Post to a group channel
openclaw send tlon chat/~host-ship/general "System status: all clear."Limitaciones del manejo de medios
La integración actual de Tlon solo soporta mensajes de texto. Las reacciones, encuestas y cargas de medios nativos no están soportadas debido a limitaciones en la integración de la API Urbit del plugin.
Cuando el agente de IA genera una respuesta que incluye medios (imágenes, archivos, etc.), el plugin recurre a la entrega solo texto:
• Imágenes — La URL se añade al texto del mensaje en lugar de mostrarse en línea
• Archivos — Se incluye un enlace de descarga en la respuesta de texto
• Reacciones — No soportadas; el bot no puede reaccionar a mensajes
• Hilos — No soportados; todas las respuestas van a la conversación principal
Futuras actualizaciones del plugin podrían añadir soporte nativo de medios a medida que la plataforma Tlon evolucione.
Si tu agente de IA genera frecuentemente respuestas con imágenes, considera incluir en el prompt del sistema que el canal Tlon es solo texto.
Las URLs en los mensajes son clicables en la app Tlon — los usuarios pueden tocar para ver el contenido multimedia en su navegador.
Tlon Referencia de Configuración
| Key | Type | Default | Description |
|---|---|---|---|
| ship | string | (required) | Tu identificador de nave Urbit (ej: ~sampel-palnet). Esta es la nave que actúa como bot. |
| url | string | "http://localhost:8080" | Endpoint HTTP donde la nave Urbit es accesible |
| code | string | (required) | Código de autenticación para la API HTTP de la nave Urbit. Usa una referencia de variable de entorno. |
| enabled | boolean | true | Activar o desactivar el canal Tlon |
| name | string | "" | Nombre de visualización para esta instancia de canal |
| autoDiscovery | boolean | true | Descubrir y monitorear automáticamente todos los canales de grupo en la nave |
| channels | string[] | [] | Lista de rutas de canales de grupo a monitorear cuando autoDiscovery está desactivado (ej: chat/~host-ship/general) |
| allowFrom | string[] | [] | Lista de direcciones de naves permitidas para enviar DMs al bot. Un array vacío permite todas las naves. |
| groups | object | {} | Configuración de control de acceso por grupo con modo y listas de naves autorizadas |
| groups.<path>.mode | string | "restricted" | Modo de acceso del grupo: 'restricted' (solo naves autorizadas) o 'open' (cualquier miembro del grupo) |
| groups.<path>.authorized | string[] | [] | Lista de direcciones de naves autorizadas para activar el bot en este grupo (cuando el modo es 'restricted') |
ship
Type: stringDefault: (required)
Tu identificador de nave Urbit (ej: ~sampel-palnet). Esta es la nave que actúa como bot.
url
Type: stringDefault: "http://localhost:8080"
Endpoint HTTP donde la nave Urbit es accesible
code
Type: stringDefault: (required)
Código de autenticación para la API HTTP de la nave Urbit. Usa una referencia de variable de entorno.
enabled
Type: booleanDefault: true
Activar o desactivar el canal Tlon
name
Type: stringDefault: ""
Nombre de visualización para esta instancia de canal
autoDiscovery
Type: booleanDefault: true
Descubrir y monitorear automáticamente todos los canales de grupo en la nave
channels
Type: string[]Default: []
Lista de rutas de canales de grupo a monitorear cuando autoDiscovery está desactivado (ej: chat/~host-ship/general)
allowFrom
Type: string[]Default: []
Lista de direcciones de naves permitidas para enviar DMs al bot. Un array vacío permite todas las naves.
groups
Type: objectDefault: {}
Configuración de control de acceso por grupo con modo y listas de naves autorizadas
groups.<path>.mode
Type: stringDefault: "restricted"
Modo de acceso del grupo: 'restricted' (solo naves autorizadas) o 'open' (cualquier miembro del grupo)
groups.<path>.authorized
Type: string[]Default: []
Lista de direcciones de naves autorizadas para activar el bot en este grupo (cuando el modo es 'restricted')
Tlon Preguntas Frecuentes
Tlon Solución de Problemas
El bot inicia pero no recibe ningún mensaje
La URL de la nave o el código de autenticación puede ser incorrecto, o la nave no está en funcionamiento.
Verifica que la nave es accesible abriendo la URL en un navegador. Comprueba que el código de autenticación es correcto (ejecuta '+code' en el Dojo). Asegúrate de que las variables de entorno están correctamente exportadas: 'echo $URBIT_URL' y 'echo $URBIT_CODE'.
Error: autenticación fallida
El código de autenticación ha expirado o es incorrecto. Las naves Urbit pueden rotar sus códigos de autenticación.
Obtén un nuevo código de autenticación desde la interfaz web de la nave (Configuración) o ejecutando '+code' en el Dojo. Actualiza la variable de entorno URBIT_CODE y reinicia el Gateway.
El bot responde a DMs pero no en canales de grupo
El descubrimiento automático puede estar desactivado y el canal de grupo no está fijado, o el control de acceso del grupo está bloqueando al remitente.
Verifica si autoDiscovery está establecido en false — si es así, añade el canal de grupo al array channels. Verifica que la nave del remitente está en la lista authorized del grupo (para modo restringido). Recuerda que las respuestas de grupo requieren menciones @.
Plugin no encontrado después de la instalación
El Gateway no fue reiniciado después de la instalación del plugin, o la instalación falló silenciosamente.
Ejecuta 'openclaw plugins list' para verificar que el plugin Tlon está instalado. Si no está listado, vuelve a ejecutar 'openclaw plugins install @openclaw/tlon'. Reinicia el Gateway con 'openclaw start' después de la instalación.
La conexión se cae frecuentemente
La API HTTP de la nave Urbit puede ser inaccesible debido a problemas de red o la nave bajo carga pesada.
Verifica tu conectividad de red hacia la nave. Si la ejecutas remotamente, asegúrate de que el puerto HTTP no esté bloqueado por un firewall. Considera ejecutar el bot en la misma máquina que la nave para minimizar la latencia. Revisa los mensajes de error en el Dojo de la nave.