Інтеграція Libre Claw

Libre WebUI містить вбудовану інтеграцію з Libre Claw, локальним агентним середовищем Kroonen AI. Libre Claw представлено в Libre WebUI як повноцінний інтерфейс агентів, а не універсальний плагін постачальника доповнень.

Libre Claw залишається середовищем, що керує потужною поведінкою агента:

постійні виконання й журнали JSONL
інструменти файлів, оболонки, Git, браузера, HTTP, вебпошуку, MCP і розкладів
запити погодження до побічних наслідків
постійна пам’ять і навички проєкту/користувача
режим мети
запасні маршрути моделей
звіти про використання
автоматизації демона й доставка Telegram
окрема локальна панель

Libre WebUI спілкується з демоном Libre Claw через HTTP і надає функції у звичайній автентифікованій оболонці WebUI.

В інтерфейсі цей розділ називається Agents — піктограма бічної панелі, маршрут /agents і команда палітри використовують цю назву. Libre Claw є середовищем за ним, тому демон, команда й змінні зберігають власну назву.

Libre Claw і Work відрізняються

Libre Claw залишається необов’язковим зовнішнім середовищем. Воно не потрібне вбудованому режиму Work Libre WebUI.

	Work	Libre Claw
Середовище	Вбудований цикл моделі/інструментів Libre WebUI і Docker	Окремий демон Libre Claw
Основне охоплення	Один постійний ізольований простір програмування на завдання	Ширші виконання, пам’ять, погодження, розклади, браузер, MCP та інструменти
Постійність	Історія SQLite й іменований том Docker завдання	Власні сховища виконань і пам’яті Libre Claw
Маршрутизація	Ollama, Ollama Cloud або плагін доповнень/чату Libre WebUI	Конфігурація постачальника, моделі й запасного маршруту Libre Claw
Без середовища	Work працює нормально	Від’єднано лише інтерфейс `/agents` Libre Claw

Використовуйте Work, коли модель має змінювати файли в обмеженому контейнері завдання. Libre Claw вибирайте для ширшого набору інструментів демона, погоджень, пам’яті, цілей і автоматизацій.

Архітектура

Серверна частина WebUI ніколи не запускає команди оболонки чи браузерні інструменти Libre Claw безпосередньо. Вона передає автентифіковані запити адміністратора локальному демону й показує стани, події, погодження, автоматизації, використання та конфігурацію.

Запуск Libre Claw

Установіть 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]"

Запустіть демон:

libre-claw start

Панель і API типово доступні за адресою:

http://127.0.0.1:8766/dashboard

Потім відкрийте Libre WebUI → Libre Claw.

Середовище серверної частини

Libre WebUI типово використовує локальну адресу демона:

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

Задайте LIBRE_CLAW_BASE_URL, якщо демон працює на іншому хості, IP Tailscale або за локальним зворотним проксі.

Маршрути WebUI

Усі маршрути Libre Claw потребують автентифікованого адміністратора, оскільки можуть розкривати локальні шляхи й запускати роботу:

Маршрут WebUI	Функція Libre Claw
`GET /api/libre-claw/status`	Стан демона, базова адреса й адреса панелі
`GET /api/libre-claw/config/model`	Поточний постачальник/модель
`PATCH /api/libre-claw/config/model`	Оновлення постачальника/моделі
`GET /api/libre-claw/config/fallback`	Поточний запасний маршрут
`PATCH /api/libre-claw/config/fallback`	Оновлення запасного маршруту
`PATCH /api/libre-claw/config/theme`	Оновлення теми панелі/TUI
`GET /api/libre-claw/runs`	Список постійних виконань
`POST /api/libre-claw/runs`	Запуск чату або режиму мети
`GET /api/libre-claw/runs/:id`	Метадані й артефакти виконання
`GET /api/libre-claw/runs/:id/events`	Послідовні події виконання
`POST /api/libre-claw/runs/:id/cancel`	Скасування виконання
`POST /api/libre-claw/runs/:id/permissions/:toolCallId`	Дозвіл або заборона виклику
`GET /api/libre-claw/usage`	Зведення й записи використання
`GET /api/libre-claw/automations`	Список автоматизацій
`POST /api/libre-claw/automations`	Створення автоматизації
`PATCH /api/libre-claw/automations/:id`	Оновлення автоматизації
`POST /api/libre-claw/automations/:id/run`	Запуск зараз
`POST /api/libre-claw/automations/:id/pause`	Призупинення
`POST /api/libre-claw/automations/:id/resume`	Відновлення
`DELETE /api/libre-claw/automations/:id`	Видалення

Запуск виконань

Сторінка WebUI запускає:

Виконання чату — звичайні ходи агента Libre Claw.
Виконання мети — обмежений автоматичний режим, що триває до визнання мети завершеною або досягнення ліміту.

Необов’язкові перевизначення постачальника/моделі передаються Libre Claw для цього виконання. Без них застосовуються налаштовані типові значення.

Погодження

Коли Libre Claw запитує дозвіл, WebUI показує очікуваний виклик і дає адміністратору вибрати:

allow_once
deny
always_allow_tool

Libre Claw керує моделлю дозволів і перевірками. WebUI лише передає вибір через API демона.

Автоматизації

Libre WebUI може створювати й керувати автоматизаціями демона:

звіти
доставка Telegram
призупинення/відновлення
негайний запуск
видалення

Це автоматизації Libre Claw, а не завдання cron хоста. Звіти й історія залишаються у сховищі Libre Claw.

Пам’ять, навички, soul та інструменти

Пам’ять, навички, файли soul, MCP, браузер, SearXNG, Petdex і Telegram налаштовуються в Libre Claw. WebUI показує й керує функціями демона, не дублюючи його конфігурацію.

Корисні команди:

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

Усунення неполадок

WebUI показує "Libre Claw daemon is not connected"

Запустіть демон:

libre-claw start

Або задайте адресу:

LIBRE_CLAW_BASE_URL=http://127.0.0.1:8766

Кнопки дозволу не працюють

Виконання могло завершитися або дозвіл було надано в іншому інтерфейсі, наприклад панелі Libre Claw чи мосту Telegram. Оновіть сторінку й перевірте часову шкалу.

Інструмент заборонено

Менеджер дозволів Libre Claw є остаточним. Якщо виклик заборонено до появи запиту в WebUI, перевірте конфігурацію й події Libre Claw.

Автоматизації не виконуються

Перевірте демон і конфігурацію:

libre-claw status
libre-claw start

Для розкладів і Telegram демон має працювати.

Libre Claw і Work відрізняються​

Архітектура​

Запуск Libre Claw​

Середовище серверної частини​

Маршрути WebUI​

Запуск виконань​

Погодження​

Автоматизації​

Пам’ять, навички, soul та інструменти​

Усунення неполадок​

WebUI показує "Libre Claw daemon is not connected"​

Кнопки дозволу не працюють​

Інструмент заборонено​

Автоматизації не виконуються​

Пов’язана документація​