Instalación de Open WebUI y configuración de OmniProxy

Open WebUI es una interfaz de chat que puedes desplegar por tu cuenta en tu ordenador o servidor y que también puede funcionar completamente sin conexión. No está vinculada a ningún proveedor de modelos: puede conectarse tanto a herramientas como Ollama, que ejecutan modelos localmente, como a interfaces compatibles con el formato de OpenAI, es decir, direcciones que ofrecen servicios de modelos utilizando el mismo formato de solicitud. De este modo, puedes alternar entre modelos locales y modelos en la nube desde una misma ventana.

Es adecuada para el uso prolongado por parte de equipos y organizaciones. Las funciones que se actualizan con mayor rapidez aparecen primero en Computer, el producto que Open WebUI utiliza para probar funciones nuevas.

Preparativos antes de la instalación

Open WebUI puede utilizarse en macOS, Linux y Windows. Puedes instalarlo mediante Docker, Python o Kubernetes. Docker instala la aplicación y su entorno de ejecución en un contenedor relativamente aislado, por lo que es el método recomendado. Si no tienes Docker, también puedes utilizar el comando de Python probado que aparece más adelante. Kubernetes es un sistema para desplegar y administrar contenedores; consulta los pasos correspondientes en Quick Start, al final de esta guía.

Recomendación oficial

Docker

Un único docker run
Abre 3000 en el navegador
Los datos están en el volumen

Si solo quieres chatear

Imagen slim

La descarga ocupa menos
Cambia la etiqueta a :slim
La función de chat sigue disponible

No se detallan aquí

Otras dos opciones

Instalación manual con Python
Despliegue en Kubernetes
Consulta la guía oficial Quick Start

Instala primero Docker y luego inicia la aplicación con el comando recomendado. Si solo vas a chatear mediante una API, puedes cambiar la etiqueta de la imagen a slim.

Antes de empezar, prepara lo siguiente:

Docker instalado y en funcionamiento.
Una cadena secreta que utilices únicamente tú. Ejecuta openssl rand -hex 32 para generarla y asígnala a WEBUI_SECRET_KEY. Debes conservar este valor sin cambios; si lo modificas al reconstruir el contenedor, se cerrará la sesión de quienes hayan iniciado sesión.
Una instancia de OmniProxy en funcionamiento y un ID de modelo de su lista actual de modelos. El ID de modelo es el nombre completo que se utiliza para seleccionar un modelo específico.

Instalación y primer inicio

Abre una terminal y ejecuta el comando de Quick Start. Primero sustituye your-secret-key por la cadena secreta que acabas de generar:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Las distintas partes de este comando cumplen estas funciones:

-p 3000:8080: permite abrir la interfaz mediante el puerto 3000 de este ordenador. Si el puerto 3000 está ocupado, cambia el número de la izquierda.
-v open-webui:/app/backend/data: guarda los chats, los usuarios y la configuración en un volumen de datos. Un volumen de datos es una ubicación externa al contenedor donde la información se conserva a largo plazo. Su contenido seguirá disponible después de actualizar el contenedor, por lo que no debes eliminar esta opción.
--add-host=host.docker.internal:host-gateway: permite que el contenedor acceda a otros servicios que se estén ejecutando en este ordenador.
--restart always: hace que el contenedor vuelva a iniciarse después de reiniciar el ordenador.

Cuando termine de ejecutarse el comando, abre http://localhost:3000 en el navegador y sigue las indicaciones de la página para crear la primera cuenta.

Si solo vas a chatear mediante una API, puedes cambiar la etiqueta de imagen de :main a :slim. slim es una imagen más pequeña que no incluye los modelos locales de voz ni de embeddings dentro del contenedor, pero la interfaz de chat seguirá disponible. Si necesitas estas funciones locales, continúa utilizando :main.

Para actualizar manualmente, ejecuta primero docker rm -f open-webui, después docker pull ghcr.io/open-webui/open-webui:main y, por último, vuelve a iniciar la aplicación con el mismo comando docker run. Tanto el volumen de datos como WEBUI_SECRET_KEY deben permanecer sin cambios.

Si no tienes Docker

