Перейти к основному содержимому

Open Webui VibeOS

Подключите Open WebUI к VibeOS через API-сервер.

Метаданные навыка​

ИсточникВстроенный (устанавливается по умолчанию)
Путьskills/devops/open-webui-vibeos
Версия1.0.0
АвторVibeOS
ЛицензияMIT
Платформыlinux, macos
Тегиopen-webui, api, frontend, automation
Связанные навыкиvibeos-api-automation, cursor-capabilities-bridge

Справочно: полный SKILL.md​

к сведению

Ниже приведено полное описание навыка, которое VibeOS загружает при его активации. Агент видит эти инструкции, когда навык активен.

Open WebUI + VibeOS

Подключите Open WebUI к API-серверу VibeOS для получения удобного интерфейса чата. Предпочтительно использовать встроенный скрипт начальной настройки, а не ручной Docker, если пользователь не запросит контейнеры.

Когда использовать​

  • Пользователь хочет фронтенд в стиле Open WebUI / LobeChat поверх VibeOS
  • После включения API_SERVER_* и необходимости в браузерном интерфейсе

Предварительные требования​

  • Клон репозитория со скриптом scripts/setup_open_webui.sh
  • Или вручную: API_SERVER_ENABLED=true + API_SERVER_KEY в ~/.vibeos/.env
  • Запущенный шлюз (vibeos gateway)

Как запустить​

Однокомандная начальная настройка (рекомендуется):

cd /path/to/VibeOS
bash scripts/setup_open_webui.sh

Ручная проверка:

vibeos api health
# Укажите в Open WebUI подключение по адресу http://127.0.0.1:8642/v1
# API-ключ = значение API_SERVER_KEY

Скриптовым агентам следует использовать vibeos api (см. vibeos-api-automation) вместо управления браузером Open WebUI.

Краткая справка​

КомпонентПо умолчанию
VibeOS APIhttp://127.0.0.1:8642/v1
Open WebUIhttp://127.0.0.1:8080
Документацияwebsite/docs/user-guide/messaging/open-webui.md
Начальная настройкаscripts/setup_open_webui.sh
CLI-клиент`vibeos api chat

Порядок действий​

  1. Убедитесь, что флаги окружения API-сервера установлены (скрипт делает это).
  2. Перезапустите шлюз, чтобы начал слушать порт :8642.
  3. Установите/запустите Open WebUI с помощью скрипта-запускателя.
  4. В Open WebUI → подключения: базовый URL /v1, bearer = API_SERVER_KEY.
  5. Проверьте коротким чатом; инструменты выполняются на хосте API-сервера.

Подводные камни​

  • Документация, где всё ещё указано ~/.vibeos/vibeos-agent — используйте путь из этого репозитория / ~/.vibeos
  • CORS не требуется для сервер-серверного Open WebUI
  • Для нескольких профилей нужен отдельный API_SERVER_PORT для каждого профиля
  • Вкладка API Runs на панели управления (vibeos-runs-inspector) предназначена для операций, а не для второго чата

Проверка​

  • vibeos api health → 200
  • Open WebUI загружает модель и возвращает ответ
  • Опционально: панель управления → API Runs показывает запуски, созданные через vibeos api run