Configura OpenClaw WebChat: Guía rápida de conexión

¿Alguna vez has sentido que configurar una interfaz de chat para tu backend es más complicado de lo que debería? A veces terminas peleando con navegadores embebidos o servidores locales que solo añaden capas de complejidad a tu flujo de trabajo diario.

Si buscas una forma directa de interactuar con tu Gateway sin configuraciones pesadas, WebChat es la solución que necesitas para mantener el control total de tus sesiones.

WebChat (Gateway WebSocket UI)

Status: the macOS/iOS SwiftUI chat UI talks directly to the Gateway WebSocket.

Qué es

• Una UI de chat nativa para el Gateway (sin navegador embebido y sin servidor estático local).
• Usa las mismas sesiones y reglas de ruteo que otros canales.
• Ruteo determinista: las respuestas siempre vuelven a WebChat.

Inicio rápido

1. Inicia el Gateway.
2. Abre la UI de WebChat (app de macOS/iOS) o la pestaña de chat en Control UI.
3. Asegúrate de que la auth del Gateway esté configurada (es obligatoria por defecto, incluso en loopback).

Cómo funciona (comportamiento)

• La UI se conecta al Gateway WebSocket y utiliza chat.history, chat.send y chat.inject.
• chat.history está limitado para mantener la estabilidad: Gateway puede recortar campos de texto largos, omitir metadatos pesados y reemplazar entradas excesivamente grandes con [chat.history omitted: message too large].
• chat.inject añade una nota del asistente directamente a la transcripción y la transmite a la UI (sin ejecución de agentes).
• Las ejecuciones canceladas pueden mantener visible en la UI la salida parcial del asistente.
• Gateway guarda el texto parcial del asistente en el historial de la transcripción cuando existe salida en el buffer, y marca esas entradas con metadatos de cancelación.
• El historial siempre se obtiene del Gateway (no hay lectura de archivos locales).
• Si el Gateway no está disponible, WebChat funciona en modo de solo lectura.

Panel de herramientas de agentes en Control UI

• El panel de Tools en /agents de Control UI tiene dos vistas separadas:
  • Available Right Now usa tools.effective(sessionKey=...) y muestra lo que la sesión actual puede usar realmente en tiempo de ejecución, incluyendo herramientas del core, plugins, herramientas del canal y extensiones.
  • Tool Configuration usa tools.catalog y se enfoca en perfiles, overrides y la semántica del catálogo.
• La disponibilidad en tiempo de ejecución depende de la sesión. Cambiar de sesión en el mismo agente puede modificar la lista de Available Right Now.
• El editor de configuración no garantiza la disponibilidad en tiempo de ejecución; el acceso real sigue las prioridades de las políticas (allow/deny, overrides por agente y por provider/canal).

Uso remoto

• El modo remoto crea un túnel para el Gateway WebSocket a través de SSH o Tailscale.
• No necesitas ejecutar un servidor de WebChat por separado.

Referencia de configuración (WebChat)

Full configuration: Configuration

Opciones de WebChat:

• gateway.webchat.chatHistoryMaxChars: recuento máximo de caracteres para los campos de texto en las respuestas de chat.history. Cuando una entrada de la transcripción supera este límite, Gateway recorta los campos de texto largos y puede sustituir los mensajes excesivamente grandes por un marcador de posición. El cliente también puede enviar un maxChars por petición para sobrescribir este valor por defecto en una sola llamada a chat.history.

Opciones globales relacionadas:

• gateway.port, gateway.bind: WebSocket host/port.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket auth (token/password).
• gateway.auth.mode: "trusted-proxy": auth de proxy inverso para clientes de navegador (ver Trusted Proxy Auth).
• gateway.remote.url, gateway.remote.token, gateway.remote.password: objetivo del Gateway remoto.
• session.*: almacenamiento de sesiones y valores por defecto de las claves principales.

Siguientes pasos

• Configuración del Gateway
• Autenticación de Proxy de Confianza

AI Setup Assistant