Quick Start también ofrece un método de instalación mediante Python. El 2026-10-09, los siguientes comandos se utilizaron en macOS para instalar Open WebUI v0.11.4 y completar una conversación. Ese ordenador no tenía Docker Desktop.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Después del inicio, abre http://localhost:8080 en el navegador. Este es el puerto utilizado por la instalación mediante Python, no el puerto 3000 de Docker.

Durante el primer inicio se descargará un modelo de embeddings, lo que puede tardar varios minutos. Este modelo convierte el texto en datos adecuados para búsquedas y coincidencias. Espera a que aparezca la página de inicio de sesión antes de continuar. La primera cuenta que se registre se convertirá en administradora. El idioma de la interfaz sigue la configuración del sistema; en esta prueba apareció en chino simplificado.

DATA_DIR debe apuntar a un directorio que se conserve a largo plazo y que se utilice para almacenar los datos de Open WebUI. Si no lo configuras, los datos podrían guardarse en un directorio temporal y perderse al cerrar el programa. Si no se establece WEBUI_SECRET_KEY, el programa escribirá .webui_secret_key en el directorio actual. Inícialo desde un directorio que vayas a conservar o configura esta variable por tu cuenta.

Obtener los parámetros de conexión de OmniProxy

Copia estos tres datos desde tu propia instancia de OmniProxy:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copia el ID completo de la lista actual de modelos de OmniProxy

La URL es la dirección que utilizará Open WebUI para conectarse a la interfaz y debe terminar en /v1. No añadas /chat/completions al final, ya que Open WebUI agregará esta parte automáticamente.

El ID de modelo debe copiarse completo desde la lista actual de OmniProxy. Si contiene un prefijo de origen y una barra, también debes conservarlos. Los dos nombres cortos siguientes son únicamente referencias tomadas de la documentación de los proveedores el 2026-10-09. No los utilices si no aparecen en la lista actual:

ID de Claude API para Claude Sonnet 5.5: claude-sonnet-5-5
Nombre de interfaz de Gemini 3.8 Flash: gemini-3.8-flash

No introduzcas la clave del proveedor en Open WebUI. Si la puerta de enlace no verifica las claves, puedes dejar vacía la clave de API; no inventes una clave adicional.

Navegador

Equipo local 3000

Abre la página de chat
Primero completa el registro
Después, entra en la configuración

Dentro del contenedor

Open WebUI

No uses localhost
Usa el nombre del equipo anfitrión
La URL debe terminar en /v1

En el mismo ordenador

OmniProxy

La clave permanece en la puerta de enlace
Usa la lista de modelos de la puerta de enlace
Después, revisa el registro de llamadas

Cuando Open WebUI se ejecuta en Docker y OmniProxy en el sistema anfitrión, no utilices localhost dentro del contenedor.

Si el servicio de modelos se ejecuta en el sistema anfitrión y Open WebUI se ejecuta dentro de un contenedor Docker, sustituye localhost en la URL por host.docker.internal. El sistema anfitrión es el ordenador en el que Docker se ejecuta directamente. Si OmniProxy solo escucha en este ordenador, puedes utilizar la URL http://host.docker.internal:puerto/v1, sustituyendo el puerto por el que utilice realmente OmniProxy.

Si Open WebUI se ejecuta localmente mediante el comando de Python de la sección anterior y OmniProxy también está en el mismo ordenador, utiliza 127.0.0.1 o localhost como dirección. En este caso, no utilices host.docker.internal.

Introducir la configuración de la herramienta

La interfaz en chino simplificado de v0.11.4 del 2026-10-09 utiliza nombres distintos de Settings > Admin > Connections, que aparecen en las instrucciones en inglés. Sigue las opciones correspondientes que aparecen en la interfaz:

