Intégration de Libre Claw

Libre WebUI comprend une intégration native de Libre Claw, l'environnement local d'agents de Kroonen AI. Libre Claw apparaît comme une surface d'agents de premier plan dans Libre WebUI plutôt que comme une extension générique de fournisseur de complétion.

Libre Claw reste l'environnement d'exécution responsable des puissantes fonctions d'agent :

exécutions durables et journaux d'événements JSONL
outils de fichiers, shell, Git, navigateur, HTTP, recherche web, MCP et planification
demandes d'approbation avant les effets de bord
mémoire persistante et compétences de projet ou d'utilisateur
mode objectif
routes de modèles de secours
rapports d'utilisation
automatisations gérées par le démon et livraison Telegram
tableau de bord local autonome

Libre WebUI communique avec le démon Libre Claw par HTTP et expose ces fonctionnalités dans l'interface WebUI authentifiée habituelle.

Dans l'interface, cette surface s'appelle Agents : l'icône de la barre latérale, la route /agents et l'entrée de la palette de commandes emploient toutes ce nom. Libre Claw est l'environnement d'exécution sous-jacent ; le démon, sa commande et ses variables d'environnement conservent donc leur propre nom tout au long de ce guide.

Libre Claw et Work sont différents

Libre Claw reste un environnement d'exécution externe facultatif. Le mode Work intégré à Libre WebUI n'en dépend pas.

	Work	Libre Claw
Environnement d'exécution	Boucle de modèle et d'outils native de Libre WebUI avec Docker	Démon Libre Claw distinct
Portée principale	Un espace de programmation persistant et isolé par tâche	Exécutions d'agents, mémoire, approbations, planifications, navigateur, MCP et outils
Persistance	Historique de tâche SQLite et volume nommé Docker appartenant à la tâche	Propres espaces d'exécutions et de mémoire de Libre Claw
Routage des modèles	Ollama, Ollama Cloud ou extension de complétion ou de chat Libre WebUI configurée	Configuration du fournisseur, du modèle et des solutions de secours de Libre Claw
Disponibilité sans lui	Work continue de fonctionner normalement	Seule la surface Libre Claw `/agents` est déconnectée

Utilisez Work lorsqu'un modèle doit créer ou modifier des fichiers dans un conteneur restreint propre à une tâche. Utilisez Libre Claw lorsque vous avez besoin de l'ensemble plus vaste d'outils du démon, de son système d'approbation, de sa mémoire, de ses objectifs ou de ses automatisations.

Architecture

Le serveur WebUI n'exécute jamais directement de commandes shell ni d'outils de navigateur pour Libre Claw. Il relaie les requêtes authentifiées des administrateurs au démon local et affiche l'état de ses exécutions, ses événements, ses approbations, ses automatisations, son utilisation et sa configuration.

Démarrer Libre Claw

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

Démarrez le démon :

libre-claw start

Le tableau de bord et l'API par défaut sont disponibles à l'adresse :

http://127.0.0.1:8766/dashboard

Ouvrez ensuite Libre WebUI → Libre Claw.

Environnement du serveur

Libre WebUI utilise par défaut l'URL locale du démon :

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

Définissez LIBRE_CLAW_BASE_URL si le démon s'exécute sur un autre hôte, une adresse IP Tailscale ou un service local placé derrière un proxy inverse.

Routes WebUI

Toutes les routes Libre Claw nécessitent un administrateur authentifié, car elles peuvent révéler des chemins de fichiers locaux et déclencher le travail d'un agent :

