Interfaz de control

La interfaz de control es una pequeña aplicación de página única de Vite + Lit servida por el Gateway:

• valor predeterminado: http://<host>:18789/
• prefijo opcional: establezca gateway.controlUi.basePath (p. ej., /openclaw)

Se comunica directamente con el WebSocket del Gateway en el mismo puerto.

Apertura rápida (local)

Si el Gateway se ejecuta en el mismo equipo, abra http://127.0.0.1:18789/ (o http://localhost:18789/).

Si la página no se carga, inicie primero el Gateway: openclaw gateway.

La autenticación se proporciona durante el protocolo de enlace de WebSocket mediante:

• connect.params.auth.token
• connect.params.auth.password
• encabezados de identidad de Tailscale Serve cuando gateway.auth.allowTailscale: true
• encabezados de identidad de proxy de confianza cuando gateway.auth.mode: "trusted-proxy"

El panel de configuración conserva un token para la sesión de la pestaña actual del navegador y la URL del Gateway seleccionada; las contraseñas no se conservan. La incorporación suele generar un token del Gateway para la autenticación mediante secreto compartido en la primera conexión, pero la autenticación mediante contraseña también funciona cuando gateway.auth.mode es "password".

Emparejamiento de dispositivos (primera conexión)

La conexión desde un navegador o dispositivo nuevo suele requerir una aprobación de emparejamiento única, mostrada como disconnected (1008): pairing required.

openclaw devices list

openclaw devices approve <requestId>

Si el navegador vuelve a intentar el emparejamiento con datos de autenticación modificados (rol/ámbitos/clave pública), la solicitud pendiente anterior se sustituye y se crea un nuevo requestId; vuelva a ejecutar openclaw devices list antes de aprobar.

Cambiar un navegador ya emparejado de acceso de lectura a acceso de escritura/administración se trata como una ampliación de la aprobación, no como una reconexión silenciosa: OpenClaw mantiene activa la aprobación anterior, bloquea la reconexión con permisos más amplios y solicita que se apruebe explícitamente el nuevo conjunto de ámbitos.

Una vez aprobado, el dispositivo se recuerda y no requerirá una nueva aprobación a menos que se revoque mediante openclaw devices revoke --device <id> --role <role>. Consulte CLI de dispositivos para obtener información sobre la rotación y revocación de tokens y el flujo de aprobación inicial de Paperclip / openclaw_gateway.

Emparejar un dispositivo móvil

Un administrador ya emparejado puede crear el QR de conexión de iOS/Android sin abrir un terminal:

La creación de un código de configuración requiere operator.admin; el botón está deshabilitado para las sesiones que no lo tengan. Un código de configuración contiene una credencial de arranque de corta duración, por lo que el QR y el código copiado deben tratarse como una contraseña mientras sean válidos. Para el emparejamiento remoto, el Gateway debe resolverse como wss:// (por ejemplo, mediante Tailscale Serve/Funnel); ws:// sin protección está limitado al bucle invertido y a las direcciones de LAN privadas. Consulte Emparejamiento para obtener todos los detalles de seguridad y mecanismo alternativo.

Identidad personal (local del navegador)

La interfaz de control admite una identidad personal por navegador (nombre para mostrar y avatar) adjunta a los mensajes salientes para atribuirlos en sesiones compartidas. Se almacena en el navegador, está limitada al perfil actual y no se sincroniza con otros dispositivos ni se conserva en el servidor más allá de los metadatos normales de autoría de la transcripción de los mensajes enviados. Al borrar los datos del sitio o cambiar de navegador, vuelve a quedar vacía.

La sustitución del avatar del asistente sigue el mismo patrón local del navegador: las sustituciones cargadas se superponen localmente a la identidad resuelta por el Gateway y nunca realizan un viaje de ida y vuelta mediante config.patch. El campo de configuración compartido ui.assistant.avatar sigue disponible para los clientes que no usan la interfaz y escriben directamente en él.

Endpoint de configuración en tiempo de ejecución

La interfaz de control obtiene su configuración en tiempo de ejecución de /control-ui-config.json, resuelto con relación a la ruta base de la interfaz de control del Gateway (por ejemplo, /__openclaw__/control-ui-config.json bajo la ruta base /__openclaw__/). Ese endpoint está protegido por la misma autenticación del Gateway que el resto de la superficie HTTP: los navegadores no autenticados no pueden obtenerlo y, para obtenerlo correctamente, se requiere un token o una contraseña válidos del Gateway, una identidad de Tailscale Serve o una identidad de proxy de confianza.

Estado del host del Gateway

Abra Configuración en la vista simple para ver la tarjeta Host del Gateway, que muestra el equipo del Gateway, la dirección LAN, el sistema operativo, el entorno de ejecución, el tiempo de actividad, la carga de CPU, la memoria y el espacio en disco del volumen de estado. Mientras está visible, la tarjeta se actualiza cada 10 segundos mediante el RPC system.info del Gateway, que requiere el ámbito operator.read. Los Gateways antiguos y las conexiones sin ese ámbito omiten la tarjeta.

Compatibilidad de idiomas