Expande la barra lateral izquierda.
Haz clic en el menú de usuario de la parte inferior.
Haz clic en Configuración.
En el grupo de administración de la parte inferior, haz clic en Conexiones externas.
Abre API de OpenAI.
Haz clic en +, a la derecha de Administrar conexiones de la API de OpenAI.
En la ventana emergente Editar conexión, introduce la URL terminada en /v1. Mantén Chat Completions como tipo de interfaz.
Mantén Clave (Bearer) como Método de autenticación. Bearer es una forma de autenticación que incluye la clave de API en la solicitud. Cuando OmniProxy te proporcione una clave, introdúcela en Clave de API. Si la puerta de enlace no verifica las claves, deja este campo vacío. El 2026-10-09, tanto la validación como una conversación se completaron correctamente con el campo vacío.
Haz clic en Validar conexión, junto a la URL. Si OmniProxy proporciona /models, aquí se obtendrá la lista de modelos.
Abre Avanzado. Si dejas vacío ID de modelo, se utilizarán todos los modelos devueltos por /models en esa dirección. Solo si falla la validación, introduce el ID completo de la lista en Añadir ID de modelo y haz clic en Añadir. Añade cada ID una sola vez; los espacios iniciales y finales se eliminarán.
Haz clic en Guardar en esta ventana y luego en Guardar, en la esquina inferior derecha de la página de conexiones externas.

Guardar la configuración no sustituye la validación. Validar conexión envía una solicitud a /models, la interfaz utilizada para enumerar los modelos disponibles. Algunos servicios no ofrecen esta interfaz, por lo que la validación puede producir un error aunque el chat siga funcionando. En ese caso, añade manualmente el ID de modelo.

Verificar una tarea real

Vuelve a la página de chat, abre el menú de modelos situado junto al cuadro de entrada y selecciona el ID completo de la lista de OmniProxy. Envía una frase muy corta; por ejemplo, pídele que responda con una sola palabra. Debe aparecer una respuesta real en el cuadro de chat.

El 2026-10-09, esta conversación se completó utilizando la instalación mediante Python de v0.11.4. Docker sigue siendo el método recomendado, pero esta prueba no se repitió en Docker.

A continuación, abre el registro de solicitudes de OmniProxy y confirma el origen y el ID de modelo de esta solicitud. Ver únicamente que la configuración se ha guardado correctamente o que el modelo aparece en el menú no es suficiente para considerar el proceso completado.

Interfaz

El modelo se puede seleccionar

Connections se ha guardado
El modelo aparece en la lista
Envía una pregunta corta

Respuesta

El chat muestra una respuesta

No es un mensaje vacío
No es un error de conexión
Prueba de nuevo con otro modelo

Registro

Es visible en la puerta de enlace

El origen es esta conexión
El ID del modelo coincide
No se ha introducido ninguna clave en la página

La conexión solo se considera funcional cuando coinciden las tres comprobaciones.

Errores comunes

Se ha utilizado localhost o 127.0.0.1 dentro del contenedor: ambas direcciones apuntan al propio contenedor, no al sistema anfitrión. Cámbialas por host.docker.internal y confirma que el comando de inicio incluye --add-host=host.docker.internal:host-gateway. Si Open WebUI no está en un contenedor, haz lo contrario y utiliza una dirección local.
El navegador no puede abrir la interfaz: comprueba el puerto 3000 para Docker y el 8080 para Python. Durante el primer inicio, espera a que termine de descargarse el modelo de embeddings. Puedes utilizar docker ps para confirmar si el contenedor está en ejecución. Si el puerto 3000 está ocupado, cambia el puerto situado a la izquierda de -p.
El ID del menú de modelos es más largo que el nombre corto del proveedor: utiliza el ID completo del menú, incluidas las barras.
Todas las sesiones se cerraron después de una actualización: WEBUI_SECRET_KEY ha cambiado. Reinicia la aplicación con la misma cadena secreta generada la primera vez.
Falla Validar conexión: añade primero el ID del modelo manualmente en Avanzado y después compruébalo con una conversación real de una sola frase. Algunos servicios no ofrecen /models; aunque la validación produzca un error, el chat podría seguir funcionando.
El modelo no existe: vuelve a copiar el ID desde la lista actual de OmniProxy y no continúes utilizando un nombre obsoleto.

Referencias oficiales

Consulta los comandos de instalación en Open WebUI Quick Start. Consulta los pasos de conexión en las instrucciones para conexiones compatibles con OpenAI. Los ID de modelo utilizados como ejemplo aparecen en la descripción general de modelos de Claude y la lista de modelos de Gemini.

Reemplaza cada marcador de posición con valores de tu propia configuración de OmniProxy. Nunca publiques una clave real.

Un resultado guardado o HTTP 200 por sí solo no demuestra compatibilidad total con el Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Open WebUI ↗