Integração com o Libre Claw
O Libre WebUI inclui uma integração nativa com o Libre Claw, o ambiente de agentes locais da Kroonen AI. O Libre Claw é apresentado como uma área de agentes de primeira classe dentro do Libre WebUI, e não como um plugin genérico de provedor de conclusão.
O Libre Claw continua sendo o ambiente de execução responsável pelo comportamento avançado do agente:
- execuções duráveis e logs de eventos JSONL
- ferramentas de arquivos, shell, git, navegador, HTTP, busca na web, MCP e agendamento
- solicitações de aprovação antes de efeitos colaterais
- memória persistente e skills de projeto/usuário
- modo de objetivo
- rotas alternativas de modelos
- relatórios de uso
- automações controladas pelo daemon e entrega pelo Telegram
- o painel local independente
O Libre WebUI se comunica com o daemon do Libre Claw por HTTP e disponibiliza esses recursos dentro da interface WebUI autenticada normal.
Na interface, essa área é chamada de Agentes — o ícone na barra lateral,
a rota /agents e a entrada da paleta de comandos usam esse nome. O Libre Claw
é o ambiente de execução por trás dela; portanto, o daemon, seu comando e suas variáveis de ambiente
mantêm o próprio nome ao longo deste guia.
Libre Claw e Work são diferentes
O Libre Claw continua sendo um ambiente de execução externo opcional. Ele não é necessário para o modo Work integrado do Libre WebUI.
| Work | Libre Claw | |
|---|---|---|
| Ambiente de execução | Loop nativo de modelo/ferramentas do Libre WebUI mais Docker | Daemon separado do Libre Claw |
| Escopo principal | Um espaço de trabalho de programação persistente e isolado por tarefa | Execuções de agentes mais amplas, memória, aprovações, agendamentos, navegador, MCP e ferramentas |
| Persistência | Histórico de tarefas em SQLite mais um volume nomeado do Docker pertencente à tarefa | Armazenamentos próprios de execuções e memória do Libre Claw |
| Roteamento de modelos | Ollama, Ollama Cloud ou plugin configurado de conclusão/chat do Libre WebUI | Configuração de provedor, modelo e alternativas do Libre Claw |
| Disponibilidade sem ele | O Work continua normalmente | Somente a área do Libre Claw em /agents fica desconectada |
Use o Work quando um modelo precisar criar ou modificar arquivos dentro de um contêiner restrito e limitado à tarefa. Use o Libre Claw quando precisar do conjunto mais amplo de ferramentas do daemon, do sistema de aprovação, da memória, dos objetivos ou das automações.
Arquitetura
O backend da WebUI nunca executa comandos de shell ou ferramentas de navegador diretamente para o Libre Claw. Ele encaminha as solicitações autenticadas de administradores ao daemon local e exibe o estado das execuções, os eventos, as aprovações, as automações, o uso e a configuração do daemon.
Inicie o Libre Claw
Instale o 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]"
Inicie o daemon:
libre-claw start
O painel e a API padrão estão disponíveis em:
http://127.0.0.1:8766/dashboard
Depois, abra Libre WebUI → Libre Claw.
Ambiente do backend
O Libre WebUI usa por padrão a URL do daemon local:
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
LIBRE_CLAW_TIMEOUT_MS=30000
Defina LIBRE_CLAW_BASE_URL se o daemon estiver em outro host, em um IP do Tailscale ou
em um serviço local atrás de proxy reverso.
Rotas da WebUI
Todas as rotas do Libre Claw exigem um usuário administrador autenticado, pois podem revelar caminhos de arquivos locais e acionar trabalho de agentes:
| Rota da WebUI | Recurso do Libre Claw |
|---|---|
GET /api/libre-claw/status | Integridade do daemon, URL base e URL do painel |
GET /api/libre-claw/config/model | Provedor/modelo atual |
PATCH /api/libre-claw/config/model | Atualizar provedor/modelo |
GET /api/libre-claw/config/fallback | Rota alternativa atual |
PATCH /api/libre-claw/config/fallback | Atualizar rota alternativa |
PATCH /api/libre-claw/config/theme | Atualizar tema do painel/TUI |
GET /api/libre-claw/runs | Listar execuções duráveis |
POST /api/libre-claw/runs | Iniciar execução de chat ou modo de objetivo |
GET /api/libre-claw/runs/:id | Metadados e artifacts da execução |
GET /api/libre-claw/runs/:id/events | Eventos incrementais da execução |
POST /api/libre-claw/runs/:id/cancel | Cancelar uma execução |
POST /api/libre-claw/runs/:id/permissions/:toolCallId | Aprovar ou negar uma chamada de ferramenta |
GET /api/libre-claw/usage | Resumo e registros de uso |
GET /api/libre-claw/automations | Listar automações agendadas |
POST /api/libre-claw/automations | Criar automação |
PATCH /api/libre-claw/automations/:id | Atualizar automação |
POST /api/libre-claw/automations/:id/run | Executar automação agora |
POST /api/libre-claw/automations/:id/pause | Pausar automação |
POST /api/libre-claw/automations/:id/resume | Retomar automação |
DELETE /api/libre-claw/automations/:id | Excluir automação |
Como iniciar execuções
A página da WebUI pode iniciar:
- Execuções de chat — interações normais com o agente do Libre Claw.
- Execuções de objetivo — modo de piloto automático limitado no qual o Libre Claw continua até que seu avaliador marque o objetivo como concluído ou ele atinja o limite configurado.
Substituições opcionais de provedor/modelo são repassadas ao Libre Claw nessa execução. Se forem omitidas, o Libre Claw usará seu provedor e modelo padrão configurados.
Aprovações
Quando o Libre Claw solicita permissão, a WebUI mostra a chamada de ferramenta pendente e permite que um administrador escolha:
allow_oncedenyalways_allow_tool
O Libre Claw continua responsável pelo modelo de permissões e pelas verificações de segurança. A WebUI apenas registra a escolha do administrador pela API do daemon.
Automações
O Libre WebUI pode criar e gerenciar automações do daemon do Libre Claw:
- automações de relatórios
- automações encaminhadas ao Telegram
- pausar/retomar
- executar agora
- excluir
Essas são automações do Libre Claw, e não tarefas cron do host. Os relatórios e o histórico de execução permanecem no armazenamento de execuções do Libre Claw.
Memória, skills, soul e ferramentas
Memória, skills, arquivos soul, ferramentas MCP, ferramentas de navegador, SearXNG, Petdex e Telegram são configurados no próprio Libre Claw. A WebUI exibe e controla os recursos voltados ao daemon sem duplicar o sistema de configuração interno do Libre Claw.
Comandos úteis do Libre Claw:
/memory status
/skills list
/soul status
/tools list
/workspace status
/telegram
/petdex status
Solução de problemas
A WebUI mostra "O daemon do Libre Claw não está conectado"
Inicie o daemon:
libre-claw start
Ou defina a URL do backend:
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766
Os botões de permissão não fazem nada
A execução pode já ter terminado, ou a permissão pode ter sido resolvida em outra interface, como o painel do Libre Claw ou a ponte do Telegram. Atualize a página da WebUI e examine a linha do tempo da execução.
Uma ferramenta foi negada
O gerenciador de permissões do Libre Claw é a autoridade. Verifique a configuração e os eventos de execução do próprio Libre Claw se uma chamada for negada antes que a WebUI receba uma solicitação de aprovação.
As automações não são executadas
Verifique o estado do daemon do Libre Claw e a configuração da automação:
libre-claw status
libre-claw start
O daemon precisa estar em execução para as automações agendadas e a entrega pelo Telegram.