Integracja Libre Claw

Libre WebUI zawiera natywną integrację z Libre Claw, lokalnym środowiskiem agentowym Kroonen AI. Libre Claw jest udostępniane w Libre WebUI jako pełnoprawny interfejs agentów, a nie jako ogólna wtyczka dostawcy uzupełnień.

Libre Claw pozostaje środowiskiem wykonawczym odpowiedzialnym za rozbudowane zachowanie agentów:

trwałe wykonania i dzienniki zdarzeń JSONL
narzędzia plików, powłoki, Git, przeglądarki, HTTP, wyszukiwania internetowego, MCP i harmonogramów
żądania zatwierdzenia przed efektami ubocznymi
trwała pamięć oraz umiejętności projektu/użytkownika
tryb celu
zapasowe trasy modeli
raporty użycia
automatyzacje zarządzane przez demona i dostarczanie przez Telegram
samodzielny panel lokalny

Libre WebUI komunikuje się z demonem Libre Claw przez HTTP i udostępnia te funkcje w zwykłej uwierzytelnionej powłoce WebUI.

W interfejsie ten obszar nazywa się Agents — ikona na pasku bocznym, trasa /agents i pozycja palety poleceń używają tej nazwy. Libre Claw jest środowiskiem wykonawczym w tle, dlatego demon, jego polecenie i zmienne środowiskowe zachowują własną nazwę w całym przewodniku.

Libre Claw i Work to różne funkcje

Libre Claw pozostaje opcjonalnym zewnętrznym środowiskiem wykonawczym. Nie jest wymagane przez wbudowany tryb Work Libre WebUI.

	Work	Libre Claw
Środowisko	Natywna pętla modelu/narzędzi Libre WebUI z Dockerem	Oddzielny demon Libre Claw
Główny zakres	Jeden trwały, izolowany obszar programistyczny na zadanie	Szersze wykonania agentów, pamięć, zgody, harmonogramy, przeglądarka, MCP i narzędzia
Trwałość	Historia zadań SQLite i nazwany wolumin Docker należący do zadania	Własne magazyny wykonań i pamięci Libre Claw
Routing modelu	Ollama, Ollama Cloud albo skonfigurowana wtyczka uzupełnień/czatu Libre WebUI	Konfiguracja dostawcy, modelu i trasy zapasowej Libre Claw
Dostępność bez środowiska	Work działa normalnie	Rozłączony jest tylko interfejs Libre Claw pod `/agents`

Używaj Work, gdy model ma budować lub modyfikować pliki w ograniczonym kontenerze przypisanym do zadania. Używaj Libre Claw, gdy potrzebujesz szerszego zestawu narzędzi demona, systemu zgód, pamięci, celów lub automatyzacji.

Architektura

Backend WebUI nigdy nie uruchamia bezpośrednio poleceń powłoki ani narzędzi przeglądarki dla Libre Claw. Przekazuje uwierzytelnione żądania administratora do lokalnego demona i wyświetla jego stan wykonań, zdarzenia, zgody, automatyzacje, użycie oraz konfigurację.

Uruchamianie Libre Claw

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

Uruchom demona:

libre-claw start

Domyślny panel i API są dostępne pod adresem:

http://127.0.0.1:8766/dashboard

Następnie otwórz Libre WebUI → Libre Claw.

Środowisko backendu

Libre WebUI domyślnie używa adresu lokalnego demona:

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

Ustaw LIBRE_CLAW_BASE_URL, jeśli demon działa na innym hoście, adresie Tailscale albo lokalnej usłudze za reverse proxy.

Trasy WebUI

Wszystkie trasy Libre Claw wymagają uwierzytelnionego administratora, ponieważ mogą ujawniać lokalne ścieżki i uruchamiać pracę agenta:

Trasa WebUI	Funkcja Libre Claw
`GET /api/libre-claw/status`	Stan demona, adres bazowy i adres panelu
`GET /api/libre-claw/config/model`	Bieżący dostawca/model
`PATCH /api/libre-claw/config/model`	Aktualizacja dostawcy/modelu
`GET /api/libre-claw/config/fallback`	Bieżąca trasa zapasowa
`PATCH /api/libre-claw/config/fallback`	Aktualizacja trasy zapasowej
`PATCH /api/libre-claw/config/theme`	Aktualizacja motywu panelu/TUI
`GET /api/libre-claw/runs`	Lista trwałych wykonań
`POST /api/libre-claw/runs`	Uruchomienie czatu lub trybu celu
`GET /api/libre-claw/runs/:id`	Metadane i artefakty wykonania
`GET /api/libre-claw/runs/:id/events`	Przyrostowe zdarzenia wykonania
`POST /api/libre-claw/runs/:id/cancel`	Anulowanie wykonania
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Zatwierdzenie lub odrzucenie wywołania narzędzia
`GET /api/libre-claw/usage`	Podsumowanie i rekordy użycia
`GET /api/libre-claw/automations`	Lista zaplanowanych automatyzacji
`POST /api/libre-claw/automations`	Utworzenie automatyzacji
`PATCH /api/libre-claw/automations/:id`	Aktualizacja automatyzacji
`POST /api/libre-claw/automations/:id/run`	Natychmiastowe uruchomienie automatyzacji
`POST /api/libre-claw/automations/:id/pause`	Wstrzymanie automatyzacji
`POST /api/libre-claw/automations/:id/resume`	Wznowienie automatyzacji
`DELETE /api/libre-claw/automations/:id`	Usunięcie automatyzacji

Uruchamianie wykonań

Strona WebUI może uruchamiać:

Wykonania czatu — zwykłe tury agenta Libre Claw.
Wykonania celu — ograniczony tryb autopilota, w którym Libre Claw kontynuuje, dopóki oceniający nie oznaczy celu jako ukończonego albo nie zostanie osiągnięty skonfigurowany limit.

Opcjonalne nadpisania dostawcy/modelu są przekazywane do Libre Claw dla danego wykonania. Jeśli je pominiesz, Libre Claw użyje skonfigurowanego dostawcy i modelu domyślnego.

Zgody

Gdy Libre Claw prosi o pozwolenie, WebUI pokazuje oczekujące wywołanie narzędzia i pozwala administratorowi wybrać:

allow_once
deny
always_allow_tool

Libre Claw nadal zarządza modelem uprawnień i kontrolami bezpieczeństwa. WebUI jedynie zapisuje wybór administratora przez API demona.

Automatyzacje

Libre WebUI może tworzyć i zarządzać automatyzacjami demona Libre Claw:

automatyzacje raportów
automatyzacje kierowane do Telegram
wstrzymywanie/wznawianie
uruchomienie teraz
usuwanie

Są to automatyzacje Libre Claw, a nie zadania cron hosta. Raporty i historia wykonań pozostają w magazynie wykonań Libre Claw.

Pamięć, umiejętności, soul i narzędzia

Pamięć, umiejętności, pliki soul, narzędzia MCP, narzędzia przeglądarkowe, SearXNG, Petdex i Telegram konfiguruje się w samym Libre Claw. WebUI wyświetla i steruje funkcjami demona bez powielania wewnętrznego systemu konfiguracji Libre Claw.

Przydatne polecenia Libre Claw:

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

Rozwiązywanie problemów

WebUI wyświetla "Libre Claw daemon is not connected"

Uruchom demona:

libre-claw start

Lub ustaw adres backendu:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Przyciski zgód nic nie robią

Wykonanie mogło już się zakończyć albo zgoda mogła zostać rozstrzygnięta w innym interfejsie, takim jak panel Libre Claw lub most Telegram. Odśwież stronę WebUI i sprawdź oś czasu wykonania.

Narzędzie zostało odrzucone

Menedżer uprawnień Libre Claw jest rozstrzygający. Jeśli wywołanie zostanie odrzucone, zanim WebUI pokaże prośbę o zgodę, sprawdź konfigurację i zdarzenia wykonania w Libre Claw.

Automatyzacje nie działają

Sprawdź stan demona Libre Claw i konfigurację automatyzacji:

libre-claw status
libre-claw start

Demon musi działać, aby wykonywać zaplanowane automatyzacje i dostarczać wyniki przez Telegram.

Libre Claw i Work to różne funkcje​

Architektura​

Uruchamianie Libre Claw​

Środowisko backendu​

Trasy WebUI​

Uruchamianie wykonań​

Zgody​

Automatyzacje​

Pamięć, umiejętności, soul i narzędzia​

Rozwiązywanie problemów​

WebUI wyświetla "Libre Claw daemon is not connected"​

Przyciski zgód nic nie robią​

Narzędzie zostało odrzucone​

Automatyzacje nie działają​

Powiązana dokumentacja​