Интеграция Libre Claw

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

Libre Claw остаётся средой, управляющей мощным поведением агента:

постоянные выполнения и журналы JSONL
инструменты файлов, shell, 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 или плагин completions/chat Libre WebUI	Конфигурация поставщика, модели и fallback Libre Claw
Без среды	Work работает нормально	Отключён только интерфейс `/agents` Libre Claw

Используйте Work, когда модель должна менять файлы в ограниченном контейнере задачи. Libre Claw выбирайте для широкого набора инструментов демона, согласований, памяти, целей и автоматизаций.

Архитектура

Бэкенд WebUI никогда не запускает команды shell или браузерные инструменты 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 по умолчанию использует локальный URL демона:

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

Задайте LIBRE_CLAW_BASE_URL, если демон работает на другом хосте, IP Tailscale или за локальным reverse proxy.

Маршруты WebUI

Все маршруты Libre Claw требуют аутентифицированного администратора, поскольку могут раскрывать локальные пути и запускать работу:

Маршрут WebUI	Функция Libre Claw
`GET /api/libre-claw/status`	Состояние демона, базовый URL и URL панели
`GET /api/libre-claw/config/model`	Текущий поставщик/модель
`PATCH /api/libre-claw/config/model`	Обновление поставщика/модели
`GET /api/libre-claw/config/fallback`	Текущий fallback-маршрут
`PATCH /api/libre-claw/config/fallback`	Обновление 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.
Выполнения цели — ограниченный autopilot, продолжающийся до признания цели завершённой или достижения лимита.

Необязательные переопределения поставщика/модели передаются 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

Или задайте URL:

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"​

Кнопки разрешения не работают​

Инструмент запрещён​

Автоматизации не выполняются​

Связанная документация​