OpenClawSkills
GitHub
Canal • Instantáneo

Guía de WebChat

Accede a tu agente directamente vía interfaz de navegador integrada. Sin configuración requerida.

¿Nuevo en OpenClaw? Revisa nuestro ''Tutorial de Inicio'' para aprender lo básico. Esta página cubre características específicas de WebChat y la UI de Control del Gateway.

WebChat es la interfaz web integrada de OpenClaw para interactuar con tu asistente de IA. Usa la conexión WebSocket del Gateway y es accesible a través de la UI de Control del Gateway, proporcionando una interfaz de chat basada en navegador conveniente que funciona en cualquier dispositivo con un navegador web moderno.

Tutorial.step

Inicio Rápido

Acceder a WebChat es simple:

  • Inicia tu Gateway de OpenClaw
  • Abre tu navegador web
  • Navega a la UI de Control del Gateway
  • ¡Empieza a chatear!
Tutorial.step

Accediendo a WebChat

Acceso Local

Cuando ejecutas el Gateway localmente, accede a WebChat en:

http://127.0.0.1:18789/

El Gateway corre en el puerto 18789 por defecto (solo loopback por seguridad).

Acceso Remoto

Para acceso remoto, necesitarás:

  • Configurar port forwarding o tunneling SSH
  • Usar Tailscale o solución VPN similar
  • Configurar el Gateway para aceptar conexiones remotas (con seguridad apropiada)
  • Ver nuestra Guía de Acceso Remoto para instrucciones detalladas.
Tutorial.step

UI de Control del Gateway

La UI de Control del Gateway (también llamada Dashboard) proporciona una interfaz web completa para gestionar OpenClaw:

  • Interfaz WebChat - Chatea con tu asistente de IA
  • Gestión de Configuración - Ver y editar configuración
  • Monitoreo de Sesiones - Monitorear sesiones activas
  • Gestión de Nodos - Gestionar nodos conectados (apps iOS/Android)
  • Estado del Gateway - Ver salud y estado del Gateway
  • Estado de Canales - Monitorear canales conectados
Tutorial.step

Características de WebChat

Interfaz de Chat

WebChat proporciona una interfaz de chat moderna y responsiva:

  • Mensajería en Tiempo Real - Entrega instantánea de mensajes vía WebSocket
  • Historial de Mensajes - Ver historial de conversación
  • Respuestas en Streaming - Ver respuestas transmitirse en tiempo real
  • ChannelsWebchatPage.step04.chatLi4
  • ChannelsWebchatPage.step04.chatLi5
  • ChannelsWebchatPage.step04.chatLi6

ChannelsWebchatPage.step04.sessionManagementTitle

ChannelsWebchatPage.step04.sessionManagementDesc

  • ChannelsWebchatPage.step04.sessionLi1
  • ChannelsWebchatPage.step04.sessionLi2
  • ChannelsWebchatPage.step04.sessionLi3

ChannelsWebchatPage.step04.gatewayWebsocketTitle

ChannelsWebchatPage.step04.gatewayWebsocketDesc

  • ChannelsWebchatPage.step04.gatewayLi1
  • ChannelsWebchatPage.step04.gatewayLi2
  • ChannelsWebchatPage.step04.gatewayLi3
  • ChannelsWebchatPage.step04.gatewayLi4

ChannelsWebchatPage.step04.websocketEndpointTitle

ChannelsWebchatPage.step04.websocketEndpointDesc

WebSocket URL
ws://127.0.0.1:18789/ws

ChannelsWebchatPage.step04.websocketNote

Tutorial.step

Configuración

WebChat no requiere configuración separada. Está automáticamente disponible cuando el Gateway está ejecutándose. Sin embargo, puedes configurar ajustes del Gateway que afectan WebChat:

Puerto del Gateway

Cambia el puerto del Gateway si es necesario:

Gateway Port Configuration
{
  "gateway": {
    "port": 18789
  }
}

Acceso Remoto

Para habilitar acceso remoto (usa con precaución y seguridad apropiada):

Remote Access Configuration
{
  "gateway": {
    "port": 18789,
    "host": "0.0.0.0"
  }
}

Advertencia de Seguridad

Exponer el Gateway a internet sin autenticación apropiada y HTTPS es un riesgo de seguridad. Usa túneles SSH, VPNs, o proxies inversos con autenticación.
Tutorial.step

Compatibilidad de Navegadores

WebChat funciona en cualquier navegador moderno que soporte:

  • WebSocket - Para comunicación en tiempo real
  • ES6+ JavaScript - Características modernas de JavaScript
  • CSS Grid/Flexbox - Características de layout

Navegadores Soportados

  • Chrome/Edge (latest versions)
  • Firefox (latest versions)
  • Safari (latest versions)
  • Opera (latest versions)

Mobile Browsers

WebChat es responsivo y funciona en navegadores móviles, aunque las apps nativas (iOS/Android) proporcionan una mejor experiencia móvil.

Tutorial.step

Consideraciones de Seguridad

Acceso Local (Predeterminado)

Por defecto, el Gateway solo acepta conexiones de localhost (127.0.0.1), lo cual es seguro para uso local.

Seguridad de Acceso Remoto

Si necesitas acceso remoto, usa métodos seguros:

  • Túnel SSH - Túnel del Gateway a través de SSH
  • VPN - Usa Tailscale o VPN similar
  • Proxy Inverso - Usa nginx/traefik con autenticación
  • HTTPS - Siempre usa HTTPS para acceso remoto
  • Autenticación - Añade capa de autenticación

Mejores Prácticas

  • Mantén Ajustes Predeterminados - Usa solo localhost a menos que sea necesario
  • Usa VPN para Remoto - Prefiere VPN sobre exposición directa
  • ChannelsWebchatPage.step07.bestLi3
  • ChannelsWebchatPage.step07.bestLi4
Tutorial.step

Troubleshooting

Can't Access WebChat

Si no puedes acceder a WebChat:

  • Verify Gateway is running: openclaw status
  • Check Gateway is listening on port 18789
  • Try accessing http://127.0.0.1:18789/ directly
  • Check firewall isn't blocking the port
  • Review Gateway logs for errors

WebSocket Connection Issues

If WebSocket fails to connect:

  • Check browser console for errors
  • Verify Gateway is running
  • Check network connectivity
  • Try refreshing the page
  • Check browser WebSocket support

Messages Not Sending

Si los mensajes no se envían:

  • Check WebSocket connection status
  • Verify Gateway is processing messages
  • Check browser console for errors
  • Try reconnecting to WebSocket
  • Review Gateway logs