Cómo usar WebChat en macOS

¿Te ha pasado que pierdes el hilo de una conversación con tu bot porque está enterrada en una de las tantas pestañas de tu navegador? Es molesto y te quita velocidad de desarrollo. Tener una aplicación nativa directamente en la barra de menú es la mejor forma de mantener el acceso al chat siempre a mano sin interrumpir tu flujo de trabajo.

Requisitos previos

• macOS con soporte para SwiftUI.
• Acceso a un Gateway (local o remoto).

Inicio rápido

Para empezar a usar WebChat, tienes dos caminos claros. El más directo es usar el menú Lobster y seleccionar Open Chat.

Si prefieres la terminal o necesitas automatizar pruebas, usa este comando para abrir la aplicación:

dist/OpenClaw.app/Contents/MacOS/OpenClaw --webchat

Para monitorizar el comportamiento y depurar, te recomiendo ejecutar el script de logs:

./scripts/clawlog.sh

Este script filtra automáticamente el subsistema bot.molt y la categoría WebChatSwiftUI.

Modos de conexión

WebChat funciona de dos maneras según donde esté tu Gateway:

• Local mode: Se conecta directamente al WebSocket del Gateway local.
• Remote mode: Reenvía el puerto de control del Gateway mediante SSH y usa ese túnel para el data plane.

La aplicación usa por defecto la sesión principal (main session) del agente seleccionado, aunque puedes cambiar de sesión desde la interfaz.

Solución de problemas

• La interfaz no carga contenido web externo: Recuerda que la UI está optimizada para sesiones de chat y no funciona como un navegador completo.
• Errores de conexión en modo remoto: Verifica que el túnel SSH esté activo, ya que el modo remoto solo reenvía el puerto de control del Gateway.

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

Próximos pasos

• Configuración del Gateway
• Gestión de sesiones de agente