La interfaz de control se localiza en la primera carga según la configuración regional del navegador. Para cambiarla más adelante, abra Configuración -> General -> Idioma (el selector se encuentra en la tarjeta de configuración rápida General, no en Apariencia).

• Configuraciones regionales compatibles: en, ar, de, es, fa, fr, hi, id, it, ja-JP, ko, nl, pl, pt-BR, ru, th, tr, uk, vi, zh-CN, zh-TW
• Las traducciones a idiomas distintos del inglés se cargan de forma diferida en el navegador.
• La configuración regional seleccionada se guarda en el almacenamiento del navegador y se reutiliza en visitas futuras.
• Las claves de traducción que falten recurren al inglés.

Las traducciones de la documentación se generan para el mismo conjunto de configuraciones regionales distintas del inglés, pero el selector de idiomas integrado de Mintlify en el sitio de documentación solo enumera los códigos de configuración regional que Mintlify acepta. La documentación en tailandés (th) y persa (fa) se sigue generando en el repositorio de publicación; puede que no aparezca en ese selector hasta que Mintlify admita esos códigos.

Temas de apariencia

El panel Apariencia incluye los temas integrados Claw, Knot y Dash (Claw es el predeterminado), además de una ranura de importación de tweakcn local del navegador. Para importar un tema, abra el editor de tweakcn, elija o cree un tema, haga clic en Share y pegue el enlace copiado en Apariencia. El importador también acepta URL del registro https://tweakcn.com/r/themes/<id>, URL del editor como https://tweakcn.com/editor/theme?theme=amethyst-haze, rutas relativas /themes/<id>, ID de tema sin procesar y nombres de temas predeterminados como amethyst-haze.

Los temas importados se almacenan únicamente en el perfil actual del navegador; no se escriben en la configuración del Gateway ni se sincronizan entre dispositivos. Al sustituir el tema importado se actualiza la única ranura local; al borrarlo se vuelve a Claw si el tema importado estaba activo.

Apariencia también tiene una opción Tamaño del texto local del navegador, almacenada junto con el resto de las preferencias de la interfaz de control. Se aplica al texto del chat, al texto del redactor, a las tarjetas de herramientas y a las barras laterales del chat, y mantiene las entradas de texto en al menos 16px para que Safari móvil no amplíe automáticamente la vista al enfocarlas.

Gestionar plugins

Abra Plugins en la barra lateral o use /settings/plugins con relación a la ruta base configurada de la interfaz de control para explorar y gestionar plugins sin salir de la interfaz de control. Por ejemplo, una ruta base /openclaw usa /openclaw/settings/plugins. La página está siempre disponible, incluso cuando todos los plugins opcionales están deshabilitados.

Plugins es un centro con cuatro pestañas: Instalados y Descubrir gestionan el código de los plugins en /settings/plugins, Skills aloja el gestor de Skills por agente en /skills y Taller aloja la revisión de propuestas del Taller de Skills en /skills/workshop. Cada pestaña conserva su propia URL y la barra lateral muestra la única entrada Plugins para todas ellas.

La pestaña Instalados muestra el inventario local completo agrupado por categoría, con recuentos generales. Cada fila abre una vista de detalles; su menú de desbordamiento (…) habilita o deshabilita el plugin y ofrece Eliminar para los plugins instalados externamente. También enumera los servidores MCP configurados y permite añadirlos, deshabilitarlos y eliminarlos directamente. La pestaña Descubrir es la tienda: plugins destacados incluidos con OpenClaw, plugins externos oficiales y conectores MCP con un solo clic para servicios populares. Al escribir en el cuadro de búsqueda, se consulta ClawHub directamente y se añade una sección De ClawHub con recuentos de descargas e insignias de verificación del origen. Los enlaces profundos pueden dirigirse directamente a la tienda mediante /settings/plugins?tab=discover.

La pestaña Skills conserva el informe de estado de Skills, los controles para habilitarlas o deshabilitarlas, la introducción de claves de API y la búsqueda integrada de Skills en ClawHub, todo ello limitado al agente seleccionado. La pestaña Taller conserva el tablero del Taller de Skills y el flujo de revisión de Hoy para las propuestas de Skills. Buscar ideas de Skills revisa una ventana limitada de sesiones sustanciales desde la más reciente hasta la más antigua y deja los resultados como propuestas pendientes. El panel muestra la cobertura acumulada; Analizar trabajo anterior continúa desde el cursor conservado y después se convierte en Analizar trabajo nuevo cuando se agota el historial anterior. La revisión manual del historial funciona mientras el autoaprendizaje autónomo está deshabilitado y usa el modelo configurado del agente seleccionado.

Los plugins incluidos ya están presentes en el Gateway y muestran Habilitar o Deshabilitar en lugar de Instalar. Por ejemplo, Workboard está incluido con OpenClaw, pero está deshabilitado de forma predeterminada, por lo que su acción es Habilitar. Los plugins integrados no se pueden eliminar, solo deshabilitar.

La lectura del catálogo y la búsqueda en ClawHub requieren operator.read. Instalar, habilitar, deshabilitar o eliminar un plugin y cambiar servidores MCP requieren operator.admin; esas acciones permanecen deshabilitadas para los operadores con acceso de solo lectura.

