> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Диагностика и частые вопросы
> Что делать, когда Велес не запускается, интерфейс не подключается, модель не отвечает или каналы молчат. Таблица симптомов, набор диагностических команд и частые вопросы.
# Диагностика и частые вопросы
Эта страница помогает быстро вернуть Велес в рабочее состояние. Сначала найдите симптом в таблице, затем при необходимости пройдите набор диагностических команд по порядку.
Правило большого пальца: пока Велес не отвечает на простое сообщение из командной строки (`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`. |
| Ответ обрывается или приходит ошибка с токенами | Превышен лимит контекста или баланс поставщика | Начните новую сессию; откройте панель «Баланс» (`providers.usage`) или кабинет поставщика. |
| Вход через 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` (в интерфейсе — обновление секретов) или перезапустите сервер. |
| Голосовое сообщение «зависло» на телефоне | Приложение ушло в фон до доставки | Дождитесь появления сообщения в истории; не отправляйте повторно — проверьте сессию. |
## Набор диагностических команд
Проходите по порядку — каждая следующая команда сужает область поиска:
```bash theme={null}
# 1. Конфигурация, рабочая область, модель и провайдеры
veles status
# 2. Базовый чат без интерфейса и каналов
veles agent -m "Кратко проверь, что ты работаешь"
# 3. Запуск сервера с подробными логами
veles gateway --verbose
# 4. Состояние каналов (Telegram, мосты)
veles channels status
# 5. Встроенные каналы и каналы-расширения
veles plugins list
# 6. Доступность сервера по HTTP (токен не нужен)
curl -s http://127.0.0.1:18790/health
curl -s -H "Authorization: Bearer " http://127.0.0.1:18790/status
```
Если `veles status` показывает корректную модель и ключи, но `veles agent` всё равно не отвечает — проблема на стороне провайдера (ключ, баланс, доступность модели). Если чат из командной строки работает, а интерфейс нет — проблема в подключении интерфейса к серверу (токен, порт, запущен ли `veles gateway`).
## Что проверять при проблемах с интерфейсом
1. Сервер запущен: `veles gateway` (или `systemctl --user status veles-gateway`).
2. Порт совпадает: интерфейс подключается к тому же `gateway.port`.
3. Токен совпадает: интерфейс использует тот же `gateway.token`.
4. `GET /health` отвечает; `GET /status` с токеном возвращает статус.
5. В логах сервера нет ошибок авторизации (`Unauthorized`, код `-32001`).
Подробности контракта подключения и кодов ошибок — на странице [API](/developers/backend_ru).
## Частые вопросы
**Нужен ли интернет для работы Велеса?**
Зависит от модели. Для облачных провайдеров (OpenRouter, OpenAI и т.п.) — да. С локальной моделью базовый чат работает офлайн, но веб-поиск, MCP и часть навыков требуют сети. См. [Провайдеры и модели](/providers_ru).
**Где хранятся мои данные?**
В рабочей области и каталоге `~/.veles` (конфигурация, память, служебное состояние, зашифрованные секреты). В Docker монтируйте `~/.veles`, чтобы данные переживали перезапуск контейнера.
**Можно ли запустить несколько независимых Велесов?**
Да. Используйте отдельные `--config`, рабочие области и порты. См. [Установка и первый запуск](/setup_ru).
**Как безопасно хранить ключи и токены?**
Через панель секретов и зашифрованное хранилище, а не в сообщениях чата. См. [Секреты и токены](/basics/secrets_ru).
**Почему Велес «забыл» то, что я говорил раньше?**
Контекст одной сессии ограничен. Устойчивые факты и правила нужно явно сохранять в память. См. [Память Велеса](/basics/memory_ru).
**Изменил конфигурацию — нужно ли перезапускать сервер?**
Секреты можно перечитать на лету (`secrets.refresh`). Изменения структуры конфигурации (порты, каналы, провайдеры) надёжнее применять перезапуском `veles gateway`.
## Что читать дальше
* [Установка и первый запуск](/setup_ru)
* [Командная строка и эксплуатация](/cli_operations_ru)
* [Провайдеры и модели](/providers_ru)
* [Восстановление Nerve на iPad](/troubleshooting/nerve_ipad_pwa_recovery_ru)
* [API](/developers/backend_ru)