Integración de Libre Claw

Libre WebUI incluye una integración nativa con Libre Claw, el entorno local de agentes de Kroonen AI. Libre Claw se presenta como una superficie de agentes de primera clase dentro de Libre WebUI, no como un plugin genérico de completado.

Libre Claw sigue siendo el runtime propietario del potente comportamiento de agente:

ejecuciones duraderas y registros JSONL
herramientas de archivos, shell, Git, navegador, HTTP, búsqueda web, MCP y programación
solicitudes de aprobación antes de efectos secundarios
memoria persistente y habilidades de proyecto o usuario
modo de objetivo
rutas de modelos alternativas
informes de uso
automatizaciones gestionadas por el daemon y entrega mediante Telegram
panel local independiente

Libre WebUI se comunica con el daemon de Libre Claw mediante HTTP y expone las funciones dentro de su interfaz autenticada.

En la interfaz, esta superficie se denomina Agentes: el icono de la barra lateral, la ruta /agents y la entrada de la paleta usan ese nombre. Libre Claw es el runtime subyacente, por lo que el daemon, su comando y sus variables conservan su propio nombre en esta guía.

Libre Claw y Work son diferentes

Libre Claw sigue siendo un runtime externo opcional. El modo Work integrado no lo necesita.

	Work	Libre Claw
Runtime	Bucle nativo de modelos y herramientas de Libre WebUI con Docker	Daemon independiente de Libre Claw
Alcance principal	Un espacio persistente y aislado por tarea	Ejecuciones amplias, memoria, aprobaciones, programación, navegador y MCP
Persistencia	Historial SQLite y volumen Docker propiedad de la tarea	Almacenes propios de ejecuciones y memoria
Enrutamiento de modelos	Ollama, Ollama Cloud o plugin de Libre WebUI configurado	Configuración de proveedor, modelo y alternativas de Libre Claw
Sin él	Work continúa normalmente	Solo se desconecta la superficie `/agents`

Usa Work cuando un modelo deba crear o modificar archivos dentro de un contenedor restringido por tarea. Usa Libre Claw cuando necesites herramientas más amplias, aprobaciones, memoria, objetivos o automatizaciones.

Arquitectura

El backend de WebUI nunca ejecuta directamente comandos shell ni herramientas del navegador para Libre Claw. Actúa como proxy de las solicitudes autenticadas de administradores y muestra estado, eventos, aprobaciones, automatizaciones, uso y configuración del daemon.

Iniciar Libre Claw

Instala Libre Claw:

git clone https://github.com/kroonen-ai/libre-claw.git
cd libre-claw
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Inicia el daemon:

libre-claw start

El panel y la API predeterminados están en:

http://127.0.0.1:8766/dashboard

Después abre Libre WebUI → Libre Claw.

Entorno del backend

Libre WebUI usa por defecto la URL local del daemon:

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

Define LIBRE_CLAW_BASE_URL si se ejecuta en otro host, una IP de Tailscale o un servicio tras proxy inverso.

Rutas de WebUI

Todas requieren un administrador autenticado porque pueden revelar rutas locales y activar trabajo:

Ruta WebUI	Función de Libre Claw
`GET /api/libre-claw/status`	Salud, URL base y URL del panel
`GET /api/libre-claw/config/model`	Proveedor y modelo actuales
`PATCH /api/libre-claw/config/model`	Actualizar proveedor y modelo
`GET /api/libre-claw/config/fallback`	Ruta alternativa actual
`PATCH /api/libre-claw/config/fallback`	Actualizar ruta alternativa
`PATCH /api/libre-claw/config/theme`	Actualizar tema del panel o TUI
`GET /api/libre-claw/runs`	Listar ejecuciones duraderas
`POST /api/libre-claw/runs`	Iniciar chat o modo de objetivo
`GET /api/libre-claw/runs/:id`	Metadatos y artefactos
`GET /api/libre-claw/runs/:id/events`	Eventos incrementales
`POST /api/libre-claw/runs/:id/cancel`	Cancelar ejecución
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Aprobar o denegar una herramienta
`GET /api/libre-claw/usage`	Resumen y registros de uso
`GET /api/libre-claw/automations`	Listar automatizaciones
`POST /api/libre-claw/automations`	Crear automatización
`PATCH /api/libre-claw/automations/:id`	Actualizar automatización
`POST /api/libre-claw/automations/:id/run`	Ejecutar ahora
`POST /api/libre-claw/automations/:id/pause`	Pausar
`POST /api/libre-claw/automations/:id/resume`	Reanudar
`DELETE /api/libre-claw/automations/:id`	Eliminar

Iniciar ejecuciones

La página puede iniciar:

Ejecuciones de chat — turnos normales del agente.
Ejecuciones de objetivo — piloto automático limitado hasta que el juez marque el objetivo como completo o se alcance el límite.

Las sustituciones opcionales de proveedor o modelo se pasan a Libre Claw. Si se omiten, usa su configuración predeterminada.

Aprobaciones

Cuando Libre Claw pide permiso, WebUI muestra la llamada pendiente y permite elegir:

allow_once
deny
always_allow_tool

Libre Claw sigue controlando el modelo de permisos y la seguridad. WebUI solo registra la decisión mediante la API del daemon.

Automatizaciones

Libre WebUI puede crear y gestionar automatizaciones del daemon:

informes
automatizaciones dirigidas a Telegram
pausa y reanudación
ejecución inmediata
eliminación

Son automatizaciones de Libre Claw, no trabajos cron del host. Los informes y el historial permanecen en su almacén.

Memoria, habilidades, alma y herramientas

La memoria, habilidades, archivos de alma, herramientas MCP y del navegador, SearXNG, Petdex y Telegram se configuran en Libre Claw. WebUI muestra y controla las funciones orientadas al daemon sin duplicar su configuración.

Comandos útiles:

/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status

Solución de problemas

WebUI muestra «El daemon de Libre Claw no está conectado»

Inicia el daemon:

libre-claw start

O define la URL del backend:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Los botones de permiso no hacen nada

La ejecución quizá haya terminado o el permiso se haya resuelto desde otra superficie, como el panel o Telegram. Actualiza WebUI e inspecciona la cronología.

Se ha denegado una herramienta

El gestor de permisos de Libre Claw es la autoridad. Revisa su configuración y los eventos si la llamada se deniega antes de llegar a WebUI.

Las automatizaciones no se ejecutan

Comprueba el estado del daemon y su configuración:

libre-claw status
libre-claw start

El daemon debe ejecutarse para las automatizaciones programadas y la entrega por Telegram.

Libre Claw y Work son diferentes​

Arquitectura​

Iniciar Libre Claw​

Entorno del backend​

Rutas de WebUI​

Iniciar ejecuciones​

Aprobaciones​

Automatizaciones​

Memoria, habilidades, alma y herramientas​

Solución de problemas​

WebUI muestra «El daemon de Libre Claw no está conectado»​

Los botones de permiso no hacen nada​

Se ha denegado una herramienta​

Las automatizaciones no se ejecutan​

Documentación relacionada​