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.

Mientras se observa una sesión en ejecución, el Gateway puede usar el modelo auxiliar de ese agente para generar un resumen de estado compacto. El chat lo muestra como una insignia de estado de una línea que se expande en una tarjeta con la evaluación, el progreso del plan, los pull requests y el tiempo transcurrido. La tarjeta puede expandirse una vez cuando una ejecución se bloquea o necesita información; el chat lateral /btw tiene prioridad sobre la tarjeta expandida.

La tarjeta expandida también acepta preguntas breves sobre la ejecución. Las respuestas usan únicamente el resumen actual del observador y notas acotadas y depuradas, permanecen en el navegador durante esa sesión y nunca entran en la ejecución principal del agente ni la interrumpen. Si las observaciones no contienen la respuesta, el observador indica que no puede saberla.

Cuando llega el primer resumen, este pasa a controlar el subtítulo de esa ejecución en la barra lateral en lugar de la actividad en vivo heurística. Un resumen final de ejecución completada o fallida permanece visible mientras la sesión no se haya leído; después, la fila vuelve a mostrar su subtítulo de trabajo normal.

La observación de sesiones está habilitada de forma predeterminada. En Configuración > Apariencia > Barra lateral, se puede desactivar para todo el Gateway, consultar el modelo pequeño resuelto y su procedencia, elegir el enrutamiento automático, deshabilitar las tareas auxiliares o seleccionar un agents.defaults.utilityModel explícito. Los controles de configuración equivalentes son gateway.controlUi.sessionObserver: false y agents.defaults.utilityModel: "".

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"

La autenticación del Gateway se ejecuta antes del emparejamiento del dispositivo. Una conexión directa de bucle invertido no omite la autenticación mediante token o contraseña. El panel de configuración conserva un token para la sesión actual de la pestaña del navegador y la URL del Gateway seleccionada; las contraseñas no se conservan. Tras el emparejamiento, el navegador puede usar su token almacenado por dispositivo en conexiones posteriores.

La incorporación suele configurar un token del Gateway para la autenticación mediante secreto compartido. Si el Gateway se inicia en modo de token sin un token configurado, genera en su lugar un token efímero de tiempo de ejecución para ese proceso. El token de tiempo de ejecución no se escribe en la configuración, por lo que openclaw config get gateway.auth.token no puede recuperarlo y se rechaza un navegador de bucle invertido que no tenga ese token. Ejecute openclaw doctor --generate-gateway-token, reinicie el Gateway y pegue después el token configurado en la configuración de la interfaz de control. También se puede usar la autenticación mediante contraseña cuando gateway.auth.mode es "password".

Emparejamiento de dispositivos (primera conexión)

Después de que la autenticación del Gateway se complete correctamente, 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 queda reemplazada y se crea un nuevo requestId; vuelva a ejecutar openclaw devices list antes de aprobarla.

El cambio de un navegador remoto ya emparejado desde acceso de lectura a acceso de escritura/administración se trata como una ampliación de 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 conexión de bucle invertido directo válida de la interfaz de control puede aprobar silenciosamente la ampliación después de autenticarse.

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

Emparejar un dispositivo móvil

Un administrador ya emparejado puede crear el código QR de conexión para iOS/Android sin abrir una 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 código 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); el valor ws:// sin cifrar está limitado al bucle invertido y a direcciones LAN privadas. Consulte Emparejamiento para obtener todos los detalles de seguridad y alternativas.

Identidad personal (local del navegador)

La interfaz de control admite una identidad personal por navegador (nombre para mostrar y avatar) asociada a los mensajes salientes para atribuir su autoría en sesiones compartidas. Se guarda en el almacenamiento del navegador, limitada al perfil de navegador 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, se restablece como vacía.

La sustitución del avatar del asistente sigue el mismo patrón local del navegador: las sustituciones cargadas se superponen localmente sobre la identidad resuelta por el Gateway y nunca realizan un recorrido de ida y vuelta a través de config.patch. El campo de configuración compartido ui.assistant.avatar sigue disponible para clientes sin interfaz de usuario que escriban el campo directamente.

Endpoint de configuración de tiempo de ejecución