Las instalaciones desde ClawHub se ejecutan mediante el Gateway y mantienen las mismas comprobaciones de confianza, integridad y directivas de instalación de plugins que otras instalaciones mediadas por el Gateway. Instalar o eliminar código de plugins requiere reiniciar el Gateway. Habilitar o deshabilitar un plugin instalado puede aplicarse sin reiniciar cuando el plugin y el entorno de ejecución actual del Gateway lo admiten; de lo contrario, la interfaz informa de que es necesario reiniciar. Los conectores MCP respaldados por OAuth necesitan una ejecución única de openclaw mcp login <name> desde la CLI después de añadirlos.

La página se centra intencionadamente en el inventario, el descubrimiento, la instalación, la habilitación y la eliminación. Use openclaw plugins para fuentes npm, git o de rutas locales arbitrarias, actualizaciones y configuración avanzada de plugins.

Navegación por la barra lateral

La barra lateral fija la navegación encima de una lista desplazable de sesiones. En configuraciones multiagente, cada agente aparece como una sección de nivel superior contraíble; al expandir un agente, se pueden explorar sus sesiones sin salir del chat abierto, y los agentes contraídos muestran un indicador de contenido no leído. Dentro de un agente, la lista se divide en Fijadas, una sección integrada por cada canal conectado (Telegram, Slack, WhatsApp, ...), una sección integrada Trabajo para las sesiones vinculadas a un árbol de trabajo administrado o a un nodo de ejecución (las filas muestran una línea repo ⎇ branch junto con el host del nodo), grupos personalizados (la sesión category) y Chats para el resto. Las secciones de canales y Trabajo clasifican las filas automáticamente; asignar una sesión a un grupo personalizado siempre tiene prioridad. Al abrir una sesión, el resaltado de selección se desplaza sin reordenar las filas. Las sesiones con actividad nueva desde la última vez que se leyeron muestran un punto de contenido no leído, y abrirlas las marca como leídas. Cada fila de sesión tiene un menú contextual (botón de tres puntos verticales o clic derecho) con Fijar/Desfijar, Marcar como no leída/leída, Cambiar nombre, Bifurcar, Mover al grupo (incluidos Nuevo grupo y Quitar del grupo), Archivar y Eliminar; en los diseños táctiles, los controles directos de fijación y menú permanecen visibles. Cmd/Ctrl-clic activa o desactiva filas en una selección múltiple y Mayús-clic amplía la selección siguiendo el orden visible; al abrir el menú de una fila seleccionada, se ofrecen acciones por lotes (Marcar N como no leídas/leídas, Mover N al grupo, Archivar N, Eliminar N) que se aplican a todas las sesiones seleccionadas, con una única confirmación para la eliminación por lotes. Arrastre una sesión a un grupo personalizado o a Chats para moverla. Los encabezados de grupos personalizados se pueden contraer, expandir o arrastrar para reordenarlos; los nombres de los grupos y su orden se guardan en el Gateway (sessions.groups.*), por lo que se mantienen entre navegadores, mientras que el estado contraído permanece en el perfil del navegador. Los encabezados de grupo también tienen un menú (botón de tres puntos verticales o clic derecho) con Cambiar nombre del grupo, Nuevo grupo y Eliminar grupo; cambiar el nombre o eliminar un grupo actualiza en el servidor todas las sesiones que lo integran, incluidas las archivadas, y eliminar un grupo conserva sus sesiones y las devuelve a Chats. El único + del encabezado de la lista de sesiones abre la página Nueva sesión (consulte más adelante). El control de ordenación también incluye la opción Agrupar por: Agrupadas (valor predeterminado) o Ninguna para mostrar una única lista plana (Fijadas permanece separada); la elección se guarda en el perfil actual del navegador. Uso, Automatizaciones y Plugins están fijados de forma predeterminada; la fila Más abre un menú con todos los demás destinos, incluidas las pestañas proporcionadas por Plugins. Seleccione Editar elementos fijados en ese menú, o haga clic derecho en el área de navegación, para fijar o desfijar destinos y restaurar los valores predeterminados. El conjunto fijado se guarda en el perfil actual del navegador y se conserva tras las recargas.

Página de nueva sesión

El + del encabezado de la lista de sesiones de la barra lateral abre un borrador de página completa en /new: no se crea nada hasta que se envía el primer mensaje. Una fila de destino situada encima del cuadro de mensaje permite elegir dónde trabaja la sesión: el agente (en configuraciones multiagente), dónde se ejecutan los procesos (Gateway · local o un nodo emparejado que exponga system.run; requiere operator.admin), la carpeta (el valor predeterminado es el espacio de trabajo del agente; otras rutas absolutas del Gateway requieren operator.admin y un árbol de trabajo) y una opción Árbol de trabajo opcional con un selector de rama base (respaldado por worktrees.branches, por lo que no se realiza ninguna obtención) y un nombre opcional para el árbol de trabajo (la rama pasa a ser openclaw/<name>). El botón de exploración de la ficha de carpeta abre un selector de directorios en línea respaldado por el método exclusivo para administradores fs.listDir. Su nivel superior muestra el Gateway y todos los nodos conocidos; los nodos sin conexión y los que no admiten la exploración de directorios permanecen visibles, pero deshabilitados. Al seleccionar el Gateway, se comienza desde la carpeta actual o desde el directorio de inicio del Gateway. Al seleccionar un nodo compatible, se explora el sistema de archivos del host de ese nodo, se vincula la ejecución a él y se usa directamente la ruta absoluta seleccionada del nodo (los árboles de trabajo administrados siguen estando disponibles únicamente en el Gateway). Al enviar, se llama a sessions.create con el primer mensaje, por lo que la ejecución comienza en el mismo ciclo de solicitud y respuesta, y la interfaz salta al chat de la nueva sesión. Si el Gateway crea la sesión, pero rechaza ese primer envío, el chat conserva el mensaje y el error entre recargas; Reintentar lo envía mediante la sesión ya creada en lugar de crear otra.

