Integração com Libre WebUI

Conecte o Libre WebUI ao daemon do Libre Claw para uma superfície de controle no navegador com linhas do tempo de execução, aprovações de ferramenta inline, automações e uso de provedor.

Uma superfície de controle no navegador para o Libre Claw.

Libre WebUI é uma interface de chat IA auto-hospedada e focada em privacidade construída pela Kroonen AI. Desde o release 0.12, ela oferece uma superfície de agente Libre Claw de primeira classe: uma entrada de barra lateral dedicada, uma rota /agents e rotas de backend somente admin que fazem proxy do daemon local. Seu runtime de agente, modelo de segurança, memória, ferramentas e agendamentos ficam no Libre Claw; o Libre WebUI adiciona o navegador por cima.

Fonte e configuração em github.com/libre-webui/libre-webui, Guia de integração (31-LIBRE_CLAW_INTEGRATION.md) 31-LIBRE_CLAW_INTEGRATION.md.

Iniciar o daemon

O Libre WebUI fala com o daemon do Libre Claw sobre localhost. Inicie-o como de costume e depois abra a página de agente no WebUI.

Iniciar o Libre Claw

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

Depois abra Libre WebUI → Libre Claw conecta-se a http://127.0.0.1:8766.

Apontar o WebUI para um daemon personalizado

Se o daemon roda em outro host ou porta, defina as variáveis de ambiente do backend antes de iniciar o Libre WebUI.

backend/.env

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

Reinicie o backend do WebUI para que os novos valores façam efeito.

O que a página de agente pode fazer

Run timelines

Inicie execuções de chat ou modo objetivo, passe overrides de provedor/modelo, faça stream de eventos incrementais, inspecione chamadas e resultados de ferramenta e cancele execuções ativas.

Inline approvals

Resolva pedidos de permissão de ferramenta do navegador: permitir uma vez, negar ou sempre permitir uma ferramenta sem sair da página.

Automations

Crie, atualize, execute agora, pause, retome e exclua relatórios agendados e rotas do Telegram.

Usage

Inspecione registros de uso de provedor e estado de rota de fallback da mesma página de agente.

Model routing

Troque o provedor e modelo ativos e revise os slots de fallback através de rotas proxy somente admin.

Daemon status

Veja o status de conexão, a saúde e a URL do painel sem sair do Libre WebUI.

Como se encaixa

O Libre WebUI é o navegador; o Libre Claw é o runtime. O backend do WebUI chama rotas somente admin sob /api/libre-claw que fazem proxy do daemon — nada do agente, da memória ou do modelo de segurança é duplicado. Aprovações, execuções duráveis, logs JSONL e agendamentos continuam todos no Libre Claw.

Somente admin

As rotas proxy do Libre Claw são somente admin. A primeira conta criada em uma instalação nova do Libre WebUI se torna administradora, então a superfície do agente fica atrás da mesma autenticação do resto do app.