La interfaz de control obtiene su configuración de tiempo de ejecución desde /control-ui-config.json, resuelto con respecto 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 acceder a él y, para obtenerlo correctamente, se requiere un token o 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 → General para ver la tarjeta Host del Gateway, que muestra la máquina 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 durante la primera carga según la configuración regional del navegador. Para cambiarla posteriormente, abra Configuración -> General -> Idioma (el selector se encuentra en la página 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 posteriores.
• 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 muestra los códigos de configuración regional que Mintlify acepta. La documentación en tailandés (th) y persa (fa) también se genera en el repositorio de publicación; es posible 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 un espacio 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 de 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 solo se almacenan en el perfil de navegador actual; no se escriben en la configuración del Gateway ni se sincronizan entre dispositivos. Al reemplazar el tema importado se actualiza el único espacio local; al borrarlo, se vuelve a Claw si el tema importado estaba activo.

Apariencia también incluye una opción de tamaño del texto. Se aplica al texto del chat, al texto del compositor, a las tarjetas de herramientas y a las barras laterales del chat, y mantiene las entradas de texto en un mínimo de 16px para que Safari móvil no amplíe automáticamente la vista al enfocarlas.

Las preferencias de tema, modo del tema, tamaño del texto, idioma y visualización del chat se sincronizan mediante la configuración del Gateway (ui.prefs), por lo que se mantienen en todos los dispositivos y los agentes pueden modificarlas a través de la puerta de aprobación; los clientes conectados aplican los cambios en tiempo real mediante el aviso config.changed del Gateway. Cada navegador conserva una copia local para iniciarse al instante; los clientes que no pueden escribir en la configuración (alcance de visualización, sin conexión) mantienen los cambios únicamente en el dispositivo. Consulte la referencia de configuración.

Mantenimiento del sistema OpenClaw

Abra Settings → Ask OpenClaw para comunicarse con el agente de configuración y reparación del sistema. Fuera de la incorporación, esta página puede mostrar como máximo un indicador de evento descartable por visita. Permanece en silencio durante el tráfico rutinario del Gateway y solo reacciona a instantáneas de estado que informan de un recargador de configuración deshabilitado, la desconexión o degradación de un canal configurado, una comprobación de canal fallida o credenciales de canal no disponibles. Un evento más reciente sustituye el indicador pendiente solo cuando es más grave; descartar o utilizar el indicador silencia los avisos de eventos durante esa visita. Al hacer clic en el indicador, su pregunta de diagnóstico se envía como un mensaje openclaw.chat real, de modo que la transcripción registra la solicitud y OpenClaw realiza el diagnóstico. Estos indicadores de eventos nunca se muestran durante la incorporación.

Gestionar plugins

Abra Plugins en la barra lateral o use /settings/plugins en relación con 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 utiliza /openclaw/settings/plugins. La página siempre está 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 detallada; 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 en línea. Los mismos controles de servidor se encuentran en Settings → MCP. La pestaña Descubrir es la tienda: plugins destacados incluidos con OpenClaw, plugins externos oficiales y conectores MCP de un solo clic para servicios populares. Al escribir en el cuadro de búsqueda, se consulta ClawHub en línea y se añade una sección De ClawHub con recuentos de descargas e insignias de verificación de la fuente. Los enlaces profundos pueden dirigirse directamente a la tienda con /settings/plugins?tab=discover.

La pestaña Skills conserva el informe de estado de las Skills, los controles para habilitarlas o deshabilitarlas, la introducción de claves de API y la búsqueda en línea de Skills de ClawHub, limitados al agente seleccionado. La pestaña Taller contiene 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 las más recientes hasta las más antiguas, y deja los resultados como propuestas pendientes. El panel muestra la cobertura acumulada; Analizar trabajos anteriores continúa desde el cursor persistente y, una vez agotado el historial anterior, se convierte en Analizar trabajos nuevos. La revisión manual del historial funciona mientras el autoaprendizaje autónomo está deshabilitado y utiliza 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 pueden eliminarse, solo deshabilitarse.

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

Las instalaciones desde ClawHub se ejecutan mediante el Gateway y mantienen las mismas comprobaciones de confianza, integridad y políticas 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 ejecutar una vez 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 arbitrarias de npm, git o rutas locales, actualizaciones y configuración avanzada de plugins.

Aplicaciones y extensiones

Abra Aplicaciones desde el menú Más de la barra lateral, la paleta de comandos o el menú del agente de la barra lateral (Obtener las aplicaciones), o use /apps en relación con la ruta base configurada de la interfaz de control. La página reúne enlaces de instalación para todas las superficies complementarias de OpenClaw: las aplicaciones de iOS y Android, los complementos de Apple Watch y Wear OS incluidos con ellas, las aplicaciones de escritorio para macOS, Windows y Linux, la extensión de Chrome, el centro Plugins integrado en la aplicación con ClawHub, y la comunidad de Discord y la documentación.

Navegación de la barra lateral

La barra lateral organiza todo en torno al agente. La fila de identidad de la parte superior corresponde al agente activo; debajo, la sección Páginas comienza con Inicio —la sesión principal continua del agente, con una insignia que indica su estado no leído o en ejecución—, seguida de los destinos fijados (Automatizaciones y Plugins de forma predeterminada). El control de personalización del encabezado Páginas abre un menú con todos los demás destinos, incluidos Uso y las pestañas proporcionadas por plugins, además de Editar elementos fijados; al hacer clic con el botón derecho en el área de navegación se abre directamente el editor de elementos fijados. La lista de sesiones inferior se divide en zonas: Hilos para las sesiones de chat del agente (la sesión principal permanece detrás de Inicio; las sesiones que esta inicia aparecen aquí como hilos de nivel superior y los hilos con nombre se muestran sin prefijo de tipo), Grupos para las conversaciones de grupos y salas, y Programación para las sesiones vinculadas a un árbol de trabajo gestionado o un Node de ejecución (las filas muestran una línea repo ⎇ branch además del host del Node), las sesiones de arnés respaldadas por ACP y los catálogos de las CLI de Codex/Claude. Programación comienza contraída en la primera ejecución y recuerda la elección; su encabezado contraído conserva el recuento real y muestra un indicador de ejecución mientras trabajan las sesiones que contiene. Los grupos personalizados (la sesión category) y las filas Fijadas se sitúan por encima de Hilos, y asignar una sesión a un grupo personalizado siempre prevalece sobre la clasificación automática por zonas. El encabezado Hilos contiene el control de ordenación (Creación o Última actualización, Agrupar por y un filtro persistente de Estado para Activas, Archivadas o Todas) y el botón + que abre la página Nueva sesión. Las filas archivadas permanecen en línea, atenuadas y con un glifo de archivo; no contribuyen al estado no leído ni de atención y quedan fuera de la promoción de linaje. Abrir una sesión desplaza el resaltado de selección sin reordenar las filas. Las sesiones principales con ejecuciones secundarias recientes muestran un control de despliegue y el número de sesiones secundarias; expándalo para consultar las sesiones secundarias anidadas, su estado activo o terminal y el entorno de ejecución sin salir de la barra lateral. Al seleccionar una sesión secundaria, se abre su chat y se revela automáticamente la ruta de sus antecesores. Las filas secundarias permanecen fuera de la agrupación raíz, la fijación, el arrastre, la selección múltiple y la paginación; las zonas contraídas no consumen el límite de la página visible. Las sesiones con actividad nueva desde su última lectura muestran un punto de no leído y, al abrir una, se marca como leída. Un agente también puede publicar una breve línea de estado con vencimiento y solicitar atención opcionalmente mediante un icono ámbar seleccionado; esa declaración se borra al abrir la sesión, enviar el siguiente mensaje, borrarla explícitamente o cuando vence su TTL. Los estados del ciclo de vida de los trabajadores en la nube utilizan una insignia de globo; las sesiones locales y recuperadas omiten la insignia de ubicación porque la ejecución local es la opción predeterminada. Cada fila de sesión raíz tiene un menú contextual (botón de 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 Eliminar del grupo), Archivar o Desarchivar y Eliminar; los diseños táctiles mantienen visibles los controles directos de fijación y menú. Cmd/Ctrl-clic alterna las filas raíz en una selección múltiple y Mayús-clic la amplía siguiendo el orden visible; al abrir el menú en 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 raíz a Fijadas para fijarla o a un grupo personalizado para moverla. Los encabezados de grupos personalizados pueden contraerse, expandirse o arrastrarse para reordenarlos; los nombres de los grupos y su orden se almacenan en el Gateway (sessions.groups.*), por lo que se mantienen en todos los 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 puntos verticales o clic derecho) con Cambiar nombre del grupo, Nuevo grupo y Eliminar grupo; cambiar el nombre de un grupo o eliminarlo actualiza todas las sesiones que lo integran en el servidor, incluidas las archivadas, y al eliminar un grupo se conservan sus sesiones y se devuelven a Hilos.