Dentro de Configuración, la barra lateral específica comienza con un campo Buscar en la configuración para encontrar rápidamente secciones de configuración.

Un campo Buscar en la parte superior de la barra lateral abre la paleta de comandos (⌘K). Al hacer clic en la marca OpenClaw del encabezado de la barra lateral, se abre la pantalla inicial limpia de Nueva sesión. Cuando algo requiere atención —tareas Cron fallidas o atrasadas, autenticación de modelos próxima a caducar o caducada—, aparecen fichas compactas de atención encima del pie de la barra lateral que, al hacer clic, llevan a la página correspondiente. El pie muestra el agente activo como una ficha —avatar (imagen de identidad o emoji), nombre, punto de conexión y un subtítulo en tiempo real— con un + para iniciar una sesión nueva. Al hacer clic en la ficha, se abre el menú del agente: un selector de agentes (en configuraciones multiagente), "¿Qué puede hacer este agente?", Configuración del agente, Configuración, emparejamiento móvil, Documentación, la ficha de compilación y el selector del modo de color. Las listas de más de diez agentes incluyen un campo de filtro y muestran primero los agentes fijados; los agentes se pueden fijar o desfijar desde la página de configuración de Agentes, y el conjunto fijado se guarda en el perfil del navegador. Al elegir un agente, Chat, Uso, Automatizaciones, Tareas, Panel de trabajo y Sesiones quedan restringidos a ese agente. Cada página restringida incluye un control Agente con Todos los agentes como opción para salir de ese ámbito; esto amplía el ámbito de la página compartida sin cambiar el agente concreto del chat, mientras que los enlaces directos a sesiones siguen abriendo su destino. La página de configuración de Agentes mantiene su propia selección ?agent= y no adopta el ámbito compartido de la página. Cuando el Gateway se ejecuta desde una copia del código fuente en una rama distinta de main, el pie también muestra el nombre de esa rama en rojo para que resulte evidente a simple vista que el Gateway no corresponde a una versión publicada (las instalaciones de versiones publicadas nunca lo muestran). Mayús-Comando-Coma abre Configuración sin sustituir el atajo Comando-Coma del navegador. El encabezado de la barra lateral también contiene el control para contraerla (⌘B); al contraerla, se oculta por completo para ofrecer un espacio de trabajo de ancho completo, y un control flotante para expandirla (o ⌘B) permite recuperarla; en su lugar, la aplicación para macOS aloja ese control de forma nativa en la barra de título. La barra lateral es el único elemento de navegación en el escritorio; no hay una barra superior. En ventanas estrechas, la barra lateral se sustituye por un panel deslizable situado detrás de una fila de encabezado compacta que contiene el control del panel, la marca y la búsqueda de la paleta de comandos; en la aplicación para macOS, esa fila de encabezado integra el espacio reservado para la barra de título en una única franja compacta junto a los controles de la ventana. La navegación usa el historial normal del navegador, por lo que sus botones Atrás y Adelante permiten recorrerla; la aplicación para macOS añade un control nativo para la barra lateral junto a los controles de la ventana, además de gestos de deslizamiento en el panel táctil, con botones Atrás y Adelante en el borde derecho de la barra lateral cuando está expandida, y botones nativos de búsqueda (paleta de comandos) y nueva sesión cuando está contraída.

Qué puede hacer (hoy)

Importar memoria del asistente

Abra Settings → Import Memory para incorporar memoria local de Codex o Claude Code a un agente de OpenClaw. El Gateway detecta por sí mismo la memoria local compatible en su host, por lo que una interfaz de control remota importa desde el equipo del Gateway y no desde el equipo del navegador.

1. Elija el agente de destino.
2. Revise las colecciones de origen detectadas y los nombres de archivo Markdown. El contenido de los archivos no se envía en la respuesta del plan ni se muestra en la página.
3. Seleccione las colecciones que se importarán y confirme. Al aplicar, se vuelve a generar el plan antes de escribir, de modo que las selecciones obsoletas fallen de forma segura.
4. Si ya existen archivos, active Replace existing imports, actualice la vista previa y confirme la sustitución.

