Libre Claw-integratie

Libre WebUI bevat een ingebouwde integratie voor Libre Claw, de lokale agentomgeving van Kroonen AI. Libre Claw wordt binnen Libre WebUI als volwaardige agentinterface aangeboden en niet als een algemene plug-in voor completionproviders.

Libre Claw blijft de runtime die het krachtige agentgedrag beheert:

duurzame uitvoeringen en JSONL-gebeurtenislogboeken
tools voor bestanden, shell, Git, browser, HTTP, webzoeken, MCP en planningen
goedkeuringsverzoeken vóór neveneffecten
permanent geheugen en skills voor projecten/gebruikers
doelmodus
uitwijkroutes voor modellen
gebruiksrapporten
door de daemon beheerde automatiseringen en aflevering via Telegram
het zelfstandige lokale dashboard

Libre WebUI communiceert via HTTP met de Libre Claw-daemon en biedt die functies binnen de normale geauthenticeerde WebUI-omgeving aan.

In de interface heet dit onderdeel Agents: het pictogram in de zijbalk, de route /agents en de optie in het opdrachtenpalet gebruiken allemaal die naam. Libre Claw is de runtime erachter. Daarom behouden de daemon, de opdracht en de omgevingsvariabelen in deze handleiding hun eigen naam.

Libre Claw en Work zijn verschillend

Libre Claw blijft een optionele externe runtime. Het is niet vereist voor de ingebouwde Work-modus van Libre WebUI.

	Work	Libre Claw
Runtime	Ingebouwde model-/toollus van Libre WebUI plus Docker	Afzonderlijke Libre Claw-daemon
Hoofddoel	Eén permanente, geïsoleerde programmeerwerkruimte per taak	Bredere agentuitvoeringen, geheugen, goedkeuringen, planningen, browser, MCP en tools
Persistentie	SQLite-taakgeschiedenis plus een benoemd Docker-volume van de taak	Eigen opslag van Libre Claw voor uitvoeringen en geheugen
Modelroutering	Ollama, Ollama Cloud of een geconfigureerde plug-in van Libre WebUI voor completions/chats	Provider-, model- en uitwijkconfiguratie van Libre Claw
Beschikbaarheid zonder deze runtime	Work blijft normaal werken	Alleen de Libre Claw-interface `/agents` is niet verbonden

Gebruik Work wanneer een model bestanden moet bouwen of wijzigen in een beperkte, taakgebonden container. Gebruik Libre Claw wanneer u de bredere toolset, het goedkeuringssysteem, geheugen, doelen of automatiseringen van de daemon nodig hebt.

Architectuur

De WebUI-backend voert voor Libre Claw nooit rechtstreeks shellopdrachten of browsertools uit. Hij proxyt geauthenticeerde beheerdersverzoeken naar de lokale daemon en toont de uitvoeringsstatus, gebeurtenissen, goedkeuringen, automatiseringen, gebruiksgegevens en configuratie van de daemon.

Libre Claw starten

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

Start de daemon:

libre-claw start

Het standaarddashboard en de API zijn beschikbaar op:

http://127.0.0.1:8766/dashboard

Open daarna Libre WebUI → Libre Claw.

Backendomgeving

Libre WebUI gebruikt standaard de URL van de lokale daemon:

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

Stel LIBRE_CLAW_BASE_URL in als de daemon op een andere host, een Tailscale-IP-adres of een lokale dienst achter een reverse proxy draait.

WebUI-routes

Alle Libre Claw-routes vereisen een geauthenticeerde beheerder, omdat ze lokale bestandspaden kunnen onthullen en agentwerk kunnen activeren:

WebUI-route	Libre Claw-functie
`GET /api/libre-claw/status`	Status van daemon, basis-URL en dashboard-URL
`GET /api/libre-claw/config/model`	Huidige provider/model
`PATCH /api/libre-claw/config/model`	Provider/model bijwerken
`GET /api/libre-claw/config/fallback`	Huidige uitwijkroute
`PATCH /api/libre-claw/config/fallback`	Uitwijkroute bijwerken
`PATCH /api/libre-claw/config/theme`	Dashboard-/TUI-thema bijwerken
`GET /api/libre-claw/runs`	Duurzame uitvoeringen weergeven
`POST /api/libre-claw/runs`	Chat- of doelmodusuitvoering starten
`GET /api/libre-claw/runs/:id`	Metadata en artefacten van uitvoering
`GET /api/libre-claw/runs/:id/events`	Incrementele uitvoeringsgebeurtenissen
`POST /api/libre-claw/runs/:id/cancel`	Een uitvoering annuleren
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Een tooloproep toestaan of weigeren
`GET /api/libre-claw/usage`	Gebruiksoverzicht en registraties
`GET /api/libre-claw/automations`	Geplande automatiseringen weergeven
`POST /api/libre-claw/automations`	Automatisering maken
`PATCH /api/libre-claw/automations/:id`	Automatisering bijwerken
`POST /api/libre-claw/automations/:id/run`	Automatisering nu uitvoeren
`POST /api/libre-claw/automations/:id/pause`	Automatisering onderbreken
`POST /api/libre-claw/automations/:id/resume`	Automatisering hervatten
`DELETE /api/libre-claw/automations/:id`	Automatisering verwijderen

Uitvoeringen starten

De WebUI-pagina kan het volgende starten:

Chatuitvoeringen — normale agentbeurten van Libre Claw.
Doeluitvoeringen — begrensde automatische modus waarin Libre Claw doorgaat totdat de beoordelaar het doel als voltooid markeert of de geconfigureerde limiet wordt bereikt.

Optionele overrides voor provider/model worden voor die uitvoering doorgegeven aan Libre Claw. Als u ze weglaat, gebruikt Libre Claw de geconfigureerde standaardprovider en het standaardmodel.

Goedkeuringen

Wanneer Libre Claw toestemming vraagt, toont WebUI de openstaande tooloproep en kan een beheerder kiezen uit:

allow_once
deny
always_allow_tool

Libre Claw blijft eigenaar van het toestemmingsmodel en de veiligheidscontroles. WebUI legt via de daemon-API alleen de keuze van de beheerder vast.

Automatiseringen

Libre WebUI kan automatiseringen van de Libre Claw-daemon maken en beheren:

rapportautomatiseringen
automatiseringen die naar Telegram worden gerouteerd
onderbreken/hervatten
nu uitvoeren
verwijderen

Dit zijn Libre Claw-automatiseringen, geen cron-taken op de host. Rapporten en uitvoeringsgeschiedenis blijven in de uitvoeringsopslag van Libre Claw.

Geheugen, skills, soul en tools

Geheugen, skills, soul-bestanden, MCP-tools, browsertools, SearXNG, Petdex en Telegram worden in Libre Claw zelf geconfigureerd. WebUI toont en bestuurt de functies die de daemon aanbiedt, zonder het interne configuratiesysteem van Libre Claw te dupliceren.

Nuttige Libre Claw-opdrachten:

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

Problemen oplossen

WebUI toont "Libre Claw daemon is not connected"

Start de daemon:

libre-claw start

Of stel de backend-URL in:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Toestemmingsknoppen doen niets

De uitvoering kan al zijn voltooid of de toestemming kan via een andere interface zijn afgehandeld, zoals het Libre Claw-dashboard of de Telegram-brug. Vernieuw de WebUI-pagina en bekijk de tijdlijn van de uitvoering.

Een tool is geweigerd

De toestemmingsbeheerder van Libre Claw is leidend. Controleer de eigen configuratie en uitvoeringsgebeurtenissen van Libre Claw als een oproep wordt geweigerd voordat WebUI een goedkeuringsverzoek ziet.

Automatiseringen worden niet uitgevoerd

Controleer de daemonstatus en automatiseringsconfiguratie van Libre Claw:

libre-claw status
libre-claw start

De daemon moet actief zijn voor geplande automatiseringen en aflevering via Telegram.

Libre Claw en Work zijn verschillend​

Architectuur​

Libre Claw starten​

Backendomgeving​

WebUI-routes​

Uitvoeringen starten​

Goedkeuringen​

Automatiseringen​

Geheugen, skills, soul en tools​

Problemen oplossen​

WebUI toont "Libre Claw daemon is not connected"​

Toestemmingsknoppen doen niets​

Een tool is geweigerd​

Automatiseringen worden niet uitgevoerd​

Gerelateerde documentatie​