Página de nueva sesión

El botón + del encabezado de la lista de sesiones de la barra lateral abre un borrador a página completa en /new: no se crea nada hasta que se envía el primer mensaje. Un selector unificado de Ubicación elige la carpeta de trabajo y, para los operadores administradores, el destino de ejecución: Gateway · local, un Node emparejado que expone system.run o un perfil de nube disponible. La carpeta predeterminada es el espacio de trabajo del agente; otra ruta absoluta del Gateway requiere operator.admin, pero puede ejecutarse directamente sin ser un repositorio de Git. Cuando la carpeta seleccionada del Gateway es un repositorio de Git, el mismo selector ofrece aislamiento opcional mediante Árbol de trabajo, con un selector de rama base respaldado por worktrees.branches (sin recuperación) y un nombre opcional para el árbol de trabajo (la rama pasa a ser openclaw/<name>). Los trabajadores en la nube requieren esa ruta de árbol de trabajo gestionado; los Nodes emparejados nunca la exponen. El pie del editor elige el modelo y el nivel de razonamiento de la nueva sesión. Su control Incógnito crea un hilo exclusivo de la web cuya entrada de sesión, transcripción y estado de Compaction permanecen en memoria hasta que se reinicia el Gateway; OpenClaw también omite su volcado automático de memoria. El agente conserva sus herramientas normales, por lo que una solicitud explícita de guardado o una escritura de archivos mediante herramientas aún puede conservar datos. El proveedor del modelo sigue procesando los mensajes y se continúan registrando metadatos de auditoría sin contenido. Los inicios en la nube conservan las opciones de modelo y razonamiento antes de enviar la sesión a su trabajador.

En los gateways multiusuario, solo las conexiones con alcance de administrador pueden crear o ver hilos de incógnito, y las demás sesiones no pueden acceder a ellos mediante las herramientas de sesión del agente ni la búsqueda de transcripciones. El modo incógnito protege frente al almacenamiento y otros usuarios mediados por el Gateway, no frente al propietario del Gateway ni al operador del proceso, quienes siempre pueden observar las sesiones activas.

Explorar carpetas abre el explorador de directorios en línea del selector Ubicación, respaldado por el método fs.listDir exclusivo para administradores y limitado al Gateway o Node seleccionado. El Gateway y los Nodes con capacidad de exploración enumeran su sistema de archivos; un Node con capacidad de ejecución sin fs.listDir sigue aceptando una ruta absoluta escrita. Las ubicaciones recientes pueden restaurar conjuntamente una carpeta y su Node propietario sin transferir rutas entre hosts. Al enviar, se llama a sessions.create con el primer mensaje, por lo que la ejecución comienza en el mismo viaje de ida y vuelta 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 tras las 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 incluye Preguntar a OpenClaw y comienza con un campo Buscar en la configuración para encontrar rápidamente las secciones de configuración.

En la web de escritorio, un grupo fijo de controles en la parte superior izquierda del área de contenido —el equivalente web de la franja de la barra de título de macOS— contiene el control para contraer la barra lateral (⌘B) y el botón de búsqueda de la paleta de comandos (⌘K). Al hacer clic en la fila de identidad del agente en la parte superior de la barra lateral, se abre el menú del agente; Inicio abre la sesión principal. Cuando algo requiere atención —trabajos Cron fallidos o vencidos, autenticación del modelo próxima a caducar o caducada— aparecen indicadores de atención compactos sobre el pie de la barra lateral que enlazan con la página responsable. La fila de identidad muestra el avatar del agente (imagen de identidad o emoji), el nombre, el punto de conexión y un subtítulo en tiempo real. Su menú específico del agente contiene el selector de agentes integrado (configuraciones multiagente), Nuevo agente, «¿Qué puede hacer este agente?» y Configuración del agente. 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 almacena en el perfil del navegador. Al elegir un agente, Chat, Uso, Automatizaciones, Tareas, Panel de trabajo y Sesiones quedan limitados a ese agente. Cada página con ámbito específico ofrece un control Agente con Todos los agentes como vía de salida; 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 conserva su propia selección ?agent= y no sigue el ámbito compartido de la página. El pie es una única tarjeta de identidad de ancho completo que permanece disponible sin conexión y muestra Reconectando… debajo del último nombre de cuenta conocido. Abre el menú de la aplicación y la cuenta, cuyo encabezado de identidad del perfil va seguido de Configuración, Uso, vinculación móvil, Obtener las aplicaciones, Ayuda (ayuda, Discord, Documentación y el registro de cambios), una acción para reintentar sin conexión cuando sea necesario, el indicador de versión y compilación y el selector del modo de color. El indicador de compilación abre la página Acerca de. Cuando el Gateway se ejecuta desde un repositorio de 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 de un vistazo que el Gateway no corresponde a una versión publicada (las instalaciones de versiones publicadas nunca lo muestran). Mayús-Comando-Coma en plataformas Apple o Ctrl-Mayús-Coma en otras plataformas abre Configuración sin sustituir el atajo simple Comando-Coma del navegador. Al contraer la barra lateral (⌘B o el control del grupo), se oculta por completo para ofrecer un espacio de trabajo de ancho completo; mientras está contraída, el grupo superior izquierdo conserva el control para expandirla y la búsqueda, y añade un botón de conversación nueva, reflejando lo que la aplicación de macOS aloja de forma nativa en su barra de título. La barra lateral es el único elemento de navegación en el escritorio, sin barra superior. En ventanas estrechas, la barra lateral se sustituye por un panel deslizante tras una fila de encabezado compacta que contiene el control del panel, la marca y la búsqueda de la paleta de comandos; en teléfonos, Chat integra esa fila de navegación en su barra de título, con los controles de menú y búsqueda junto al título de la sesión. En la aplicación de macOS, la fila de encabezado independiente incorpora el espacio libre de la barra de título en una única franja compacta junto a los controles de la ventana. La navegación utiliza el historial normal del navegador, por lo que los botones de retroceso y avance permiten recorrerla; la aplicación de macOS añade un control nativo de la barra lateral junto a los controles de la ventana, además de gestos de deslizamiento en el panel táctil, con botones de retroceso y avance 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.

Las aprobaciones pendientes también generan un indicador de atención sobre el pie de la barra lateral; selecciónelo para abrir la página de Aprobaciones responsable.

Qué puede hacer (hoy)

Importar memoria del asistente

Abra Settings → Import Memory para incorporar la 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, 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. La aplicación vuelve a generar el plan antes de escribir, de modo que las selecciones obsoletas fallen de forma segura.
4. Si los archivos ya existen, active Replace existing imports, actualice la vista previa y confirme el reemplazo.

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

La planificación y la aplicación 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 por elemento antes de reemplazar 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 específica de MCP es una vista para operadores de los servidores MCP gestionados por OpenClaw en mcp.servers. No inicia los transportes MCP por sí misma; utilícela para inspeccionar y editar la configuración guardada y, después, use openclaw mcp doctor --probe cuando necesite una prueba del servidor en vivo.

Flujo de trabajo habitual:

1. Abra MCP desde la barra lateral.
2. Consulte las tarjetas de resumen para ver los recuentos de servidores totales, habilitados, con OAuth y filtrados.
3. Revise cada fila de servidor para comprobar el transporte, la habilitación, la autenticación, los filtros, los tiempos de espera y las sugerencias de comandos.
4. Añada, habilite, deshabilite o elimine servidores directamente en la página MCP. Elija explícitamente Streamable HTTP, SSE o stdio; las líneas de comandos stdio aceptan argumentos entre comillas, como rutas con espacios. Use la página Plugins para conectores y detección con un solo clic.
5. Edite la sección de configuración mcp con ámbito definido para campos avanzados del servidor, como variables de entorno, directorios de trabajo, 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, pruebas en vivo o descartar el entorno de ejecución almacenado en caché.

Antes de mostrar la página, se ocultan los valores similares a URL que contienen credenciales y se escriben entre comillas los nombres de servidor 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 de herramientas y del Gateway session.tool que alimenta las tarjetas de herramientas del chat. No añade otra familia de eventos del Gateway, endpoint, almacén de actividad persistente, flujo de métricas ni flujo de observación externo.

Las entradas de Actividad solo conservan resúmenes saneados y vistas previas de salida ocultas y truncadas. 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 registra únicamente el número de campos de argumentos. La lista en memoria corresponde a la pestaña actual del navegador, se conserva al navegar dentro de la interfaz de control y se restablece al recargar la página, cambiar de sesión o pulsar 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 un 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 el área visible del navegador y mantiene varias pestañas de shell. Consulte Configuración del Gateway para obtener información sobre gateway.terminal.enabled y la anulación opcional gateway.terminal.shell.

Los agentes autorizados por el propietario y sin entorno aislado pueden usar la herramienta terminal para trabajos prolongados o interactivos que el operador deba observar. Cada llamada a la herramienta puede abrir, leer, escribir, cambiar de tamaño, cerrar o enumerar los PTY del Gateway propios del agente. Las sesiones nuevas abren de forma predeterminada una pestaña de la interfaz de control conectada simultáneamente, para que el agente y el operador compartan la salida y cualquiera pueda escribir o cambiar el tamaño. El acceso del agente se limita exactamente a la sesión: un agente no puede leer ni controlar terminales creados por el operador ni terminales abiertos por otra sesión de agente.

Arrastre uno o más archivos al terminal activo o use el botón del clip para elegirlos. OpenClaw prepara cada archivo en la máquina propietaria del PTY y pega en el cursor las rutas absolutas entrecomilladas para el shell; nunca pulsa Intro ni ejecuta la entrada. Un indicador compacto del lote muestra el archivo actual y el número de archivos completados. Cancelar detiene el resto del lote sin pegar rutas; una transferencia fallida permanece visible para poder reintentar desde ese archivo sin volver a cargar los archivos completados. Se aceptan imágenes, PDF, archivos comprimidos y otros tipos de archivo de hasta 16 MiB por archivo. Los archivos preparados usan un directorio temporal privado del sistema en hosts POSIX (modo del directorio 0700, modo del archivo 0600) o un directorio dentro del límite de la ACL del perfil de usuario en Windows, además de un temporizador de limpieza de 24 horas; mueva o copie todo aquello que necesite conservar.

La inserción de rutas es compatible con PowerShell, cmd.exe y shells POSIX reconocidos (sh, Bash, Dash, Ash, Ksh, Zsh y Fish), incluido Git Bash en Windows. Se rechazan otras anulaciones del shell porque sus reglas de entrecomillado no pueden inferirse de forma segura; ejecute el Gateway dentro de WSL para disponer de un terminal WSL nativo y rutas de carga de Linux. También se rechazan las rutas cmd.exe que contienen % o !, porque ese shell expande esos caracteres incluso dentro de comillas dobles.

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 hilos de Codex/Claude en en Terminal para que al hacer clic normalmente en una fila se abra codex resume o claude --resume; de forma predeterminada se sigue usando el visor de solo lectura de OpenClaw. El menú contextual o de tres puntos de cada fila siempre ofrece ambas opciones, y el encabezado del visor incluye Abrir en el terminal cuando la sesión cumple los requisitos.

La idoneidad se determina 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 permitido del proveedor en el nodo propietario y retransmiten únicamente los eventos de salida, entrada y cambio de tamaño de ese PTY; esto no expone un shell general del nodo ni acepta comandos proporcionados por el navegador. Las cargas de archivos usan el comando de nodo terminal.upload, independiente y con tamaño limitado, y permanecen vinculadas a la sesión de terminal ya abierta. Apruebe la actualización del emparejamiento del nodo cuando ese comando aparezca por primera vez. Los nodos que no anuncian el comando correspondiente de reanudación del terminal, incluidos los puentes de procesos de trabajo integrados sin transmisión dúplex, mantienen disponible el visor e indican que no se puede abrir el terminal; los nodos antiguos aún pueden ejecutar un terminal, pero no pueden recibir archivos arrastrados.

Las sesiones propiedad de la conexión sobreviven a las desconexiones: una recarga de la página, la suspensión del portátil o una interrupción de red separa la sesión en el Gateway en lugar de finalizarla, y la misma pestaña del navegador vuelve a conectarse al restablecerse la conexión, con la salida reciente reproducida. Las sesiones separadas propiedad de la conexión se finalizan después de gateway.terminal.detachedSessionTimeoutSeconds (valor predeterminado: 300 segundos; 0 restaura la finalización al desconectarse). Conectarse a una de estas sesiones sigue funcionando como una toma de control al estilo de tmux.

Las sesiones propiedad del agente no están vinculadas a una conexión del navegador. terminal.attach añade cada navegador como visor sin asumir la propiedad, y cerrar una pestaña del visor solo desconecta ese navegador. El PTY permanece hasta que el agente propietario lo cierra, su proceso termina, una política lo deshabilita o el Gateway se apaga. terminal.list marca cada entrada como propiedad de la conexión o del agente, y terminal.text permite que una conexión de administrador lea la salida reciente en texto sin formato sin conectarse.

El terminal también está disponible como documento de pantalla completa que solo contiene el 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 condiciones 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 de navegador acoplable que representa el navegador controlado por el Gateway —el mismo que los agentes controlan 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 en la barra del espacio de trabajo del hilo 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; se acopla a la derecha o abajo y reenvía clics, desplazamientos con la rueda y escritura básica a la página remota.

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

• Anotar (lápiz): permite dibujar marcas a mano alzada sobre la página. Enviar al chat combina los trazos con la captura de pantalla, adjunta la imagen al editor 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 que hay debajo (selector, nombre accesible, rol y tamaño); haga clic para enviar los detalles de ese elemento y una captura de pantalla resaltada mediante el mismo flujo del editor. La inspección, el desplazamiento con la rueda y los controles de retroceso y avance requieren browser.evaluateEnabled (activado 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, la interrupción de la conexión con el Gateway no cierra la sesión. El panel permanece visible con una cápsula flotante ámbar que muestra "Gateway connection lost — Reconnecting…" debajo de la barra superior mientras el cliente vuelve a intentarlo automáticamente con espera incremental (desde 800 ms hasta 15 s). Las actualizaciones en directo y las acciones de tiempo real o de sesión se pausan hasta que se restablece la conexión; Retry now en la cápsula fuerza un intento inmediato. El chat continúa siendo editable: los envíos normales de texto y archivos adjuntos se conservan en el almacenamiento del navegador de la pestaña actual, limitado al Gateway y la 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 diagonal permanecen inaccesibles mientras no haya conexión, salvo que Stop puede poner en cola un ID de ejecución local exacto para reproducir la acción. Una detención solo de sesión no se reproduce porque podría comenzar un trabajo más reciente en esa sesión antes de que vuelva la 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. La pantalla de inicio de sesión solo aparece cuando todavía no hay credenciales almacenadas o cuando el Gateway las rechaza activamente (token o contraseña incorrectos, emparejamiento revocado); estos estados requieren una 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.

Dentro de la aplicación para macOS, la página de configuración de notificaciones muestra el permiso de notificaciones nativo de la aplicación en lugar de las notificaciones push del navegador, porque la aplicación entrega las notificaciones de forma nativa.

Si la página muestra Protocol mismatch justo después de una actualización de OpenClaw, vuelva a abrir primero el panel con openclaw dashboard y realice una actualización forzada. Si el problema persiste, borre los datos del sitio correspondientes al 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.

Las actualizaciones desde los almacenes retirados push/vapid-keys.json y push/web-push-subscriptions.json se importan mediante openclaw doctor --fix. Detenga el Gateway antes de ejecutar esa reparación para que un proceso antiguo no pueda volver a crear el estado retirado durante la importación. Ejecute la reparación antes de utilizar Web Push tras una actualización; el registro, la entrega, la eliminación y la resolución de claves se niegan a continuar mientras persista cualquiera de los orígenes retirados o una reclamación interrumpida de Doctor. El entorno de ejecución del Gateway solo lee y escribe en SQLite.

Reemplace el par de claves VAPID mediante variables de entorno del proceso del Gateway cuando se necesite fijar las claves (implementaciones 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 junto con 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 insertado alojado

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

La herramienta principal show_widget representa SVG o HTML autocontenido directamente desde una llamada de herramienta. El navegador y los clientes de chat nativos compatibles anuncian la capacidad inline-widgets del Gateway, y el documento de Canvas resultante continúa disponible cuando se vuelve a cargar el historial del chat. Las Activities de Discord proporcionan el mismo nombre de herramienta en Discord; las ejecuciones procedentes de otros canales no la reciben.

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

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

Diseño de la transcripción del chat

El registro del chat utiliza un marco legible centrado y alineado con el compositor. La salida del asistente y de las herramientas permanece alineada a la izquierda, mientras que los mensajes propios permanecen alineados a la derecha dentro de ese marco. En las sesiones multiusuario (por ejemplo, un chat grupal retransmitido desde un plugin de canal), los mensajes de otros participantes identificados se muestran alineados a la izquierda con el avatar y el nombre del autor, además de un color estable por identidad, de modo que solo los mensajes del usuario que ha iniciado sesión se perciban como «míos». Cuando hay dos o más participantes identificados, las respuestas del asistente incluyen un pequeño indicador «En respuesta a nombre» que nombra al participante cuyo mensaje activó el turno. Las entradas del sistema, como la salida local de comandos con barra, se muestran como filas de aviso centradas sin avatar.

Ancho de los mensajes del chat

Quienes usan monitores anchos pueden sustituir el ancho del registro en Configuración → Chat → Ancho de los mensajes. La preferencia permanece en el almacenamiento local de ese navegador. Las formas compatibles incluyen longitudes simples y porcentajes como 960px o 82%, además de expresiones de ancho restringidas min(...), max(...), clamp(...), calc(...) y fit-content(...).

Acceso a la 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.

La excepción compatible sin dispositivo es la autenticación correcta del operador de la interfaz de control mediante gateway.auth.mode: "trusted-proxy". No existe ningún conmutador de configuración persistente que desactive la identidad del dispositivo.

Solución recomendada: use 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).

Consulte Tailscale para obtener instrucciones sobre la 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 remotas http(s) y las 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 de usuario obtiene y convierte en URL blob: locales.
• Las URL data:image/... insertadas directamente siguen mostrándose.
• Las URL blob: locales creadas por la interfaz de control siguen mostrándose.
• El Gateway obtiene de GitHub los avatares de las vistas previas de enlaces de GitHub desde su host fijo de avatares y los devuelve como URL data: delimitadas; el navegador del operador nunca contacta con el host remoto de avatares.
• Las URL remotas de avatares 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 puede configurarse.

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 únicamente a solicitantes autenticados. GET /avatar/<agentId>?meta=1 devuelve los metadatos del avatar según la misma regla.
• Las solicitudes no autenticadas a cualquiera de las rutas se rechazan (al igual que en la ruta contigua 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 desactiva la autenticación del Gateway (no se recomienda en hosts compartidos), la ruta de avatares también deja de requerir autenticación, de acuerdo 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 del 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 de metadatos correctas incluyen un mediaTicket de corta duración limitado a esa ruta de origen exacta.
• Las URL de imágenes, audio, vídeo y documentos mostradas por 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 otro origen.

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

Enlaces de aprobación

Las notificaciones de aprobación del operador pueden incluir enlaces directos a un documento de aprobación independiente servido en 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 puede reenviarse de forma segura entre dispositivos propios: identifica la aprobación, pero nunca la autoriza.

• El Gateway reserva el espacio de nombres de un solo segmento /approve/<approvalId> 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.
• Abrir un documento de aprobación requiere la misma autenticación del Gateway que 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, dirija la interfaz de usuario a la URL de WebSocket 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 inicial haya impedido la evaluación de la aplicación de módulos JavaScript. La página estática incluye un panel de recuperación HTML simple que aparece cuando <openclaw-app> no se registra después del inicio.

Use la acción Volver a intentarlo del panel después de cambiar el entorno del navegador, o recargue manualmente después de estas comprobaciones:

• Desactive las extensiones que insertan contenido en todas las páginas, especialmente las que tengan scripts de contenido <all_urls>.
• Pruebe con 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 de navegador.

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

La interfaz de control está formada por archivos estáticos; el destino de WebSocket es configurable y puede diferir 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.

Temas relacionados

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