Integración con Libre WebUI

Conecta Libre WebUI al daemon de Libre Claw para una superficie de control en el navegador con líneas de tiempo de ejecución, aprobaciones de herramienta inline, automatizaciones y uso de proveedor.

Una superficie de control en el navegador para Libre Claw.

Libre WebUI es una interfaz de chat IA auto-alojada y orientada a la privacidad construida por Kroonen AI. Desde la versión 0.12 incluye una superficie de agente de Libre Claw de primera clase: una entrada de barra lateral dedicada, una ruta /agents y rutas de backend solo para admin que proxian el daemon local. Tu runtime de agente, modelo de seguridad, memoria, herramientas y programaciones se quedan en Libre Claw; Libre WebUI añade el navegador por encima.

Fuente y configuración en github.com/libre-webui/libre-webui, Guía de integración (31-LIBRE_CLAW_INTEGRATION.md) 31-LIBRE_CLAW_INTEGRATION.md.

Arrancar el daemon

Libre WebUI habla con el daemon de Libre Claw sobre localhost. Arráncalo como siempre y luego abre la página de agente en WebUI.

Arrancar Libre Claw

libre-claw start
# daemon listens at:
http://127.0.0.1:8766

Luego abre Libre WebUI → Libre Claw se conecta a http://127.0.0.1:8766.

Apuntar WebUI a un daemon personalizado

Si el daemon corre en otro host o puerto, define las variables de entorno del backend antes de arrancar Libre WebUI.

backend/.env

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000

Reinicia el backend de WebUI para que los nuevos valores surtan efecto.

Qué puede hacer la página de agente

Run timelines

Arranca ejecuciones de chat o modo objetivo, pasa overrides de proveedor/modelo, hace stream de eventos incrementales, inspecciona llamadas y resultados de herramienta y cancela ejecuciones activas.

Inline approvals

Resuelve peticiones de permiso de herramienta desde el navegador: permitir una vez, denegar o permitir siempre una herramienta sin salir de la página.

Automations

Crea, actualiza, ejecuta ahora, pausa, reanuda y elimina informes programados y rutas de Telegram.

Usage

Inspecciona registros de uso de proveedor y estado de ruta de fallback desde la misma página de agente.

Model routing

Cambia el proveedor y modelo activos, y revisa los slots de fallback, a través de rutas proxy solo para admin.

Daemon status

Ve el estado de conexión, la salud y la URL del panel sin salir de Libre WebUI.

Cómo encaja

Libre WebUI es el navegador; Libre Claw es el runtime. El backend de WebUI llama a rutas solo para admin bajo /api/libre-claw que proxian el daemon — nada del agente, la memoria o el modelo de seguridad se duplica. Aprobaciones, ejecuciones duraderas, logs JSONL y programaciones siguen viviendo en Libre Claw.

Solo para admin

Las rutas proxy de Libre Claw son solo para admin. La primera cuenta creada en una instalación nueva de Libre WebUI se convierte en administradora, así que la superficie de agente queda detrás de la misma autenticación que el resto de la app.