Chat web (macOS)

El app de la barra de menú de macOS integra la UI WebChat como una vista nativa de SwiftUI. Se conecta al Gateway y usa de forma predeterminada la sesión principal del agente seleccionado (con un selector de sesiones para otras sesiones).

• Modo local: se conecta directamente al WebSocket del Gateway local.
• Modo remoto: reenvía el puerto de control del Gateway por SSH y usa ese túnel como plano de datos.

# Inicio y depuración

• Manual: menú Lobster → "Abrir chat".

• Apertura automática para pruebas:

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

• Registros: ./scripts/clawlog.sh (subsistema ai.openclaw, categoría WebChatSwiftUI).

# Cómo está conectado

• Plano de datos: métodos WS del Gateway chat.history, chat.send, chat.abort, chat.inject y eventos chat, agent, presence, tick, health.
• chat.history devuelve filas de transcripción normalizadas para visualización: las etiquetas de directivas en línea se eliminan del texto visible, las cargas XML de llamadas a herramientas en texto sin formato (incluidos <tool_call>...</tool_call>, <function_call>...</function_call>, <tool_calls>...</tool_calls>, <function_calls>...</function_calls> y bloques truncados de llamadas a herramientas) y los tokens de control de modelo filtrados en ASCII/ancho completo se eliminan, las filas de asistente con solo tokens silenciosos, como los NO_REPLY / no_reply exactos, se omiten, y las filas sobredimensionadas pueden reemplazarse por marcadores de posición.
• Sesión: usa de forma predeterminada la sesión primaria (main, o global cuando el alcance es global). La UI puede cambiar entre sesiones.
• La incorporación usa una sesión dedicada para mantener separada la configuración inicial.

# Superficie de seguridad

• El modo remoto reenvía solo el puerto de control WebSocket del Gateway por SSH.

# Limitaciones conocidas

• La UI está optimizada para sesiones de chat (no es un entorno aislado completo de navegador).

# Relacionado

• WebChat
• app de macOS