​

UI de control (navegador)

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

​

Apertura rápida (local)

• http://127.0.0.1:18789/ (o http://localhost:18789/)

• connect.params.auth.token
• connect.params.auth.password El panel de configuración del dashboard le permite almacenar un token; las contraseñas no se persisten. El asistente de incorporación genera un token del gateway de forma predeterminada, así que péguelo aquí en la primera conexión.

​

Emparejamiento de dispositivos (primera conexión)

# List pending requests
openclaw devices list

# Approve by request ID
openclaw devices approve <requestId>

• Las conexiones locales (127.0.0.1) se aprueban automáticamente.
• Las conexiones remotas (LAN, Tailnet, etc.) requieren aprobación explícita.
• Cada perfil de navegador genera un ID de dispositivo único, por lo que cambiar de navegador o borrar los datos del navegador requerirá volver a emparejar.

​

Qué puede hacer (hoy)

• Chatear con el modelo vía Gateway WS (chat.history, chat.send, chat.abort, chat.inject)
• Transmitir llamadas a herramientas + tarjetas de salida de herramientas en vivo en Chat (eventos del agente)
• Canales: estado de WhatsApp/Telegram/Discord/Slack + canales de plugins (Mattermost, etc.) + inicio de sesión por QR + configuración por canal (channels.status, web.login.*, config.patch)
• Instancias: lista de presencia + actualización (system-presence)
• Sesiones: lista + sobrescrituras de thinking/verbose por sesión (sessions.list, sessions.patch)
• Tareas cron: listar/agregar/ejecutar/habilitar/deshabilitar + historial de ejecuciones (cron.*)
• Skills: estado, habilitar/deshabilitar, instalar, actualizaciones de claves de API (skills.*)
• Nodos: lista + capacidades (node.list)
• Aprobaciones de ejecución: editar listas de permitidos del gateway o del nodo + política de solicitud para exec host=gateway/node (exec.approvals.*)
• Configuración: ver/editar ~/.openclaw/openclaw.json (config.get, config.set)
• Configuración: aplicar + reiniciar con validación (config.apply) y reactivar la última sesión activa
• Las escrituras de configuración incluyen una protección de hash base para evitar sobrescribir ediciones concurrentes
• Esquema de configuración + renderizado de formularios (config.schema, incluidos esquemas de plugins + canales); el editor de JSON en bruto sigue disponible
• Depuración: instantáneas de estado/salud/modelos + registro de eventos + llamadas RPC manuales (status, health, models.list)
• Registros: tail en vivo de los registros de archivos del gateway con filtro/exportación (logs.tail)
• Actualización: ejecutar una actualización de paquetes/git + reiniciar (update.run) con un informe de reinicio

• Para tareas aisladas, la entrega predeterminada es anunciar un resumen. Puede cambiar a ninguno si desea ejecuciones solo internas.
• Los campos de canal/destino aparecen cuando se selecciona anunciar.

​

Comportamiento del chat

• chat.send es no bloqueante: confirma de inmediato con { runId, status: "started" } y la respuesta se transmite mediante eventos chat.
• Reenviar con el mismo idempotencyKey devuelve { status: "in_flight" } mientras se ejecuta, y { status: "ok" } tras la finalización.
• chat.inject agrega una nota del asistente al transcript de la sesión y difunde un evento chat para actualizaciones solo de la UI (sin ejecución del agente, sin entrega a canales).
• Detener:
  • Haga clic en Stop (llama a chat.abort)
  • Escriba /stop (o stop|esc|abort|wait|exit|interrupt) para abortar fuera de banda
  • chat.abort admite { sessionKey } (sin runId) para abortar todas las ejecuciones activas de esa sesión

​

Acceso por Tailnet (recomendado)

​

Tailscale Serve integrado (preferido)

openclaw gateway --tailscale serve

• https://<magicdns>/ (o su gateway.controlUi.basePath configurado)

​

Vincular a tailnet + token

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

• http://<tailscale-ip>:18789/ (o su gateway.controlUi.basePath configurado)

​

HTTP inseguro

• https://<magicdns>/ (Serve)
• http://127.0.0.1:18789/ (en el host del Gateway)

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

​

Construcción de la UI

pnpm ui:build # auto-installs UI deps on first run

OPENCLAW_CONTROL_UI_BASE_PATH=/openclaw/ pnpm ui:build

pnpm ui:dev # auto-installs UI deps on first run

​

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

1. Inicie el servidor de desarrollo de la UI: pnpm ui:dev
2. Abra una URL como:

http://localhost:5173/?gatewayUrl=ws://<gateway-host>:18789

http://localhost:5173/?gatewayUrl=wss://<gateway-host>:18789&token=<gateway-token>

• gatewayUrl se almacena en localStorage después de la carga y se elimina de la URL.
• token se almacena en localStorage; password se mantiene solo en memoria.
• Cuando gatewayUrl está configurado, la UI no recurre a credenciales de configuración o de entorno. Proporcione token (o password) explícitamente. La falta de credenciales explícitas es un error.
• Use wss:// cuando el Gateway esté detrás de TLS (Tailscale Serve, proxy HTTPS, etc.).
• gatewayUrl solo se acepta en una ventana de nivel superior (no incrustada) para prevenir clickjacking.
• Para configuraciones de desarrollo de origen cruzado (p. ej., pnpm ui:dev hacia un Gateway remoto), agregue el origen de la UI a gateway.controlUi.allowedOrigins.

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