Integrarea Libre Claw

Libre WebUI include o integrare nativă cu Libre Claw, sistemul local de agenți al Kroonen AI. Acesta apare ca o suprafață completă pentru agenți, nu ca un plugin completion generic.

Libre Claw rămâne runtime-ul care deține comportamentul puternic al agentului:

execuții durabile și loguri JSONL;
instrumente pentru fișiere, shell, git, browser, HTTP, căutare web, MCP și planificare;
aprobări înaintea efectelor secundare;
memorie persistentă și abilități de proiect/utilizator;
goal mode;
rute de modele fallback;
raportarea utilizării;
automatizări daemon și livrare prin Telegram;
dashboard local autonom.

Libre WebUI comunică prin HTTP cu daemon-ul și expune funcțiile în UI-ul autentificat. Suprafața se numește Agents în bara laterală, pe ruta /agents și în paleta de comenzi. Daemon-ul, comenzile și variabilele de mediu păstrează numele Libre Claw.

Libre Claw și Work sunt diferite

Libre Claw este un runtime extern opțional și nu este necesar pentru Work integrat.

	Work	Libre Claw
Runtime	Buclă nativă model/instrumente Libre WebUI și Docker	Daemon Libre Claw separat
Domeniu principal	Un spațiu de programare persistent și izolat per sarcină	Execuții mai ample, memorie, aprobări, programe, browser, MCP și instrumente
Stocare	Istoric SQLite și volum Docker al sarcinii	Propriile stocări pentru execuții/memorie
Rutarea modelelor	Ollama, Ollama Cloud sau plugin configurat	Configurația furnizorului, modelului și fallback-ului Libre Claw
Fără acesta	Work continuă să funcționeze	Numai suprafața `/agents` este deconectată

Folosiți Work pentru fișiere într-un container restricționat al sarcinii. Folosiți Libre Claw pentru instrumente mai ample, aprobări, memorie, obiective sau automatizări daemon.

Arhitectură

Backend-ul WebUI nu execută direct instrumente shell sau browser pentru Libre Claw. El retransmite cereri autentificate ale administratorului și afișează starea, evenimentele, aprobările, automatizările, utilizarea și configurația daemon-ului.

Pornirea 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]"

libre-claw start

Dashboard/API implicit:

http://127.0.0.1:8766/dashboard

Apoi deschideți Libre WebUI → Libre Claw.

Mediul backend

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

Schimbați LIBRE_CLAW_BASE_URL dacă daemon-ul rulează pe alt host, pe o adresă Tailscale sau în spatele unui reverse proxy.

Rute WebUI

Toate necesită un administrator autentificat, deoarece pot expune căi locale și pot porni acțiuni ale agentului:

Rută WebUI	Funcție
`GET /api/libre-claw/status`	Starea daemon-ului, URL de bază, URL dashboard
`GET /api/libre-claw/config/model`	Furnizor/model curent
`PATCH /api/libre-claw/config/model`	Actualizează furnizorul/modelul
`GET /api/libre-claw/config/fallback`	Fallback curent
`PATCH /api/libre-claw/config/fallback`	Actualizează fallback-ul
`PATCH /api/libre-claw/config/theme`	Tema dashboard/TUI
`GET /api/libre-claw/runs`	Listează execuțiile durabile
`POST /api/libre-claw/runs`	Pornește o execuție chat sau goal
`GET /api/libre-claw/runs/:id`	Metadate și artefacte
`GET /api/libre-claw/runs/:id/events`	Evenimente incrementale
`POST /api/libre-claw/runs/:id/cancel`	Anulează execuția
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Aprobă/refuză instrumentul
`GET /api/libre-claw/usage`	Rezumat și înregistrări de utilizare
`GET /api/libre-claw/automations`	Listează automatizările
`POST /api/libre-claw/automations`	Creează o automatizare
`PATCH /api/libre-claw/automations/:id`	Actualizează automatizarea
`POST /api/libre-claw/automations/:id/run`	Rulează acum
`POST /api/libre-claw/automations/:id/pause`	Suspendă
`POST /api/libre-claw/automations/:id/resume`	Reia
`DELETE /api/libre-claw/automations/:id`	Șterge

Pornirea execuțiilor

Chat runs — ture obișnuite ale agentului.
Goal runs — pilot automat limitat până când evaluatorul finalizează obiectivul sau este atinsă limita.

Suprascrierile opționale pentru furnizor/model sunt transmise către Libre Claw; altfel sunt folosite valorile sale implicite.

Aprobări

Când este solicitată permisiunea, WebUI afișează apelul instrumentului și opțiunile:

allow_once
deny
always_allow_tool

Libre Claw deține modelul de permisiuni și verificările; WebUI înregistrează doar alegerea prin API-ul daemon-ului.

Automatizări

WebUI creează și gestionează automatizări Libre Claw pentru rapoarte și Telegram, cu suspendare/reluare, rulare imediată și ștergere. Acestea sunt automatizări ale daemon-ului, nu job-uri cron ale host-ului; istoricul rămâne în Libre Claw.

Memorie, abilități, Soul și instrumente

Memoria, abilitățile, fișierele soul, MCP, browserul, SearXNG, Petdex și Telegram se configurează în Libre Claw. Comenzi utile:

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

Depanare

WebUI afișează "Libre Claw daemon is not connected"

libre-claw start

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Butoanele de permisiune nu funcționează

Este posibil ca execuția să se fi încheiat sau permisiunea să fi fost rezolvată din dashboard ori Telegram. Reîmprospătați pagina și verificați cronologia.

Un instrument a fost refuzat

Managerul de permisiuni Libre Claw este autoritatea. Verificați configurația și evenimentele.

Automatizările nu rulează

libre-claw status
libre-claw start

Daemon-ul trebuie să ruleze pentru programe și Telegram.

Libre Claw și Work sunt diferite​

Arhitectură​

Pornirea Libre Claw​

Mediul backend​

Rute WebUI​

Pornirea execuțiilor​

Aprobări​

Automatizări​

Memorie, abilități, Soul și instrumente​

Depanare​

WebUI afișează "Libre Claw daemon is not connected"​

Butoanele de permisiune nu funcționează​

Un instrument a fost refuzat​

Automatizările nu rulează​

Documentație asociată​