Configuración de Bonjour y mDNS en OpenClaw

Intentar conectar dispositivos en una red local suele ser un dolor de cabeza. Escribir direcciones IP manualmente es lento y propenso a errores, especialmente cuando cambias de red o te mueves entre diferentes entornos de trabajo. Quieres que tus herramientas se encuentren solas, sin tener que configurar manualmente cada punto de conexión cada vez que reinicias el router o activas una VPN.

OpenClaw utiliza Bonjour (mDNS / DNS-SD) como una solución de conveniencia para descubrir un Gateway activo (WebSocket endpoint) en tu red local. Es importante recordar que este sistema funciona bajo el principio de “mejor esfuerzo” y no reemplaza la conectividad basada en SSH o Tailnet.

Requisitos previos

• Una instancia de OpenClaw instalada y funcionando.
• Acceso a la configuración del Gateway.
• Tailscale (opcional, solo para DNS-SD de área amplia).
• Permisos de administrador para configurar servicios DNS.

Inicio rápido

Si tu nodo y el Gateway están en redes diferentes, el mDNS multicast no cruzará el límite de la red. Puedes mantener la misma experiencia de usuario cambiando a unicast DNS-SD (“Wide-Area Bonjour”) sobre Tailscale. Sigue estos pasos para configurarlo en 5 minutos:

1. Configura el Gateway

Modifica tu archivo ~/.openclaw/openclaw.json para permitir el descubrimiento en el área amplia. Te recomiendo usar este esquema:

{
  gateway: { bind: "tailnet" }, // recomendado: solo tailnet
  discovery: { wideArea: { enabled: true } }, // activa la publicación DNS-SD de área amplia
}

2. Configura el servidor DNS

Ejecuta el siguiente comando en el host del Gateway para instalar y configurar CoreDNS automáticamente:

openclaw dns setup --apply

3. Ajusta Tailscale

En la consola de administración de Tailscale:

• Añade un nameserver que apunte a la IP de la tailnet del Gateway (puerto UDP/TCP 53).
• Configura split DNS para que tu dominio de descubrimiento (por ejemplo, openclaw.internal.) use ese nameserver.

4. Verifica la conexión

Desde una máquina conectada a la tailnet, comprueba que los registros se publican correctamente:

dns-sd -B _openclaw-gw._tcp openclaw.internal.
dig @<TAILNET_IPV4> -p 53 _openclaw-gw._tcp.openclaw.internal PTR +short

Solución de problemas

Si el descubrimiento falla, revisa estos problemas comunes extraídos de los logs:

• Bonjour no cruza redes: Si no usas Tailscale o SSH, el tráfico multicast se detendrá en el router.
• Multicast bloqueado: Algunas redes Wi-Fi públicas o corporativas desactivan mDNS por completo.
• Reposo o cambio de interfaz: macOS puede perder temporalmente los resultados de mDNS al despertar; intenta reiniciar el proceso.
• El descubrimiento funciona pero la resolución falla: Mantén los nombres de las máquinas simples. Evita emojis o signos de puntuación y reinicia el Gateway.

Si necesitas investigar más a fondo en macOS, usa estas herramientas integradas:

# Listar instancias
dns-sd -B _openclaw-gw._tcp local.

# Resolver una instancia específica
dns-sd -L "<nombre_instancia>" _openclaw-gw._tcp local.

Para depurar en iOS, ve a Settings → Gateway → Advanced → Discovery Debug Logs y copia los resultados tras intentar la conexión.

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Discovery policy and transport selection
• Node pairing + approvals