Route WebUI	Fonction de Libre Claw
`GET /api/libre-claw/status`	État du démon, URL de base et du tableau de bord
`GET /api/libre-claw/config/model`	Fournisseur et modèle actuels
`PATCH /api/libre-claw/config/model`	Mettre à jour le fournisseur et le modèle
`GET /api/libre-claw/config/fallback`	Route de secours actuelle
`PATCH /api/libre-claw/config/fallback`	Mettre à jour la route de secours
`PATCH /api/libre-claw/config/theme`	Mettre à jour le thème du tableau de bord ou de la TUI
`GET /api/libre-claw/runs`	Répertorier les exécutions durables
`POST /api/libre-claw/runs`	Démarrer une exécution de chat ou en mode objectif
`GET /api/libre-claw/runs/:id`	Métadonnées et artefacts de l'exécution
`GET /api/libre-claw/runs/:id/events`	Événements incrémentiels de l'exécution
`POST /api/libre-claw/runs/:id/cancel`	Annuler une exécution
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Autoriser ou refuser un appel d'outil
`GET /api/libre-claw/usage`	Résumé et relevés d'utilisation
`GET /api/libre-claw/automations`	Répertorier les automatisations planifiées
`POST /api/libre-claw/automations`	Créer une automatisation
`PATCH /api/libre-claw/automations/:id`	Mettre à jour une automatisation
`POST /api/libre-claw/automations/:id/run`	Exécuter une automatisation maintenant
`POST /api/libre-claw/automations/:id/pause`	Suspendre une automatisation
`POST /api/libre-claw/automations/:id/resume`	Reprendre une automatisation
`DELETE /api/libre-claw/automations/:id`	Supprimer une automatisation

Démarrer des exécutions

La page WebUI peut démarrer :

Des exécutions de chat — échanges normaux avec un agent Libre Claw.
Des exécutions d'objectif — mode pilote automatique limité dans lequel Libre Claw continue jusqu'à ce que son juge considère l'objectif atteint ou que la limite configurée soit atteinte.

Les substitutions facultatives de fournisseur ou de modèle sont transmises à Libre Claw pour cette exécution. Si elles sont omises, Libre Claw utilise le fournisseur et le modèle configurés par défaut.

Approbations

Lorsque Libre Claw demande une autorisation, WebUI affiche l'appel d'outil en attente et permet à un administrateur de choisir :

allow_once
deny
always_allow_tool

Libre Claw reste responsable du modèle d'autorisation et des contrôles de sécurité. WebUI ne fait qu'enregistrer le choix de l'administrateur au moyen de l'API du démon.

Automatisations

Libre WebUI peut créer et gérer les automatisations du démon Libre Claw :

automatisations de rapports
automatisations acheminées vers Telegram
suspension et reprise
exécution immédiate
suppression

Il s'agit d'automatisations Libre Claw, et non de tâches cron de l'hôte. Les rapports et l'historique d'exécution restent dans l'espace des exécutions de Libre Claw.

Mémoire, compétences, âme et outils

La mémoire, les compétences, les fichiers d'âme, les outils MCP, les outils de navigateur, SearXNG, Petdex et Telegram sont configurés dans Libre Claw. WebUI affiche et contrôle les fonctionnalités exposées par le démon sans dupliquer le système de configuration interne de Libre Claw.

Commandes Libre Claw utiles :

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

Dépannage

WebUI indique « Le démon Libre Claw n'est pas connecté »

Démarrez le démon :

libre-claw start

Ou définissez l'URL du serveur :

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Les boutons d'autorisation ne font rien

L'exécution est peut-être déjà terminée, ou l'autorisation a pu être résolue depuis une autre surface, comme le tableau de bord Libre Claw ou la passerelle Telegram. Actualisez la page WebUI et inspectez la chronologie de l'exécution.

Un outil a été refusé

Le gestionnaire d'autorisations de Libre Claw fait foi. Consultez la propre configuration de Libre Claw et les événements de l'exécution si un appel est refusé avant que WebUI ne voie une demande d'approbation.

Les automatisations ne s'exécutent pas

Vérifiez l'état du démon Libre Claw et la configuration des automatisations :

libre-claw status
libre-claw start

Le démon doit être en cours d'exécution pour les automatisations planifiées et la livraison Telegram.

Libre Claw et Work sont différents​

Architecture​

Démarrer Libre Claw​

Environnement du serveur​

Routes WebUI​

Démarrer des exécutions​

Approbations​

Automatisations​

Mémoire, compétences, âme et outils​

Dépannage​

WebUI indique « Le démon Libre Claw n'est pas connecté »​

Les boutons d'autorisation ne font rien​

Un outil a été refusé​

Les automatisations ne s'exécutent pas​

Documentation connexe​