Přeskočit na hlavní obsah

Integrace Libre Claw

Libre WebUI obsahuje nativní integraci s Libre Claw, místním prostředím agentů od Kroonen AI. Libre Claw se v Libre WebUI zobrazuje jako plnohodnotná plocha agentů, nikoli jako obecný completion plugin poskytovatele.

Libre Claw zůstává runtime, který vlastní pokročilé chování agenta:

  • trvalé běhy a protokoly událostí JSONL
  • nástroje pro soubory, shell, git, prohlížeč, HTTP, webové vyhledávání, MCP a plány
  • žádosti o schválení před vedlejšími účinky
  • trvalá paměť a dovednosti projektu/uživatele
  • režim cílů
  • záložní trasy modelů
  • reporty využití
  • automatizace vlastněné daemonem a doručování přes Telegram
  • samostatný místní panel

Libre WebUI komunikuje s daemonem Libre Claw přes HTTP a funkce zpřístupňuje v běžném ověřeném rozhraní. Plocha se v rozhraní nazývá Agents — v postranním panelu, na trase /agents i v paletě příkazů. Daemon, příkaz a proměnné prostředí nadále používají název Libre Claw.

Libre Claw a Work jsou odlišné​

Libre Claw je volitelný externí runtime a není nutný pro vestavěný režim Work.

WorkLibre Claw
RuntimeNativní smyčka modelu/nástrojů Libre WebUI a DockerSamostatný daemon Libre Claw
Hlavní rozsahJeden trvalý izolovaný programovací prostor na úlohuŠirší běhy agentů, paměť, schvalování, plány, prohlížeč, MCP a nástroje
TrvalostHistorie SQLite a Docker volume vlastněný úlohouVlastní úložiště běhů a paměti Libre Claw
Směrování modeluOllama, Ollama Cloud nebo nakonfigurovaný plugin Libre WebUIKonfigurace poskytovatele, modelu a záloh Libre Claw
Dostupnost bez nějWork funguje normálněOdpojí se pouze plocha Libre Claw /agents

Work používejte pro práci se soubory v omezeném kontejneru úlohy. Libre Claw použijte pro širší sadu nástrojů daemonu, schvalování, paměť, cíle či automatizace.

Architektura​

Backend WebUI nikdy za Libre Claw přímo nespouští shellové příkazy ani nástroje prohlížeče. Předává ověřené administrátorské požadavky místnímu daemonu a zobrazuje stav běhů, události, schválení, automatizace, využití a konfiguraci.

Spuštění Libre Claw​

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

Spusťte daemon:

libre-claw start

Výchozí panel a API jsou na:

http://127.0.0.1:8766/dashboard

Poté otevřete Libre WebUI → Libre Claw.

Prostředí backendu​

Libre WebUI ve výchozím stavu používá URL místního daemonu:

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

LIBRE_CLAW_BASE_URL změňte, pokud daemon běží na jiném hostiteli, IP Tailscale nebo za místní reverse proxy.

Trasy WebUI​

Všechny trasy vyžadují přihlášeného administrátora, protože mohou odhalit místní cesty a spustit práci agenta:

Trasa WebUIFunkce Libre Claw
GET /api/libre-claw/statusStav daemonu, base URL, URL panelu
GET /api/libre-claw/config/modelAktuální poskytovatel/model
PATCH /api/libre-claw/config/modelAktualizovat poskytovatele/model
GET /api/libre-claw/config/fallbackAktuální záložní trasa
PATCH /api/libre-claw/config/fallbackAktualizovat záložní trasu
PATCH /api/libre-claw/config/themeAktualizovat motiv panelu/TUI
GET /api/libre-claw/runsVypsat trvalé běhy
POST /api/libre-claw/runsSpustit chatový běh nebo režim cílů
GET /api/libre-claw/runs/:idMetadata a artifacts běhu
GET /api/libre-claw/runs/:id/eventsPřírůstkové události běhu
POST /api/libre-claw/runs/:id/cancelZrušit běh
POST /api/libre-claw/runs/:id/permissions/:toolCallIdSchválit nebo odmítnout nástroj
GET /api/libre-claw/usageSouhrn a záznamy využití
GET /api/libre-claw/automationsVypsat naplánované automatizace
POST /api/libre-claw/automationsVytvořit automatizaci
PATCH /api/libre-claw/automations/:idAktualizovat automatizaci
POST /api/libre-claw/automations/:id/runSpustit nyní
POST /api/libre-claw/automations/:id/pausePozastavit
POST /api/libre-claw/automations/:id/resumeObnovit
DELETE /api/libre-claw/automations/:idSmazat

Spouštění běhů​

  • Chatové běhy — běžné tahy agenta Libre Claw.
  • Běhy cílů — omezený autopilot, ve kterém Libre Claw pokračuje, dokud rozhodčí neoznačí cíl za dokončený nebo není dosažen limit.

Volitelná změna poskytovatele/modelu se předá Libre Claw pro daný běh. Pokud ji neuvedete, použije nakonfigurované výchozí hodnoty.

Schvalování​

Když Libre Claw požádá o oprávnění, WebUI zobrazí čekající volání nástroje a administrátor zvolí:

  • allow_once
  • deny
  • always_allow_tool

Model oprávnění a bezpečnostní kontroly nadále vlastní Libre Claw; WebUI pouze zaznamená volbu přes API daemonu.

Automatizace​

Libre WebUI může vytvářet a spravovat automatizace daemonu Libre Claw pro reporty a Telegram, pozastavit je, obnovit, spustit ihned a smazat. Nejde o cron úlohy hostitele; reporty a historie zůstávají v úložišti běhů Libre Claw.

Paměť, dovednosti, Soul a nástroje​

Paměť, dovednosti, soubory soul, MCP, prohlížeč, SearXNG, Petdex a Telegram se konfigurují přímo v Libre Claw. Užitečné příkazy:

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

Řešení problémů​

WebUI zobrazuje "Libre Claw daemon is not connected"​

libre-claw start

nebo:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Tlačítka oprávnění nic nedělají​

Běh již mohl skončit nebo bylo oprávnění vyřešeno v panelu Libre Claw či přes Telegram. Obnovte stránku a prohlédněte časovou osu.

Nástroj byl odmítnut​

Rozhodující je správce oprávnění Libre Claw. Zkontrolujte vlastní konfiguraci a události běhu.

Automatizace se nespouštějí​

libre-claw status
libre-claw start

Daemon musí běžet, aby fungovaly plány a doručování přes Telegram.

Související dokumentace​