Codex solo importa sus archivos consolidados MEMORY.md y memory_summary.md. Claude Code importa Markdown desde los directorios de memoria automática del proyecto y un autoMemoryDirectory configurado; no importa sesiones, configuración, instrucciones ni credenciales mediante esta página. Los archivos se copian en memory/imports/ dentro del espacio de trabajo seleccionado, donde el plugin de memoria activo puede indexarlos. Las fuentes nunca se modifican.

Planificar y aplicar requieren operator.admin. Cada aplicación crea una copia de seguridad verificada de OpenClaw cuando existe un estado, escribe un informe de migración censurado y conserva copias de seguridad de cada elemento antes de reemplazar los archivos de destino existentes. Consulte Descripción general de la memoria para conocer las rutas y el comportamiento de recuperación.

Página de MCP

La página dedicada a MCP es una vista para operadores de los servidores MCP administrados por OpenClaw en mcp.servers. No inicia por sí sola los transportes MCP; úsela para inspeccionar y editar la configuración guardada y, a continuación, use openclaw mcp doctor --probe cuando necesite una comprobación del servidor en vivo.

Flujo de trabajo habitual:

1. Abra MCP en la barra lateral.
2. Compruebe en las tarjetas de resumen los recuentos de servidores totales, habilitados, con OAuth y filtrados.
3. Revise cada fila de servidor para consultar el transporte, la habilitación, la autenticación, los filtros, los tiempos de espera y las sugerencias de comandos.
4. Administre los servidores (añadir, habilitar/deshabilitar y eliminar) en la página Plugins, que es el único editor interactivo de mcp.servers; la lista de filas de esta página contiene un enlace a ella.
5. Edite la sección de configuración delimitada mcp para las definiciones de servidores, encabezados, rutas TLS/mTLS, metadatos de OAuth, filtros de herramientas y metadatos de proyección de Codex.
6. Use Guardar para escribir la configuración o Guardar y publicar cuando el Gateway en ejecución deba aplicar la configuración modificada.
7. Ejecute openclaw mcp status --verbose, openclaw mcp doctor --probe o openclaw mcp reload desde un terminal para realizar diagnósticos estáticos, comprobaciones en vivo o descartar el entorno de ejecución almacenado en caché.

La página censura los valores similares a URL que contienen credenciales antes de mostrarlos y entrecomilla los nombres de los servidores en los fragmentos de comandos para que los comandos copiados sigan funcionando con espacios o metacaracteres del shell. Referencia completa de la CLI y la configuración: MCP.

Pestaña Actividad

La pestaña Actividad se encuentra en Configuración › Sistema, junto a Registros y Depuración. Es un observador efímero y local del navegador para la actividad de herramientas en vivo, derivado del mismo flujo de eventos session.tool y de herramientas del Gateway que alimenta las tarjetas de herramientas del Chat. No añade otra familia de eventos del Gateway, punto de conexión, almacén de actividad persistente, fuente de métricas ni flujo de observación externo.

Las entradas de Actividad solo conservan resúmenes saneados y vistas previas censuradas y truncadas de la salida. Los valores de los argumentos de las herramientas no se almacenan en el estado de Actividad; la interfaz indica que los argumentos están ocultos y solo registra el número de campos de argumentos. La lista en memoria pertenece a la pestaña actual del navegador, persiste al navegar dentro de la interfaz de control y se restablece al recargar la página, cambiar de sesión o seleccionar Borrar.

Terminal del operador

El terminal acoplable del operador está deshabilitado de forma predeterminada. Para habilitarlo, establezca gateway.terminal.enabled: true y reinicie el Gateway. El terminal requiere una conexión operator.admin y abre una PTY del host en el espacio de trabajo del agente activo. Las pestañas nuevas siguen al agente de chat seleccionado actualmente.

Use Ctrl + acento grave para mostrar u ocultar el panel acoplable. El diseño permite acoplarlo en la parte inferior o derecha, cambia de tamaño con la ventana gráfica del navegador y mantiene varias pestañas de shell. Consulte Configuración del Gateway para conocer gateway.terminal.enabled y la anulación opcional gateway.terminal.shell.

Las sesiones de Codex y Claude Code detectadas en la barra lateral de sesiones pueden abrirse en su CLI nativa dentro del mismo panel de terminal. En Configuración › Chat, establezca Abrir sesiones de Codex/Claude en en Terminal para que un clic normal en una fila abra codex resume o claude --resume; el visor de solo lectura de OpenClaw sigue siendo la opción predeterminada. El menú contextual o el menú de tres puntos de una fila siempre ofrece ambas opciones, y el encabezado del visor incluye Abrir en terminal cuando la sesión cumple los requisitos.

Los requisitos se evalúan por sesión y por host. Las sesiones locales del Gateway inician el comando de reanudación propiedad del proveedor en el host del Gateway. Las sesiones de nodos emparejados inician un comando del proveedor incluido en la lista de permitidos en el nodo propietario y retransmiten únicamente los eventos de salida, entrada y cambio de tamaño de esa PTY; esto no expone un shell general del nodo ni acepta comandos proporcionados por el navegador. Los nodos que no anuncian el comando correspondiente para reanudar el terminal, incluidos los puentes de trabajadores integrados sin transmisión bidireccional, mantienen disponible el visor e indican que la apertura del terminal no está disponible.

