Integrazione di Libre Claw

Libre WebUI include un'integrazione nativa per Libre Claw, l'ambiente di esecuzione locale per agenti di Kroonen AI. Libre Claw viene presentato come interfaccia per agenti di prima classe all'interno di Libre WebUI, non come un generico plugin per provider di completamento.

Libre Claw rimane il runtime a cui appartiene il potente comportamento dell'agente:

esecuzioni durature e log eventi JSONL
strumenti per file, shell, Git, browser, HTTP, ricerca web, MCP e pianificazione
richieste di approvazione prima degli effetti collaterali
memoria persistente e competenze di progetto/utente
modalità obiettivo
percorsi di modelli alternativi
rapporti sull'utilizzo
automazioni gestite dal daemon e consegna tramite Telegram
dashboard locale autonoma

Libre WebUI comunica con il daemon Libre Claw via HTTP ed espone queste funzionalità all'interno della normale shell WebUI autenticata.

Nell'interfaccia, questa sezione si chiama Agenti: l'icona nella barra laterale, il percorso /agents e la voce nella tavolozza dei comandi usano tutti questo nome. Libre Claw è il runtime sottostante, quindi daemon, comando e variabili d'ambiente mantengono il proprio nome in tutta la guida.

Libre Claw e Work sono differenti

Libre Claw rimane un runtime esterno facoltativo. Non è necessario per la modalità Work integrata in Libre WebUI.

	Work	Libre Claw
Runtime	Ciclo modello/strumenti nativo di Libre WebUI più Docker	Daemon Libre Claw separato
Ambito principale	Un'area di lavoro di programmazione persistente e isolata per attività	Esecuzioni di agenti, memoria, approvazioni, pianificazioni, browser, MCP e strumenti
Persistenza	Cronologia attività SQLite e volume Docker con nome dell'attività	Archivi di esecuzioni e memoria propri di Libre Claw
Instradamento modelli	Ollama, Ollama Cloud o plugin Libre WebUI configurato per completamento/chat	Configurazione di provider, modello e alternative di Libre Claw
Disponibilità senza	Work continua a funzionare normalmente	Solo l'interfaccia Libre Claw `/agents` risulta disconnessa

Usa Work quando un modello deve creare o modificare file in un container limitato e specifico per l'attività. Usa Libre Claw quando servono l'insieme più ampio di strumenti del daemon, il sistema di approvazione, la memoria, gli obiettivi o le automazioni.

Architettura

Il backend WebUI non esegue mai direttamente comandi shell o strumenti del browser per Libre Claw. Inoltra le richieste autenticate degli amministratori al daemon locale e visualizza stato dell'esecuzione, eventi, approvazioni, automazioni, utilizzo e configurazione del daemon.

Avviare Libre Claw

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

Avvia il daemon:

libre-claw start

La dashboard e l'API predefinite sono disponibili all'indirizzo:

http://127.0.0.1:8766/dashboard

Quindi apri Libre WebUI → Libre Claw.

Ambiente del backend

Per impostazione predefinita, Libre WebUI usa l'URL del daemon locale:

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

Imposta LIBRE_CLAW_BASE_URL se il daemon viene eseguito su un altro host, un IP Tailscale o un servizio locale dietro proxy inverso.

Percorsi WebUI

Tutti i percorsi Libre Claw richiedono un utente amministratore autenticato, perché possono rivelare percorsi di file locali e avviare attività dell'agente:

Percorso WebUI	Funzionalità Libre Claw
`GET /api/libre-claw/status`	Stato daemon, URL base e URL dashboard
`GET /api/libre-claw/config/model`	Provider/modello corrente
`PATCH /api/libre-claw/config/model`	Aggiornamento di provider/modello
`GET /api/libre-claw/config/fallback`	Percorso alternativo corrente
`PATCH /api/libre-claw/config/fallback`	Aggiornamento del percorso alternativo
`PATCH /api/libre-claw/config/theme`	Aggiornamento del tema dashboard/TUI
`GET /api/libre-claw/runs`	Elenco delle esecuzioni durature
`POST /api/libre-claw/runs`	Avvio di una chat o esecuzione in modalità obiettivo
`GET /api/libre-claw/runs/:id`	Metadati e artefatti dell'esecuzione
`GET /api/libre-claw/runs/:id/events`	Eventi incrementali dell'esecuzione
`POST /api/libre-claw/runs/:id/cancel`	Annullamento di un'esecuzione
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Approvazione o rifiuto di una chiamata a strumento
`GET /api/libre-claw/usage`	Riepilogo e record dell'utilizzo
`GET /api/libre-claw/automations`	Elenco delle automazioni pianificate
`POST /api/libre-claw/automations`	Creazione di un'automazione
`PATCH /api/libre-claw/automations/:id`	Aggiornamento di un'automazione
`POST /api/libre-claw/automations/:id/run`	Esecuzione immediata di un'automazione
`POST /api/libre-claw/automations/:id/pause`	Sospensione di un'automazione
`POST /api/libre-claw/automations/:id/resume`	Ripresa di un'automazione
`DELETE /api/libre-claw/automations/:id`	Eliminazione di un'automazione

Avviare le esecuzioni

La pagina WebUI può avviare:

Esecuzioni chat — normali turni dell'agente Libre Claw.
Esecuzioni obiettivo — modalità autopilota limitata in cui Libre Claw continua finché il suo valutatore non contrassegna l'obiettivo come completato o finché non raggiunge il limite configurato.

Gli override facoltativi di provider/modello vengono trasmessi a Libre Claw per quell'esecuzione. Se omessi, Libre Claw usa il provider e il modello predefiniti configurati.

Approvazioni

Quando Libre Claw chiede un'autorizzazione, WebUI mostra la chiamata allo strumento in sospeso e consente a un amministratore di scegliere:

allow_once
deny
always_allow_tool

Libre Claw mantiene la titolarità del modello di autorizzazione e dei controlli di sicurezza. WebUI registra soltanto la scelta dell'amministratore tramite l'API del daemon.

Automazioni

Libre WebUI può creare e gestire le automazioni del daemon Libre Claw:

automazioni per rapporti
automazioni indirizzate a Telegram
sospensione/ripresa
esecuzione immediata
eliminazione

Si tratta di automazioni Libre Claw, non di job cron dell'host. I rapporti e la cronologia di esecuzione rimangono nell'archivio delle esecuzioni di Libre Claw.

Memoria, competenze, anima e strumenti

Memoria, competenze, file dell'anima, strumenti MCP, strumenti del browser, SearXNG, Petdex e Telegram vengono configurati direttamente in Libre Claw. WebUI visualizza e controlla le funzionalità esposte dal daemon senza duplicare il sistema di configurazione interno di Libre Claw.

Comandi utili di Libre Claw:

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

Risoluzione dei problemi

WebUI mostra "Il daemon Libre Claw non è connesso"

Avvia il daemon:

libre-claw start

Oppure imposta l'URL del backend:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

I pulsanti di autorizzazione non fanno nulla

L'esecuzione potrebbe essere già terminata oppure l'autorizzazione potrebbe essere stata risolta da un'altra interfaccia, come la dashboard Libre Claw o il bridge Telegram. Aggiorna la pagina WebUI ed esamina la sequenza temporale dell'esecuzione.

Uno strumento è stato rifiutato

Il gestore delle autorizzazioni di Libre Claw è l'autorità. Controlla la configurazione di Libre Claw e gli eventi dell'esecuzione se una chiamata viene negata prima che WebUI mostri una richiesta di approvazione.

Le automazioni non vengono eseguite

Controlla lo stato del daemon Libre Claw e la configurazione delle automazioni:

libre-claw status
libre-claw start

Il daemon deve essere in esecuzione per le automazioni pianificate e la consegna tramite Telegram.

Libre Claw e Work sono differenti​

Architettura​

Avviare Libre Claw​

Ambiente del backend​

Percorsi WebUI​

Avviare le esecuzioni​

Approvazioni​

Automazioni​

Memoria, competenze, anima e strumenti​

Risoluzione dei problemi​

WebUI mostra "Il daemon Libre Claw non è connesso"​

I pulsanti di autorizzazione non fanno nulla​

Uno strumento è stato rifiutato​

Le automazioni non vengono eseguite​

Documenti correlati​