Zum Hauptinhalt springen

Libre-Claw-Integration

Libre WebUI enthält eine native Integration für Libre Claw, die lokale Agentenlaufzeit von Kroonen AI. Libre Claw erscheint als erstklassige Agentenoberfläche und nicht als generisches Completion-Plugin.

Libre Claw bleibt für die leistungsfähigen Agentenfunktionen zuständig:

  • dauerhafte Ausführungen und JSONL-Ereignisprotokolle
  • Datei-, Shell-, Git-, Browser-, HTTP-, Websuche-, MCP- und Zeitplan-Tools
  • Genehmigungen vor Nebenwirkungen
  • dauerhaftes Gedächtnis und Projekt-/Benutzer-Skills
  • Zielmodus, Ausweichmodelle und Nutzungsberichte
  • daemonverwaltete Automatisierungen und Telegram-Zustellung
  • eigenständiges lokales Dashboard

Libre WebUI spricht per HTTP mit dem Daemon und zeigt diese Funktionen in seiner authentifizierten Oberfläche.

Die Oberfläche heißt Agenten: Seitenleistensymbol, Route /agents und Befehlspalette nutzen diesen Namen. Libre Claw ist die Laufzeit dahinter; Daemon, Befehl und Variablen behalten ihren Namen.

Libre Claw und Work unterscheiden sich​

Libre Claw ist optional und für das integrierte Work nicht nötig.

WorkLibre Claw
LaufzeitNative Libre-WebUI-Modell-/Toolschleife plus DockerSeparater Libre-Claw-Daemon
HauptbereichDauerhafter isolierter Coding-Workspace pro AufgabeBreite Agentenläufe, Gedächtnis, Freigaben, Zeitpläne, Browser/MCP
PersistenzSQLite-Verlauf und aufgabeneigenes Docker-VolumeEigene Lauf- und Gedächtnisspeicher
ModellroutingOllama, Ollama Cloud oder konfiguriertes Libre-WebUI-PluginLibre-Claw-Anbieter-, Modell- und Fallback-Konfiguration
Ohne die FunktionWork läuft normal weiterNur /agents ist getrennt

Nutze Work für Dateien in einem eingeschränkten Aufgabencontainer; Libre Claw für breitere Tools, Genehmigungen, Gedächtnis, Ziele oder Automatisierungen.

Architektur​

Das WebUI-Backend führt für Libre Claw nie direkt Shell- oder Browsertools aus. Es leitet authentifizierte Admin-Anfragen weiter und zeigt Status, Ereignisse, Genehmigungen, Automatisierungen, Nutzung und Konfiguration.

Libre Claw starten​

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
http://127.0.0.1:8766/dashboard

Öffne danach Libre WebUI → Libre Claw.

Backend-Umgebung​

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

Setze LIBRE_CLAW_BASE_URL für einen anderen Host, Tailscale oder Reverse-Proxy.

WebUI-Routen​

Alle Routen erfordern einen authentifizierten Administrator, da sie lokale Pfade offenlegen und Arbeit starten können:

WebUI-RouteFunktion
GET /api/libre-claw/statusGesundheit und URLs
GET /api/libre-claw/config/modelAktueller Anbieter und Modell
PATCH /api/libre-claw/config/modelAnbieter/Modell ändern
GET /api/libre-claw/config/fallbackAktuelle Ausweichroute
PATCH /api/libre-claw/config/fallbackAusweichroute ändern
PATCH /api/libre-claw/config/themeDashboard-/TUI-Design ändern
GET /api/libre-claw/runsLäufe auflisten
POST /api/libre-claw/runsChat- oder Ziellauf starten
GET /api/libre-claw/runs/:idMetadaten und Artefakte
GET /api/libre-claw/runs/:id/eventsInkrementelle Ereignisse
POST /api/libre-claw/runs/:id/cancelLauf abbrechen
POST /api/libre-claw/runs/:id/permissions/:toolCallIdTool erlauben/ablehnen
GET /api/libre-claw/usageNutzung
GET /api/libre-claw/automationsAutomatisierungen auflisten
POST /api/libre-claw/automationsErstellen
PATCH /api/libre-claw/automations/:idAktualisieren
POST /api/libre-claw/automations/:id/runSofort ausführen
POST /api/libre-claw/automations/:id/pausePausieren
POST /api/libre-claw/automations/:id/resumeFortsetzen
DELETE /api/libre-claw/automations/:idLöschen

Läufe starten​

  • Chatläufe sind normale Agententurns.
  • Zielläufe laufen begrenzt automatisch, bis der Prüfer das Ziel abschließt oder das Limit erreicht ist.

Optionale Anbieter-/Modellwerte gelten nur für den Lauf; sonst nutzt Libre Claw seine Standards.

Genehmigungen​

WebUI zeigt ausstehende Toolaufrufe und bietet:

  • allow_once
  • deny
  • always_allow_tool

Libre Claw bleibt Autorität für Berechtigungen und Sicherheit; WebUI übermittelt nur die Admin-Entscheidung.

Automatisierungen​

Libre WebUI verwaltet Berichte, Telegram-Routing, Pause/Fortsetzung, Sofortlauf und Löschung. Es sind Libre-Claw- Automatisierungen, keine Host-Cronjobs; Berichte und Verlauf bleiben im Laufstore.

Gedächtnis, Skills, Soul und Tools​

Gedächtnis, Skills, Soul-Dateien, MCP, Browser, SearXNG, Petdex und Telegram werden in Libre Claw konfiguriert.

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

Fehlerbehebung​

WebUI meldet „Libre-Claw-Daemon nicht verbunden“​

libre-claw start
LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Berechtigungsschaltflächen reagieren nicht​

Der Lauf kann beendet oder die Entscheidung über Dashboard/Telegram getroffen worden sein. Aktualisiere und prüfe die Chronik.

Ein Tool wurde abgelehnt​

Der Libre-Claw-Berechtigungsmanager ist maßgeblich. Prüfe Konfiguration und Laufereignisse.

Automatisierungen laufen nicht​

libre-claw status
libre-claw start

Der Daemon muss für Zeitpläne und Telegram laufen.

Verwandte Dokumentation​