CLI и эксплуатация
CLI нужен для первичной настройки, локального общения с Велесом, запуска сервера, OAuth-входа, диагностики каналов и эксплуатации в Docker/systemd.Основные команды
Onboard
onboard предлагает:
- перезаписать значения по умолчанию;
- обновить конфигурацию, сохранив существующие значения и добавив новые поля.
Локальный чат
Одно сообщение:Сервер Велеса
- цикл обработки сообщений Велеса;
- HTTP API и внутренние вызовы;
- управление каналами;
- службу расписаний;
- службу периодических проверок;
- подключения MCP.
Статус
- путь к конфигурации;
- рабочую область;
- модель по умолчанию;
- состояние ключей API, OAuth и локальных провайдеров.
Уплотнение базы векторной памяти
Обычная очистка индекса делает освобождённые страницы доступными для повторного использования, но файлmemory/vector.db обычно не становится меньше. Для физического уплотнения используйте отдельную команду.
Сначала остановите veles gateway и все процессы veles agent, которые используют эту рабочую область. При запуске с --yes команда проверяет межпроцессную блокировку владельца и отказывается работать, если индекс открыт другим процессом этой версии. Старая версия Велеса такую блокировку не создаёт, поэтому остановка всех процессов остаётся обязательной. Не обходите проверку и не запускайте Велес до завершения операции.
Без --yes команда только показывает план и не меняет базу:
- после получения блокировки выполняет контрольную точку WAL, чтобы ожидающие записи вошли в стабильный снимок исходной базы;
- создаёт свежую теневую базу на той же файловой системе;
- копирует только живые файлы и фрагменты индекса;
- переносит достоверные старые JSON-векторы в двоичное хранилище; исторические нулевые заглушки считаются отсутствующими смысловыми данными, но их фрагменты остаются в полнотекстовом поиске;
- заново строит полнотекстовый индекс и проверяет целостность результата;
- заменяет активную базу атомарно только после всех проверок.
memory одновременно могут находиться исходная, теневая и резервная базы.
После успеха в memory всегда остаётся байт-в-байт резервная копия с отметкой времени; команда не удаляет её автоматически. Поэтому активный vector.db становится меньше, но общий занятый объём не освобождается. Сначала запустите Велес, проверьте известные запросы поиска и сохраните внешнюю копию. Только после этого резервный файл можно вручную переместить на другой носитель или удалить.
OAuth
VELES_SECRETS_MASTER_KEY. Сгенерировать:
Каналы
channels login нужен для сценариев с мостом вроде WhatsApp. Для Telegram обычно достаточно токена в конфигурации и запущенного сервера.
Периодические проверки
Периодическая проверка читаетHEARTBEAT.md в рабочей области и выполняет задачи через обычный цикл Велеса.
Пример:
Docker Compose
Docker
~/.veles сохраняет конфигурацию, рабочую область, служебное состояние и зашифрованные секреты между запусками.