Las sesiones persisten tras las desconexiones: una recarga de la página, la suspensión del portátil o una interrupción breve de la red desvincula la sesión en el Gateway en lugar de terminarla, y la misma pestaña del navegador vuelve a vincularse al reconectar y reproduce la salida reciente. Las sesiones desvinculadas se terminan después de gateway.terminal.detachedSessionTimeoutSeconds (300 segundos de forma predeterminada; 0 restablece la terminación al desconectarse). terminal.list muestra las sesiones que se pueden vincular, terminal.attach adopta una (toma de control al estilo de tmux) y terminal.text lee la salida reciente de una sesión como texto sin formato sin vincularse, una función destinada a agentes y herramientas.

El terminal también está disponible como documento de pantalla completa dedicado exclusivamente al terminal en /?view=terminal. Las aplicaciones para iOS y Android integran esta página en sus pantallas de Terminal y reutilizan las credenciales almacenadas del Gateway; la disponibilidad depende de las mismas restricciones gateway.terminal.enabled y operator.admin, y la página muestra un aviso cuando el Gateway conectado no ofrece el terminal.

Panel del navegador

La interfaz de control incluye un panel del navegador acoplable que representa el navegador controlado por el Gateway (el mismo que los agentes manejan mediante la herramienta de navegador) en cualquier navegador web convencional, sin necesidad de una vista web nativa. Aparece cuando el Gateway conectado anuncia browser.request a una conexión operator.admin; el botón del globo terráqueo en la barra del espacio de trabajo de la sesión permite mostrarlo u ocultarlo. El panel muestra una instantánea en vivo de la página con pestañas, una barra de URL editable, controles para retroceder, avanzar y recargar, y una opción para abrirla en el navegador; puede acoplarse a la derecha o en la parte inferior y reenvía los clics, el desplazamiento con la rueda y la escritura básica a la página remota.

Dos modos de captura preparan el contexto de la página para el agente:

• Anotar (lápiz): dibuje marcas a mano alzada sobre la página. Enviar al chat combina los trazos con la captura de pantalla, adjunta la imagen al redactor del chat activo y rellena previamente una instrucción que describe la URL y el título de la página, así como cada región marcada, para que el agente sepa exactamente qué se ha rodeado.
• Inspeccionar (puntero): pase el cursor para ver el elemento situado debajo (selector, nombre accesible, rol y tamaño); haga clic para enviar los detalles de ese elemento junto con una captura de pantalla resaltada mediante el mismo flujo del redactor. La inspección, el desplazamiento con la rueda y los controles de retroceso y avance requieren browser.evaluateEnabled (habilitado de forma predeterminada).

La aplicación para macOS conserva su barra lateral nativa de navegación de enlaces para los enlaces pulsados en el panel; el panel del navegador también funciona allí y permite anotar páginas en todas las demás plataformas.

Comportamiento del chat

Pérdida de conexión y reconexión

Una vez establecida una sesión, una interrupción de la conexión con el Gateway no cierra la sesión. El panel permanece visible con una pastilla ámbar flotante "Gateway connection lost — Reconnecting…" debajo de la barra superior mientras el cliente reintenta automáticamente con espera incremental (de 800 ms hasta 15 s). Las actualizaciones en directo y las acciones de tiempo real o de sesión se pausan hasta que vuelve la conexión; Retry now en la pastilla fuerza un intento inmediato. El chat sigue siendo editable: los envíos de texto ordinario y archivos adjuntos se conservan en el almacenamiento del navegador de la pestaña actual, delimitado por Gateway y sesión, se muestran como pendientes de reconexión y se envían automáticamente cuando vuelve el Gateway. Los controles en directo y los comandos con barra permanecen indisponibles mientras no haya conexión.

Cuando este navegador ya contiene credenciales (un token o una contraseña configurados, o un token de dispositivo aprobado), las primeras aperturas y las recargas muestran una pequeña marca animada de OpenClaw mientras se establece la conexión, en lugar de mostrar brevemente la pantalla de inicio de sesión. Esta pantalla solo aparece cuando aún no hay credenciales almacenadas o cuando el Gateway las rechaza activamente (token o contraseña incorrectos, vinculación revocada); estos estados requieren intervención en lugar de esperar.

Instalación de la PWA y notificaciones web push

La interfaz de control incluye un manifest.webmanifest y un service worker, por lo que los navegadores modernos pueden instalarla como una PWA independiente. Web Push permite que el Gateway active la PWA instalada con notificaciones incluso cuando la pestaña o la ventana del navegador no están abiertas.

Si la página muestra Protocol mismatch justo después de una actualización de OpenClaw, primero vuelva a abrir el panel con openclaw dashboard y realice una actualización forzada. Si el problema persiste, borre los datos del sitio del origen del panel o pruebe en una ventana privada del navegador; una pestaña antigua o la caché del service worker del navegador pueden seguir ejecutando un paquete de la interfaz de control anterior a la actualización contra el Gateway más reciente.

Anule el par de claves VAPID mediante variables de entorno en el proceso del Gateway cuando desee fijar las claves (despliegues con varios hosts, rotación de secretos o pruebas):

