Skip to main content

CLI и эксплуатация

CLI нужен для первичной настройки, локального общения с Велесом, запуска сервера, OAuth-входа, диагностики каналов и эксплуатации в Docker/systemd.

Основные команды

Onboard

Если файл конфигурации уже существует, обычный onboard предлагает:
  • перезаписать значения по умолчанию;
  • обновить конфигурацию, сохранив существующие значения и добавив новые поля.

Локальный чат

Одно сообщение:
Интерактивно:
С отдельной сессией:
С отдельной рабочей областью или конфигурацией:
Флаги вывода:

Сервер Велеса

Сервер запускает:
  • цикл обработки сообщений Велеса;
  • HTTP API и внутренние вызовы;
  • управление каналами;
  • службу расписаний;
  • службу периодических проверок;
  • подключения MCP.
При остановке сервер закрывает MCP, каналы, расписания, периодические проверки и сохраняет ожидающие сессии на диск.

Статус

Команда показывает:
  • путь к конфигурации;
  • рабочую область;
  • модель по умолчанию;
  • состояние ключей API, OAuth и локальных провайдеров.

OAuth

Для Codex с зашифрованным хранилищем нужен VELES_SECRETS_MASTER_KEY. Сгенерировать:

Каналы

channels login нужен для сценариев с мостом вроде WhatsApp. Для Telegram обычно достаточно токена в конфигурации и запущенного сервера.

Периодические проверки

Периодическая проверка читает HEARTBEAT.md в рабочей области и выполняет задачи через обычный цикл Велеса. Пример:
Сервер должен быть запущен, а Велес должен знать последний активный внешний канал, куда доставлять результат.

Docker Compose

Docker

Монтирование ~/.veles сохраняет конфигурацию, рабочую область, служебное состояние и зашифрованные секреты между запусками.

Пользовательская служба systemd

Минимальный unit:
Команды: