Control UI: la consola dentro del navegador
OpenClaw Control UI es la consola de navegador incluida con el Gateway: openclaw dashboard un comando la abre, y sesiones, aprobaciones, archivos, configuración y terminal están todos en una sola página. En la lección anterior dijimos que hay tres tipos de entrada cotidiana; esta lección se centra exclusivamente en la más utilizada.
No es un sitio web en la nube. Control UI es una aplicación de página única en Vite + Solid, servida directamente por tu propio proceso de Gateway, con la dirección local por defecto http://127.0.0.1:18789/ — si el Gateway se detiene, la página no se abre. Ese es el precio del autoalojamiento, y también el origen de que «el estado, la memoria y las credenciales estén en tu propio hardware».
Control UI fue reconstruido por completo en la v2026.8.1 («OpenClaw 2.0»): la conversación se sitúa en el centro, y los archivos, aprobaciones, configuración y trabajo en vivo se colocan junto a la conversación (para el contexto, véase OpenClaw 2.0 novedades). Este tutorial se basa en la v2026.10.9.
Qué podrás hacer al terminar
- Con
openclaw dashboardohttp://127.0.0.1:18789/abre OpenClaw Control UI, y explica con claridad su diferencia con la versión web en la nube - Completar la autenticación con Gateway secret y el emparejamiento único del dispositivo; escanear con el móvil o conectar desde otro ordenador también funciona
- Distinguir las tres zonas de la barra lateral Pages / Sessions / Users y usar la paleta de comandos Ctrl+K para saltar rápidamente
- Enviar mensajes en el cuadro de chat, cambiar de modelo y usar el panel Details para ver el workspace, la rama y el uso
- Gestionar sesiones y configuración: Pin, renombrar, archivar, Snooze, generar enlaces públicos de solo lectura; en la página de configuración cambiar la apariencia, gestionar plugins, configurar servidores MCP e importar memorias de Claude Code / Codex
Tu situación actual
- Llevas tiempo conversando con Claw en el terminal y quieres revisar registros antiguos o ver qué archivos modificó exactamente, pero el terminal no se deja desplazar
- Cuando Claw solicita una aprobación, solo aparece una frase en el canal; si la pasas por alto, se hunde, y quieres un lugar centralizado para ver y hacer clic
- Quieres cambiar de modelo, instalar plugins o modificar la interfaz sin tocar archivos de configuración — te falta una consola gráfica cómoda
Cuándo usar esta técnica
Cuando necesitas:
- Una consola de funciones completas: sesiones, archivos, aprobaciones, configuración y terminal, todo en el navegador
- Ver y operar tu Claw desde el móvil u otro ordenador
- Operar a diario sin tocar el terminal: abrir una sesión nueva, cambiar de modelo o archivar conversaciones antiguas es un solo clic
Y no quieres:
- Hacer SSH en la máquina cada vez para editar
openclaw.json - Desplazarte por largos historiales de chat dentro de una TUI de terminal
- Revisar archivos de registro solo para echar un vistazo a una aprobación
🎒 Preparativos antes de empezar
- Haber completado la guía de uso cotidiano y saber en qué punto de la etapa está esta lección
- Que el Gateway arranque: en Instalación: en marcha en 5 minutos,
openclaw gateway statusdebería mostrar que escucha en 18789; si no se instala, ve primero a resolución de problemas de instalación - Un navegador relativamente reciente: Chrome 147+ / Firefox 150+ / Safari 26.2+ (criterio oficial de 10/2026)
- (Opcional) Tener instalada la app de OpenClaw en el móvil y querer emparejar escaneando el código
Idea central
¿Qué es Control UI? Definición oficial: una aplicación de página única (SPA) en Vite + Solid, servida por el Gateway:
- Dirección por defecto
http://<host>:18789/, que en local eshttp://127.0.0.1:18789/ - Prefijo opcional
gateway.controlUi.basePath(por ejemplo, montarlo en la subruta/openclaw) - La página se comunica directamente con el WebSocket del Gateway en el mismo puerto — sin servidor intermedio
Relación con las otras dos entradas cotidianas
| Punto de entrada | Cómo abrirlo | Cuándo conviene |
|---|---|---|
| Control UI (esta lección) | openclaw dashboard o acceso desde el navegador 18789 | Consola de funciones completas: sesiones, aprobaciones, archivos, ajustes, terminal |
| TUI | escribe openclaw en la terminal | sin abrir el navegador, para conversar rápido |
| Canales de chat | Feishu / WeCom / Telegram, etc. | Claw te busca en tu mensajería habitual (escenarios prácticos) |
Del modelo de seguridad recuerda una frase: la autenticación del Gateway (token o contraseña) se ejecuta antes del emparejamiento del dispositivo, y ni siquiera la conexión local por loopback la omite; por defecto el Gateway escucha solo en la máquina local (loopback), puerto 18789. Las reglas completas de la exposición remota están en refuerzo de seguridad (1).
Hazlo conmigo
Paso 1: abrir OpenClaw Control UI — puerto local 18789
Por qué: Control UI lo sirve Gateway; si Gateway no está en ejecución, la página no se abre. Primero confirma que está vivo y luego abre el navegador.
openclaw dashboardDeberías ver: el navegador abre Control UI automáticamente. También puedes acceder manualmente a http://127.0.0.1:18789/ (o http://localhost:18789/).
¿No se abre la página? El orden que indica la documentación oficial es iniciar primero el Gateway:
openclaw gatewayLuego actualiza el navegador. Si sigue sin funcionar, revisa punto por punto según los «avisos de errores comunes» de abajo.
- Se abre
http://127.0.0.1:18789/en el navegador y se ve la página de inicio de sesión o el espacio de trabajo
Paso 2: introducir el Gateway secret — autenticación de OpenClaw Control UI
Por qué: la autenticación del Gateway es la primera puerta; ni siquiera la conexión local por loopback la omite. El onboarding local genera por defecto un Gateway secret en modo token.
La página de inicio de sesión tiene un solo campo de Gateway secret: el token se pega directamente, la contraseña se escribe a mano (gateway.auth.mode decide cuál se usa). El token compartido se consulta en la terminal interactiva del host del Gateway:
openclaw gateway auth-token --showDeberías ver: la terminal imprime el token compartido. Pégalo en el campo Gateway secret y te conectarás al espacio de trabajo; el indicador de conexión de la esquina inferior izquierda muestra el estado actual de la conexión.
💡 ¿Dónde se guarda el secret?
Tras conectar con éxito, la UI solo en modo token guarda el secret en el session storage de la pestaña actual del navegador (solo para el origen del Gateway actual); la contraseña permanece solo en memoria y nunca se escribe en disco. Una vez completado el emparejamiento, las conexiones posteriores del navegador usan su propio token por dispositivo y no hace falta volver a introducir el secret.
- La autenticación con Gateway secret pasa y se entra a la interfaz posterior al inicio de sesión
Paso 3: aprobar el emparejamiento del dispositivo — la primera conexión de un navegador nuevo
Por qué: tras pasar la autenticación, la primera conexión de un navegador/dispositivo nuevo normalmente requiere además una aprobación de emparejamiento única: registrar «este navegador me es conocido» en el almacén de credenciales.
En el host del Gateway, lo más cómodo es el openclaw dashboard del paso 1: abre un enlace de emparejamiento de corta duración y de un solo uso que permite al navegador actual obtener directamente una credencial de administrador persistente, sin aprobación manual.
Al cambiar a otro navegador/dispositivo, la página muestra disconnected (1008): pairing required y queda en espera; en ese momento ejecuta en el host del Gateway:
openclaw devices list
openclaw devices approve <requestId>Deberías ver: la página sigue abierta y, tras la aprobación, se conecta automáticamente (Check now permite reintentar de inmediato). Los dispositivos aprobados se recuerdan y luego no necesitan emparejarse; para revocar usa openclaw devices revoke --device <id> --role <role>.
💡 El loopback local puede aprobarse automáticamente
Las conexiones locales directas desde 127.0.0.1 / ::1 y sin cabeceras de proxy se aprueban automáticamente para el emparejamiento del dispositivo tras pasar la autenticación del Gateway (el token / la contraseña deben pasar primero; esto no omite la autenticación). Para forzar la aprobación manual de cada dispositivo, establece gateway.nodes.pairing.autoApproveLocal: false.
⚠️ Las ventanas de incógnito son cada vez un «navegador nuevo»
Cada perfil de navegador genera un ID de dispositivo independiente; borrar los datos del navegador, usar ventanas de incógnito (o un Firefox configurado en «no recordar nunca el historial») pierde la identidad de dispositivo ya emparejada y habrá que emparejar de nuevo la próxima vez. Para el uso diario, lo más cómodo es un perfil de navegador fijo.
- El navegador completa el emparejamiento y entra al espacio de trabajo de Control UI
Paso 4: conocer la navegación de tres zonas — Pages, Sessions y Users
Por qué: tras la reconstrucción de 2.0, la conversación queda centrada y una barra de navegación a la izquierda gestiona lo global. Distinguir las tres vistas da contexto a todas las operaciones posteriores.
| Vista | Qué contiene | Qué haces más a menudo aquí |
|---|---|---|
| Pages | Páginas integradas, paneles, accesos a plugins | Abrir páginas como Automations, Templates, Systems |
| Sessions | Todas las sesiones | Recuperar conversaciones antiguas, iniciar sesiones nuevas |
| Users | Quién está en línea | Ver quién está conectado y la actividad de otros |
Estructura fija de la barra de navegación: arriba el avatar del agente actual (se abre el menú del agente al pulsarlo), debajo del avatar un + (New conversation, nueva sesión), abajo Home, Inbox y tu menú de cuenta.
Tres gestos para empezar de inmediato:
- Ctrl+K (⌘K en Mac): paleta de comandos — saltar entre páginas, cambiar de sesión, buscar comandos
- Ctrl+B (⌘B en Mac): plegar / desplegar la barra lateral
- Ctrl+Shift+O (⌘⇧O en Mac): atajo de New Session en el navegador, enfoca directamente el cuadro de chat
Deberías ver: al pulsar la vista Sessions, las sesiones se despliegan en tres secciones —
Other: conversaciones normales; Groups: grupos / salas; Coding: sesiones vinculadas a un worktree o nodo exec, con
repo ⎇ branchen la filaLos chips My sessions / Involving me / All owners de la fila de título cambian de quién son las sesiones que se ven
Filter & sort permite filtrar por estado (Active / Snoozed / Archived / All), agrupación y orden; Show message preview activa la vista previa de mensajes
Puedes abrir la paleta de comandos con Ctrl+K y alternar entre las tres vistas
Paso 5: Hablar con Claw — composer, modelos y panel Details
Por qué: el chat es el centro de la Control UI. Además de enviar mensajes, en este paso conocerás los widgets que permiten «ver qué está haciendo».
Pulsa el + del raíl de navegación (o New session en Sessions): en la página New session puedes elegir agent, Workspace (proyectos guardados / carpetas recientes / URL de repositorio) y modelo, y luego enviar el primer mensaje.
Deberías ver:
- La respuesta aparece en streaming; el turno completado pliega el proceso en una línea Worked for 2m 3s; ábrela para ver el detalle de las llamadas a herramientas
- El cuadro de chat (composer) tiene un selector de modelo — permite cambiar de modelo sin tocar archivos de configuración (repaso de la sintaxis:
provider/model, ver conexión de modelos, visión general) - El anillo de contexto del composer muestra un resumen de uso, los tokens de la última ronda y los límites del plan; View context abre el informe completo
- El panel Details en la cabecera del chat: Environment (nombre del workspace, rama, worktree, dispositivo de ejecución, modelo), Changes (PR, estadísticas de cambios, checks)
- Cuando Claw necesita aprobación o hace una pregunta, aparece un icono de atención en la fila correspondiente de la sesión en la barra lateral; ábrela para ver la solicitud concreta
El nombre de la nueva sesión se toma automáticamente de la tarea inicial; después solo cambia si tú o el agente lo renombran explícitamente.
💡 Abre una sesión pequeña en segundo plano sin interrumpir la conversación actual
Abre la paleta de comandos con Ctrl+K, arrastra una imagen o archivo al panel (o pega una imagen directamente); el panel cambia al modo New session; añade una instrucción, ajusta los ajustes de sesión y envía con Ctrl+Enter — la conversación actual no se mueve en absoluto y el archivo no se envía por sí solo.
- Envía un mensaje y recibe una respuesta; has abierto el panel Details al menos una vez
Paso 6: Gestionar sesiones — Pin, renombrar, archivar y compartir
Por qué: cuando las conversaciones se acumulan hay que ordenarlas. El menú de sesión (clic derecho en la fila de la barra lateral, o el menú de acciones de la cabecera del chat) reúne las acciones habituales.
| Acción | Efecto |
|---|---|
| Pin / Unpin | Fija la sesión en la zona Pinned en la parte superior de Sessions |
| Rename | Haz clic en el título de la cabecera del chat para editarlo directamente; Enter guarda, Escape cancela |
| Archive / Restore | Retira de la lista Active (Ctrl+Shift+A archiva el chat actual); el historial sigue siendo legible y se puede hacer Undo |
| Snooze / Wake | Oculta temporalmente: 1 hora / 3 horas / esta noche 18:00 / mañana temprano 9:00 / lunes próximo 9:00 |
| Move to group | Mueve a un grupo personalizado; los nombres y el orden de los grupos se guardan en el Gateway y te siguen entre navegadores |
| Icon & color | Asigna emoji / icono y franja de color a la fila de la sesión (menú Advanced) |
Snooze solo significa «esconderla por ahora»: la sesión sigue ejecutándose con normalidad — si le envías un mensaje, el agente termina una ronda o llega la hora de despertar, vuelve sola a la lista Active; para despertarla antes, usa Wake session en el menú.
Compartir públicamente una sesión: en la cabecera del chat, Session sharing → Enable public access… → confirma Make public → Copy public link. Quien reciba el enlace ve el texto de la conversación, las imágenes que cumplan las condiciones y los resúmenes plegados de herramientas con acceso de solo lectura; no pueden enviar mensajes ni obtienen tus permisos.
⚠️ Léelo tú mismo antes de hacerlo público
El texto de la página pública no se depura — el contenido de la conversación como contraseñas o claves será visible tal cual. Revisa la conversación antes de publicar; desactivar el acceso público no recupera las copias que otros ya hayan guardado.
Deberías ver: la sesión con Pin queda fija en la zona Pinned en la parte superior de Sessions; la sesión archivada desaparece de la lista Active, se puede Undo en la barra de confirmación y el historial sigue siendo legible.
- Fija con Pin una sesión de uso frecuente arriba y archiva una sesión antigua
Paso 7: Página de ajustes y panel lateral — apariencia, plugins, MCP y terminal
Por qué: la configuración gráfica cotidiana se concentra en Settings; las herramientas de trabajo cuelgan en el panel lateral a la derecha del chat.
Settings (menú de cuenta en la parte inferior de la barra lateral → Settings):
- Appearance: aspecto del tema; hasta el icono de la pestaña del navegador se puede cambiar (Default / Agent avatar / Lobsterdex)
- Plugins: instalación y descubrimiento de plugins con un clic
- Updates: aparece la insignia Available cuando hay una nueva versión en el canal stable / beta (el menú de cuenta también tiene una entrada Updates)
- MCP: añade / activa / desactiva servidores MCP (tres transportes: Streamable HTTP, SSE, stdio) — para un uso avanzado ver integración de MCP
- Import Memory: importa la memoria local de Claude Code / Codex / Hermes a un agente — los detalles en sistema de memoria
- Labs: activa funciones experimentales, como Templates (añade en Pages una página oficial de descubrimiento de plantillas) y Speech bubbles (vista de conversación en burbujas)
- El Search settings de la parte superior busca por página y por nombre de campo de configuración, sin tener que revisar una por una
Panel lateral (a la derecha del chat, se abre con el menú + o el menú Layout de la barra superior):
- Terminal: terminal del operador, activada por defecto (
gateway.terminal.enabled), requiere el permisooperator.adminy abre un PTY del host en el workspace del agente actual; el atajoCtrl+`(Ctrl más la tecla de comilla invertida) la activa y desactiva rápidamente - Browser: aquí se ven los resultados de las operaciones del navegador de Claw
- Files: explora los archivos del workspace; al pasar el cursor sobre una fila de archivo aparece Download file, los PDF de hasta 16 MiB se pueden previsualizar; en el menú ⋯ de la barra de herramientas de vista previa, Attach to session adjunta el archivo al siguiente mensaje
- Subagents: muestra el estado de ejecución de los subagentes y su transcript de solo lectura (también se pueden usar comandos como
/subagents listen el chat) - Processes: estado y salida de los comandos exec en segundo plano de la sesión; Stop detiene exactamente ese proceso
Ask OpenClaw: Settings → Ask OpenClaw (o la pestaña Ask OpenClaw del dock de Home) — el agente especializado en gestionar instalaciones y reparaciones del sistema; basta decir configure gateway o import memory en el chat para que se inicie el asistente guiado.
⚠️ La terminal del operador es un shell del host
La terminal local del Gateway no está limitada por el sandbox y hereda el entorno del proceso del Gateway: las credenciales que el Gateway puede leer, ella también puede leerlas, y escribir archivos directamente además omite restricciones como OPENCLAW_CONFIG_READONLY. Si no quieres esta capacidad: define gateway.terminal.enabled: false, o al desplegar usa la variable de entorno OPENCLAW_DISABLE_GATEWAY_LOCAL_TERMINALS=1 para desactivarla por completo.
Deberías ver: en la parte superior de Settings hay un cuadro de búsqueda Search settings — escribir palabras como Typography salta directamente al ajuste correspondiente en Appearance; las pestañas del panel lateral se pueden arrastrar para reordenar y cerrar individualmente, sin afectarse entre sí.
- Encontrar en Settings las páginas MCP e Import Memory; haber abierto al menos una vez el panel Terminal
Paso 8 (opcional): acceso remoto y desde el móvil a la Control UI
Por qué: Claw corre en la máquina de casa o en un VPS, y hay que poder conectarse incluso cuando no estás delante.
Método A (recomendado): exponer HTTPS con Tailscale Serve
openclaw gateway --tailscale serveAccede a https://<magicdns>/. Con gateway.auth.allowTailscale: true se puede usar la autenticación de identidad de Tailscale, y los navegadores que ya llevan identidad de dispositivo pueden incluso saltarse el ida y vuelta del emparejamiento.
Método B: emparejar el móvil escaneando un código QR
Un administrador ya emparejado, en la Control UI: Devices → Pair device genera un código QR → en la App del móvil, Settings → Gateway escanea el código (o pega el setup code) → cuando aparezca Pending approval, revisa el rol y los permisos antes de aprobar. Generar el setup code requiere operator.admin.
Método C: instalar como PWA
La Control UI incluye manifest y service worker, así que los navegadores modernos pueden «instalarla» como aplicación independiente; una vez instalada, Web Push puede enviar notificaciones con las pestañas cerradas — incluidas las aprobaciones pendientes de exec / plugins.
⚠️ No la expongas desnuda a la red pública
Por defecto el Gateway solo escucha en la máquina local; cambiar a una escucha no loopback exige configurar autenticación, de lo contrario se niega a arrancar (fail closed). Se puede abrir http://<内网IP> en la red local, pero es un transporte degradado; usa HTTPS siempre que puedas. Las reglas completas están en Endurecimiento de seguridad (1).
Deberías ver: con el método A, https://<magicdns>/ abre la misma Control UI que en local; con el método B, tras escanear el código la App del móvil se conecta automáticamente y, una vez aprobado Pending approval, el emparejamiento se completa; con el método C, tras la instalación la Control UI corre como ventana de aplicación independiente, sin ocupar pestañas del navegador.
- (Opcional) Haber completado el emparejamiento por QR en el móvil, o que la Control UI se pueda abrir por Tailscale HTTPS
Punto de control ✅
openclaw dashboardabre la Control UI, dirección localhttp://127.0.0.1:18789/- Autenticación con el secret del Gateway superada, navegador con emparejamiento de dispositivo único completado
- Saber decir qué contiene cada una de Pages / Sessions / Users, y que Ctrl+K abre la paleta de comandos
- Haber enviado un mensaje, cambiado de modelo y abierto el panel Details en la Control UI
- Haber hecho al menos una gestión de sesión (Pin / archivar / renombrar, cualquiera)
Avisos de errores comunes
❌ La página no abre o queda en blanco
Tres causas posibles, revisa en este orden:
- El Gateway no está corriendo: la Control UI es una página servida por el Gateway; si el proceso está detenido, no puede abrirse. Primero
openclaw gateway(arranca en primer plano para ver los registros), o confirma que el servicio en segundo plano está en ejecución - Una extensión del navegador bloquea la aplicación modular: si la página queda en blanco y DevTools no reporta errores, la documentación oficial apunta a «extensiones que se inyectan en todas las páginas (sobre todo las que llevan content script con
<all_urls>)». Desactiva ese tipo de extensiones, prueba con ventana de incógnito o con un perfil limpio; el panel de recuperación de la propia página, Try again, permite recargar directamente - Tras actualizar aparece Protocol mismatch: una pestaña antigua o la caché del service worker sigue ejecutando el paquete de UI previo a la actualización. Primero
openclaw dashboardreabre + recarga forzada; si no funciona, borra los datos del sitio de ese origen, o verifica con una ventana de incógnito
En Windows hay un caso más: el host con 127.0.0.1 funciona, pero la dirección de la red local no abre — el firewall o las políticas de grupo bloquean la dirección LAN. Ejecuta openclaw gateway status --deep en el host Windows; reportará los puertos y reglas de firewall local sospechosos de estar bloqueando.
❌ disconnected (1008): pairing required se queda girando eternamente
Causa: la primera conexión de un navegador nuevo requiere una aprobación de emparejamiento única y nadie ha aprobado aún la solicitud.
Lo correcto: mantén la página abierta (se conectará sola tras la aprobación); en el host del Gateway usa openclaw devices list para ver las solicitudes y openclaw devices approve <requestId> para aprobar. Hay que distinguir dos caras del fallo: un rechazo explícito muestra Access request declined (puedes pulsar Request again para volver a solicitar); si nadie atiende la solicitud, muestra Access request expired (al reabrir la página se envía una nueva solicitud).
Ojo: si al reintentar el navegador cambió el rol o los permisos, la solicitud antigua queda sustituida por un nuevo requestId — vuelve a ejecutar list antes de aprobar, no apruebes una solicitud ya caducada.
❌ En modo token, también se rechaza el navegador local
Causa: cuando el Gateway arranca en modo token sin haber configurado un token, genera un token de ejecución temporal — no se escribe en la configuración y no se puede recuperar; todo navegador que no lo tenga es rechazado, incluido el de la máquina local.
Lo correcto (los tres pasos de reparación que da la documentación oficial):
openclaw doctor --generate-gateway-token # 生成正式 token 写进配置
# 然后重启 Gateway
openclaw gateway auth-token --show # 交互式终端里查看,粘贴进登录页❌ Navegador demasiado antiguo, no se puede entrar a la interfaz
Causa: Control UI requiere capacidades de navegador relativamente recientes. Criterio oficial (10 de 2026): Chrome 147+, Firefox 150+, y Safari 26.2+ en macOS 26.2 / iOS 26.2 / iPadOS 26.2 (o Chrome / Firefox publicado en los últimos seis meses).
Solución correcta: actualizar el navegador. Los navegadores sin capacidades clave verán primero una página de aviso de actualización; los que no admitan módulos de script en absoluto mostrarán directamente This browser is not supported. Si te ocurre dentro de una app nativa, puedes pulsar Open in browser para abrirlo con el navegador predeterminado del sistema.
❌ La ventana de incógnito / privada exige reaparear cada vez
Causa: cada perfil de navegador tiene un ID de dispositivo propio; las ventanas que descartan los datos del sitio (incógnito, «Nunca recordar historial» de Firefox) se tratan cada vez como un navegador nuevo.
Solución correcta: para el uso diario, conéctate a Control UI con un perfil fijo; cuando la lista de dispositivos emparejados se vuelva demasiado larga, usa openclaw devices remove <deviceId> para eliminar las entradas antiguas que ya no uses.
Trucos avanzados (opcional)
Cerrar Control UI no detiene el robot. gateway.controlUi.enabled: false Surte efecto en caliente: solo se detienen la página y los recursos estáticos; el robot y las conexiones Gateway existentes siguen funcionando; cambia de vuelta a true para restaurar el servicio, y los recursos que falten se repondrán en segundo plano. Pero modificar basePath / el directorio raíz de recursos sí exige reiniciar el Gateway:
{
gateway: {
controlUi: {
enabled: true,
basePath: "/openclaw", // 挂到子路径;改这个要重启
},
},
}Banner de configuración de solo lectura. Con un Gateway iniciado con OPENCLAW_CONFIG_READONLY=1 (o OPENCLAW_NIX_MODE=1), la parte superior de Control UI muestra Gateway configuration is read-only: la configuración solo se puede ver, no modificar. Para guiar a todos a cambiar la configuración en su propio flujo, define OPENCLAW_CONFIG_READONLY_NOTICE con tu texto de aviso (si termina con un espacio + URL absoluta, se añade automáticamente un enlace Learn more).
Con varios Gateway, no los confundas. Si administras varias máquinas Gateway a la vez, configura gateway.controlUi.environment en cada una:
{
gateway: {
controlUi: {
environment: { label: "edge", color: "amber" },
},
},
}El navegador mostrará una barra de color superior de 2px, una etiqueta en la barra lateral, un sufijo en el título y un favicon a juego, para distinguir de un vistazo a cuál estás conectado. Los colores disponibles son teal / amber / purple / coral / pink / blue / green / red / gray, y la etiqueta está limitada a 1–24 caracteres.
Si se corta la conexión, no te asustes. Al desconectarse, los directorios cargados, el editor de automatizaciones, las selecciones de Import Memory, el historial de actividad y la cola de aprobaciones permanecen en memoria sin perderse; el indicador de la esquina inferior izquierda muestra Reconnecting… y reconecta automáticamente; el botón Retry solo aparece si la recuperación automática se detiene. Pero recuerda una cosa: acciones del Gateway como guardar ediciones o aprobar solicitudes necesitan una conexión live, y la reconexión no las reejecuta automáticamente; tras reconectar, repite manualmente las operaciones no confirmadas.
Resumen de esta lección
✅ OpenClaw Control UI es la consola de navegador del servicio Gateway: se abre con openclaw dashboard, en la máquina local http://127.0.0.1:18789/, y se comunica por WebSocket en el mismo puerto que el Gateway; no es un sitio web en la nube.
✅ Las tres puertas de conexión quedaron claras: Gateway secret (token / contraseña) → emparejamiento único del dispositivo (openclaw dashboard en un solo paso o devices list / approve) → después, con el token del dispositivo, sin necesidad de reaparear.
✅ El mapa de la interfaz está memorizado: barra de navegación = Pages / Sessions / Users + avatar del agente arriba + Home / Inbox / cuenta abajo; Ctrl+K paleta de comandos, Ctrl+B plegar la barra lateral, Ctrl+Shift+O abrir una sesión nueva.
✅ Las acciones cotidianas tienen su entrada fija: cambiar de modelo en el cuadro de chat, ver el workspace y el uso en Details, Pin / archivar / Snooze en el menú de sesión, enlaces públicos de solo lectura con Session sharing, gestionar apariencia / plugins / MCP / importación de memoria en Settings, y colgar Terminal / Browser / Files / Subagents en el panel lateral.
| Clave de configuración / comando | Función | Notas |
|---|---|---|
gateway.controlUi.enabled | Activar / desactivar Control UI | Surte efecto en caliente; desactivarlo no afecta al robot ni a las conexiones existentes |
gateway.controlUi.basePath | Prefijo de subruta | Por ejemplo /openclaw; cambiarlo exige reiniciar el Gateway |
gateway.auth.mode | token / password | En la página de inicio de sesión, introduce el valor correspondiente como Gateway secret |
gateway.terminal.enabled | Interruptor del terminal de operador | Activado por defecto; requiere operator.admin |
openclaw dashboard | Abrir / reparar el emparejamiento | Enlace de emparejamiento único de corta duración |
openclaw gateway auth-token --show | Ver el token compartido | Se ejecuta en el terminal interactivo del host del Gateway |
openclaw devices list / approve | Aprobación de emparejamiento | Primera conexión de un navegador nuevo |
openclaw gateway --tailscale serve | Acceso remoto por HTTPS | Se recomienda el método Tailnet |
La referencia rápida completa de comandos y configuración está en Referencia rápida de comandos y configuración de la CLI.
Avance de la próxima lección
El cuadro de chat de Control UI no es solo para escribir: comandos de barra como /model, /think y /new funcionan igual en la versión web y en los canales de chat. La próxima lección, Curso rápido de comandos de chat: /model, /think y los comandos de barra, repasa los más usados.
Aprenderás:
/modella familia:/model listver el catálogo,/model <name>cambiar,/model statusconsultar el estado/think <level>ajusta el nivel de razonamiento,/fastmodo rápido/new,/resetgestionan el ciclo de vida de las sesiones/skill <name>la entrada universal: invoca habilidades como comandos