• OPENCLAW_VAPID_PUBLIC_KEY
• OPENCLAW_VAPID_PRIVATE_KEY
• OPENCLAW_VAPID_SUBJECT (el valor predeterminado es https://openclaw.ai)

La interfaz de control utiliza estos métodos del Gateway restringidos por ámbito para registrar y probar las suscripciones del navegador:

• push.web.vapidPublicKey obtiene la clave pública VAPID activa.
• push.web.subscribe registra un endpoint más keys.p256dh/keys.auth.
• push.web.unsubscribe elimina un endpoint registrado.
• push.web.test envía una notificación de prueba a la suscripción de quien realiza la llamada.

Contenido alojado incrustado

Los mensajes del asistente pueden mostrar contenido web alojado en línea con el shortcode [embed ...]. La política del sandbox del iframe se controla mediante gateway.controlUi.embedSandbox:

El Plugin Canvas incluido también proporciona show_widget para representar SVG o HTML autocontenido directamente desde una llamada de herramienta. El navegador anuncia la capacidad inline-widgets del Gateway, y el documento de Canvas resultante sigue disponible cuando se vuelve a cargar el historial del chat. Las ejecuciones originadas en canales no reciben esta herramienta.

{  gateway: {    controlUi: {      embedSandbox: "scripts",    },  },}

Las URL externas absolutas de contenido incrustado http(s) permanecen bloqueadas de forma predeterminada. Para permitir que [embed url="https://..."] cargue páginas de terceros, establezca gateway.controlUi.allowExternalEmbedUrls: true.

Ancho de los mensajes del chat

La transcripción del chat utiliza un marco centrado y legible alineado con el editor. La salida del asistente y de las herramientas permanece alineada a la izquierda, mientras que las burbujas del usuario permanecen alineadas a la derecha dentro de ese marco. Los despliegues con monitores anchos pueden anular el ancho de la transcripción sin modificar el CSS incluido estableciendo gateway.controlUi.chatMessageMaxWidth:

{  gateway: {    controlUi: {      chatMessageMaxWidth: "min(1280px, 82%)",    },  },}

El valor se valida antes de llegar al navegador. Los formatos admitidos incluyen longitudes simples y porcentajes como 960px o 82%, además de expresiones de ancho restringidas min(...), max(...), clamp(...), calc(...) y fit-content(...).

Acceso mediante tailnet (recomendado)

openclaw gateway --tailscale serve

openclaw gateway --bind tailnet --token "$(openssl rand -hex 32)"

HTTP no seguro

Si abre el panel mediante HTTP sin cifrar (http://<lan-ip> o http://<tailscale-ip>), el navegador se ejecuta en un contexto no seguro y bloquea WebCrypto. De forma predeterminada, OpenClaw bloquea las conexiones de la interfaz de control sin identidad de dispositivo.

Excepciones documentadas:

• compatibilidad con HTTP no seguro solo para localhost mediante gateway.controlUi.allowInsecureAuth=true
• autenticación correcta del operador en la interfaz de control mediante gateway.auth.mode: "trusted-proxy"
• mecanismo de emergencia gateway.controlUi.dangerouslyDisableDeviceAuth=true

Solución recomendada: utilice HTTPS (Tailscale Serve) o abra la interfaz de usuario localmente en https://<magicdns>/ (Serve) o http://127.0.0.1:18789/ (en el host del gateway).

{  gateway: {    controlUi: { allowInsecureAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

{  gateway: {    controlUi: { dangerouslyDisableDeviceAuth: true },    bind: "tailnet",    auth: { mode: "token", token: "replace-me" },  },}

Consulte Tailscale para obtener instrucciones de configuración de HTTPS.

Política de seguridad de contenido

La interfaz de control incluye una política img-src estricta: solo se permiten recursos del mismo origen, URL data: y URL blob: generadas localmente. El navegador rechaza las URL de imágenes http(s) remotas y relativas al protocolo, y nunca realiza solicitudes de red para ellas.

En la práctica:

• Los avatares y las imágenes servidos mediante rutas relativas (por ejemplo, /avatars/<id>) siguen mostrándose, incluidas las rutas de avatares autenticadas que la interfaz obtiene y convierte en URL blob: locales.
• Las URL data:image/... insertadas siguen mostrándose.
• Las URL blob: locales creadas por la interfaz de control siguen mostrándose.
• El Gateway obtiene los avatares de las vistas previas de enlaces de GitHub desde el host fijo de avatares de GitHub y los devuelve como URL data: acotadas; el navegador del operador nunca contacta con el host remoto de avatares.
• Las URL de avatares remotos emitidas por los metadatos del canal se eliminan en los auxiliares de avatares de la interfaz de control y se sustituyen por el logotipo o distintivo integrado, de modo que un canal comprometido o malicioso no pueda forzar la obtención de imágenes remotas arbitrarias desde el navegador de un operador.

Esta protección está siempre activa y no se puede configurar.

Autenticación de la ruta de avatares

Cuando se configura la autenticación del Gateway, el punto de conexión de avatares de la interfaz de control requiere el mismo token del Gateway que el resto de la API:

• GET /avatar/<agentId> devuelve la imagen del avatar solo a solicitantes autenticados. GET /avatar/<agentId>?meta=1 devuelve los metadatos del avatar conforme a la misma regla.
• Las solicitudes no autenticadas a cualquiera de las rutas se rechazan (al igual que en la ruta relacionada de contenido multimedia del asistente), por lo que la ruta de avatares no puede filtrar la identidad del agente en hosts que, por lo demás, están protegidos.
• La interfaz de control reenvía el token del Gateway como encabezado de portador al obtener avatares y utiliza URL de blob autenticadas para que la imagen siga mostrándose en los paneles.

Si se desactiva la autenticación del Gateway (no recomendado en hosts compartidos), la ruta de avatares también deja de requerir autenticación, en consonancia con el resto del Gateway.

Autenticación de la ruta de contenido multimedia del asistente

Cuando se configura la autenticación del Gateway, las vistas previas de contenido multimedia local del asistente utilizan una ruta de dos pasos:

• GET /__openclaw__/assistant-media?meta=1&source=<path> requiere la autenticación normal de operador de la interfaz de control; el navegador envía el token del Gateway como encabezado de portador al comprobar la disponibilidad.
• Las respuestas correctas de metadatos incluyen un mediaTicket de corta duración limitado a esa ruta de origen exacta.
• Las URL de imágenes, audio, vídeo y documentos que muestra el navegador utilizan mediaTicket=<ticket> en lugar del token o la contraseña activos del Gateway. El ticket caduca rápidamente y no puede autorizar un origen diferente.

Esto mantiene la representación de contenido multimedia compatible con los elementos multimedia nativos del navegador sin incluir credenciales reutilizables del Gateway en URL de contenido multimedia visibles.

Enlaces de aprobación

Las notificaciones de aprobación del operador pueden incluir enlaces directos a un documento de aprobación independiente servido bajo el espacio de nombres reservado ${controlUiBasePath}/approve/{approvalId} (por ejemplo, /approve/<approvalId>, o /openclaw/approve/<approvalId> con una ruta base configurada). La URL permanece estable durante la vigencia de la aprobación y se puede reenviar de forma segura entre dispositivos propios: identifica la aprobación, pero nunca la autoriza.

• El espacio de nombres de un segmento /approve/<approvalId> está reservado por el Gateway antes que las rutas HTTP de los plugins para todos los métodos HTTP, por lo que una ruta de plugin nunca puede ocultar ni interceptar un documento de aprobación.
• Para abrir un documento de aprobación se requiere la misma autenticación del Gateway que para el resto de la interfaz de control (token/contraseña, identidad de Tailscale Serve o identidad de proxy de confianza); las credenciales nunca forman parte de la URL de aprobación.
• Cuando se desactiva el servicio de la interfaz de control, las solicitudes al espacio de nombres devuelven 404 en lugar de pasar a los controladores de plugins.
• El inicio de sesión en un documento de aprobación es efímero para esa página: no sobrescribe la selección ni la configuración del Gateway guardadas por la interfaz de control completa en el mismo navegador.

El Gateway sirve archivos estáticos desde dist/control-ui:

pnpm ui:build

Base absoluta opcional (URL de recursos fijas):

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

Desarrollo local (servidor de desarrollo independiente):

pnpm ui:dev

A continuación, configure la interfaz para que apunte a la URL WS del Gateway (por ejemplo, ws://127.0.0.1:18789).

Página en blanco de la interfaz de control

Si el navegador carga un panel en blanco y DevTools no muestra ningún error útil, es posible que una extensión o un script de contenido ejecutado en una fase temprana haya impedido evaluar la aplicación de módulos JavaScript. La página estática incluye un panel de recuperación HTML sencillo que aparece cuando <openclaw-app> no se registra tras el inicio.

Use la acción Try again del panel después de cambiar el entorno del navegador, o recargue manualmente después de realizar estas comprobaciones:

• Desactive las extensiones que insertan contenido en todas las páginas, especialmente las extensiones con scripts de contenido <all_urls>.
• Pruebe una ventana privada, un perfil de navegador limpio u otro navegador.
• Mantenga el Gateway en ejecución y compruebe la misma URL del panel después de cambiar el navegador.

Depuración y pruebas: servidor de desarrollo + Gateway remoto

La interfaz de control consta de archivos estáticos; el destino WebSocket se puede configurar y puede ser distinto del origen HTTP. Esto resulta útil cuando se desea ejecutar localmente el servidor de desarrollo de Vite, pero el Gateway se ejecuta en otro lugar.

pnpm ui:dev

http://localhost:5173/?gatewayUrl=ws%3A%2F%2F<gateway-host>%3A18789

http://localhost:5173/?gatewayUrl=wss%3A%2F%2F<gateway-host>%3A18789#token=<gateway-token>

{  gateway: {    controlUi: {      allowedOrigins: ["http://localhost:5173"],    },  },}

Detalles de configuración del acceso remoto: Acceso remoto.

Contenido relacionado

• Panel — panel del Gateway
• Comprobaciones de estado — supervisión del estado del Gateway
• TUI — interfaz de usuario de terminal
• Chat web — interfaz de chat basada en navegador