Ugrás a fő tartalomra

Libre Claw integráció

A Libre WebUI natív integrációt tartalmaz a Libre Claw rendszerhez, a Kroonen AI helyi ügynökkeretrendszeréhez. Teljes ügynökfelületként jelenik meg, nem általános completion bővítményként.

A Libre Claw marad az a runtime, amely az ügynök nagy jogosultságú viselkedését birtokolja:

  • tartós futások és JSONL-naplók;
  • fájl-, shell-, git-, böngésző-, HTTP-, webkeresési, MCP- és ütemezési eszközök;
  • jóváhagyások mellékhatások előtt;
  • tartós memória és projekt-/felhasználói készségek;
  • goal mode;
  • tartalék modellútvonalak;
  • használati jelentések;
  • daemon-automatizálások és Telegram-kézbesítés;
  • önálló helyi vezérlőpult.

A Libre WebUI HTTP-n kommunikál a daemonnal, és a funkciókat a hitelesített felületen teszi elérhetővé. A felület neve Agents az oldalsávban, az /agents útvonalon és a parancspalettában. A daemon, a parancsok és a környezeti változók megtartják a Libre Claw nevet.

A Libre Claw és a Work különbözik​

A Libre Claw opcionális külső runtime, és nem szükséges a beépített Work használatához.

WorkLibre Claw
RuntimeA Libre WebUI natív modell-/eszközhurka és DockerKülön Libre Claw daemon
Fő hatókörFeladatonként egy tartós, elszigetelt kódolási munkatérSzélesebb ügynökfutások, memória, jóváhagyások, ütemezések, böngésző, MCP és eszközök
TárolásSQLite-előzmények és a feladat Docker-köteteSaját futás- és memóriatárolók
ModellútvonalOllama, Ollama Cloud vagy beállított bővítményLibre Claw szolgáltató-, modell- és fallback-beállítások
NélküleA Work tovább működikCsak az /agents felület válik le

A Workot korlátozott feladatkonténerben lévő fájlokhoz használja. A Libre Claw-t szélesebb eszközökhöz, jóváhagyásokhoz, memóriához, célokhoz vagy daemon-automatizálásokhoz.

Architektúra​

A WebUI backendje nem futtat közvetlenül shell- vagy böngészőeszközöket a Libre Claw számára. Hitelesített rendszergazdai kéréseket továbbít, és megjeleníti a daemon állapotát, eseményeit, jóváhagyásait, automatizálásait, használatát és beállítását.

A Libre Claw elindítása​

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

Alapértelmezett vezérlőpult/API:

http://127.0.0.1:8766/dashboard

Ezután nyissa meg a Libre WebUI → Libre Claw oldalt.

Backendkörnyezet​

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

Módosítsa a LIBRE_CLAW_BASE_URL értéket, ha a daemon másik hoston, Tailscale-címen vagy reverse proxy mögött fut.

WebUI-útvonalak​

Mindegyik hitelesített rendszergazdát igényel, mert helyi útvonalakat fedhetnek fel és ügynökmunkát indíthatnak:

WebUI-útvonalFunkció
GET /api/libre-claw/statusDaemon állapota, alap-URL, vezérlőpult URL-je
GET /api/libre-claw/config/modelAktuális szolgáltató/modell
PATCH /api/libre-claw/config/modelSzolgáltató/modell frissítése
GET /api/libre-claw/config/fallbackAktuális fallback
PATCH /api/libre-claw/config/fallbackFallback frissítése
PATCH /api/libre-claw/config/themeVezérlőpult/TUI témája
GET /api/libre-claw/runsTartós futások listája
POST /api/libre-claw/runsChat- vagy goal-futás indítása
GET /api/libre-claw/runs/:idMetaadatok és melléktermékek
GET /api/libre-claw/runs/:id/eventsNövekményes események
POST /api/libre-claw/runs/:id/cancelFutás megszakítása
POST /api/libre-claw/runs/:id/permissions/:toolCallIdEszköz jóváhagyása/elutasítása
GET /api/libre-claw/usageHasználati összefoglaló és rekordok
GET /api/libre-claw/automationsAutomatizálások listája
POST /api/libre-claw/automationsAutomatizálás létrehozása
PATCH /api/libre-claw/automations/:idAutomatizálás frissítése
POST /api/libre-claw/automations/:id/runAzonnali futtatás
POST /api/libre-claw/automations/:id/pauseSzüneteltetés
POST /api/libre-claw/automations/:id/resumeFolytatás
DELETE /api/libre-claw/automations/:idTörlés

Futások indítása​

  • Chat runs — normál ügynökfordulók.
  • Goal runs — korlátozott autopilot, amíg az értékelő befejezi a célt vagy eléri a korlátot.

Az opcionális szolgáltató-/modellfelülírások továbbadódnak a Libre Claw-nak; különben annak alapértékei érvényesek.

Jóváhagyások​

Amikor engedély szükséges, a WebUI megjeleníti az eszközhívást és a lehetőségeket:

  • allow_once
  • deny
  • always_allow_tool

A jogosultsági modell és az ellenőrzések a Libre Claw tulajdonában vannak; a WebUI csak a választást rögzíti a daemon API-ján keresztül.

Automatizálások​

A WebUI Libre Claw-automatizálásokat hoz létre és kezel jelentésekhez és Telegramhoz, szüneteltetéssel/folytatással, azonnali futtatással és törléssel. Ezek daemon-automatizálások, nem a host cron-feladatai; az előzmények a Libre Claw-ban maradnak.

Memória, készségek, Soul és eszközök​

A memória, készségek, soul-fájlok, MCP, böngésző, SearXNG, Petdex és Telegram a Libre Claw-ban állítható be. Hasznos parancsok:

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

Hibaelhárítás​

A WebUI ezt mutatja: "Libre Claw daemon is not connected"​

libre-claw start

vagy:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Az engedélygombok nem működnek​

Lehet, hogy a futás már befejeződött, vagy az engedélyt a vezérlőpulton vagy Telegramon oldották fel. Frissítse az oldalt, és ellenőrizze az idővonalat.

Egy eszközt elutasított a rendszer​

A Libre Claw jogosultságkezelője az irányadó. Ellenőrizze a konfigurációt és az eseményeket.

Az automatizálások nem futnak​

libre-claw status
libre-claw start

A daemonnak futnia kell az ütemezésekhez és a Telegramhoz.

Kapcsolódó dokumentáció​