Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

openclaw-openwebui-integration

Integración que conecta OpenClaw Gateway con Open WebUI mediante WebSocket nativo v4. Permite flujos de trabajo en tiempo real, llamadas a herramientas nativas y gestión de subagentes sin convertir todo el proceso en texto plano. Requiere una instalación previa del Gateway.

Ficha actualizada 26 sept 2026, 0:36 · upstream 26 sept 2026, 0:22 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es openclaw-openwebui-integration

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Este repositorio facilita la ejecución de agentes OpenClaw dentro de la interfaz de chat de Open WebUI. Utiliza dos funciones principales: una "Pipe" para la comunicación principal y una "Action" para botones de estado. La integración aprovecha el protocolo WebSocket nativo v4 del Gateway, lo que permite visualizar llamadas a herramientas en tiempo real (con spinners), diálogos interactivos con el usuario durante la ejecución y archivos emitidos por el agente.

A diferencia de la API HTTP estándar `/v1`, esta solución ofrece una experiencia más rica, manteniendo sesiones persistentes y permitiendo cambiar entre modelos conocidos por el Gateway. Es importante destacar que requiere un Gateway OpenClaw ya ejecutándose para ser útil. La integración no es un agente en sí mismo, sino un puente que conecta la infraestructura existente con la interfaz de usuario.

CASOS DE USO
  • Acceso a agentes en dispositivos móviles con interfaz pulida y soporte nativo.
  • Visualización de llamadas a herramientas (shell, archivos) en tiempo real durante la ejecución.
  • Gestión de sesiones persistentes que sobreviven a reinicios del Gateway o fallos del agente.
  • Monitorización de uso de contexto y límites de tasa mediante botón de estado en la barra de mensajes.
  • Interacción directa con subagentes mediante paneles de transcripción y gestión de herramientas tras finalización.
PUNTOS DESTACADOS
  • Uso del protocolo WebSocket nativo v4 para streaming real de respuestas token a token.
  • Autenticación persistente Ed25519 que sobrevive a reinicios y reinstalaciones del cliente.
  • Renderizado nativo de tarjetas de herramientas (spinner mientras ejecuta, resultado al finalizar).
  • Selector dinámico de modelos descubiertos automáticamente desde el Gateway sin hardcodear IDs.
  • Soporte para diálogos interactivos mid-run interceptando prompts de entrada del usuario.
PRECAUCIONES
  • Las llamadas a herramientas de los subagentes solo aparecen tras finalizar la ejecución del subagente.
  • Algunas funcionalidades como diálogos con usuario o soporte multimedia requieren configuración adicional en el agente (convenios específicos).
  • Depende totalmente de una instancia activa y accesible del OpenClaw Gateway.
  • No incluye Docker ni Compose, requiere entorno Python 3.10+ y gestión manual de dependencias.
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Tool calls streaming live in Open WebUI on a phone, with spinners and green checkmarksThe OpenClaw Status button in Open WebUIStatus dialog showing context usage, 5h and weekly rate limits, and five running subagentsSubagent drawer with Overview, Transcript and Tools tabs, showing a subagentAn expanded tool call showing its INPUT arguments and OUTPUT resultOpen WebUI model dropdown listing models discovered from the Gateway
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Clonar repositorio y ejecutar `uv run install.py install --wizard` para instalar las funciones Pipe y Action. Aprobación manual del dispositivo en el host del Gateway mediante `openclaw devices approve <request-id>`. Configuración final seleccionando "OpenClaw · Default" en el selector de modelos de Open WebUI. Se recomienda verificar que el Gateway esté activo antes de usar.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Next.jsPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
80801878918791
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.