Диагностика и частые вопросы
Эта страница помогает быстро вернуть Велес в рабочее состояние. Сначала найдите симптом в таблице, затем при необходимости пройдите набор диагностических команд по порядку.Правило большого пальца: пока Велес не отвечает на простое сообщение из командной строки (
veles agent -m "привет"), не добавляйте новые каналы, навыки и интеграции — сначала почините базовый чат.Частые симптомы и решения
| Симптом | Вероятная причина | Что сделать |
|---|---|---|
veles gateway не запускается и сразу завершается | Не задан gateway.token | Добавьте gateway.token в config.json (длинная случайная строка) или задайте VELES_GATEWAY_TOKEN. |
| Интерфейс Велеса показывает «не подключено» | Сервер не запущен, неверный токен или порт | Проверьте, что veles gateway запущен; сверьте порт и токен интерфейса с config.json. |
| Велес не отвечает, ошибка про модель/провайдера | Нет ключа доступа или модели по умолчанию | Проверьте veles status; задайте providers.*.apiKey и agents.defaults.model. |
| Ответ обрывается или приходит ошибка с токенами | Превышен лимит контекста или баланс провайдера | Начните новую сессию; проверьте баланс (openrouter.balance / кабинет провайдера). |
| Вход через Codex не сохраняется | Не задан главный ключ секретов | Сгенерируйте veles secrets generate-key и задайте VELES_SECRETS_MASTER_KEY. |
| Telegram молчит | Сервер не запущен или нет токена бота | Запустите veles gateway; проверьте токен бота в конфигурации; см. veles channels status. |
| WhatsApp/мостовой канал не подключается | Не выполнен вход моста | Выполните veles channels login и проверьте veles channels status. |
| Два сервера конфликтуют | Одинаковый порт у разных экземпляров | Запускайте каждый экземпляр с уникальным --port. |
| Изменили секрет, но Велес его не видит | Секреты времени работы не перечитаны | Вызовите secrets.refresh (в интерфейсе — обновление секретов) или перезапустите сервер. |
| Голосовое сообщение «зависло» на телефоне | Приложение ушло в фон до доставки | Дождитесь появления сообщения в истории; не отправляйте повторно — проверьте сессию. |
Набор диагностических команд
Проходите по порядку — каждая следующая команда сужает область поиска:veles status показывает корректную модель и ключи, но veles agent всё равно не отвечает — проблема на стороне провайдера (ключ, баланс, доступность модели). Если чат из командной строки работает, а интерфейс нет — проблема в подключении интерфейса к серверу (токен, порт, запущен ли veles gateway).
Что проверять при проблемах с интерфейсом
- Сервер запущен:
veles gateway(илиsystemctl --user status veles-gateway). - Порт совпадает: интерфейс подключается к тому же
gateway.port. - Токен совпадает: интерфейс использует тот же
gateway.token. GET /healthотвечает;GET /statusс токеном возвращает статус.- В логах сервера нет ошибок авторизации (
Unauthorized, код-32001).
Частые вопросы
Нужен ли интернет для работы Велеса? Зависит от модели. Для облачных провайдеров (OpenRouter, OpenAI и т.п.) — да. С локальной моделью базовый чат работает офлайн, но веб-поиск, MCP и часть навыков требуют сети. См. Провайдеры и модели. Где хранятся мои данные? В рабочей области и каталоге~/.veles (конфигурация, память, служебное состояние, зашифрованные секреты). В Docker монтируйте ~/.veles, чтобы данные переживали перезапуск контейнера.
Можно ли запустить несколько независимых Велесов?
Да. Используйте отдельные --config, рабочие области и порты. См. Установка и первый запуск.
Как безопасно хранить ключи и токены?
Через панель секретов и зашифрованное хранилище, а не в сообщениях чата. См. Секреты и токены.
Почему Велес «забыл» то, что я говорил раньше?
Контекст одной сессии ограничен. Устойчивые факты и правила нужно явно сохранять в память. См. Память Велеса.
Изменил конфигурацию — нужно ли перезапускать сервер?
Секреты можно перечитать на лету (secrets.refresh). Изменения структуры конфигурации (порты, каналы, провайдеры) надёжнее применять перезапуском veles gateway.