> ## 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.

# Велес для продвинутого пользователя

> Как настраивать Велес: модели, рабочие области, инструменты, навыки, секреты, каналы и несколько экземпляров.

# Велес для продвинутого пользователя

Эта страница для тех, кто уже пользуется Велесом и хочет глубже настроить его под свои задачи: выбрать модели, разделить рабочие области, подключить каналы, управлять секретами, включить дополнительные инструменты и запускать несколько независимых экземпляров.

## Что можно настраивать

| Область         | Что меняется                                                                        |
| --------------- | ----------------------------------------------------------------------------------- |
| Модели          | модель по умолчанию, список моделей в интерфейсе, уровень рассуждения               |
| Рабочие области | отдельные папки для проектов, команд или окружений                                  |
| Инструменты     | доступ к файлам, командной строке, веб-поиску, документам и внешним сервисам        |
| Навыки          | готовые сценарии работы для исследований, GitHub, памяти, расписаний и других задач |
| Секреты         | ключи API, токены и OAuth-подключения без передачи значений в чат                   |
| Каналы          | веб-чат, Telegram, почта, мессенджеры и другие интеграции                           |
| Фоновые задачи  | напоминания, периодические проверки и heartbeat-задачи                              |

## Конфигурация и рабочие области

По умолчанию Велес использует файл:

```text theme={null}
~/.veles/config.json
```

Имя каталога осталось техническим наследием. В пользовательской документации продукт называется Велесом, но команды и пути пока используют `veles`.

Рабочая область задаётся в конфигурации:

```json theme={null}
{
  "agents": {
    "defaults": {
      "workspace": "~/.veles/workspace"
    }
  }
}
```

Практические рекомендации:

* создавайте отдельную рабочую область для каждого проекта;
* не смешивайте личную память и память рабочего проекта;
* для экспериментов используйте отдельный файл конфигурации;
* не храните секреты в файлах рабочей области.

## Модели

Модель по умолчанию и список моделей для переключателя задаются в `agents.defaults`:

```json theme={null}
{
  "agents": {
    "defaults": {
      "model": "openrouter/openai/gpt-5.4",
      "models": [
        { "id": "openrouter/openai/gpt-5.4", "label": "GPT 5.4" },
        { "id": "openrouter/anthropic/claude-sonnet-4-6", "label": "Claude Sonnet" }
      ],
      "reasoningEffort": "medium"
    }
  }
}
```

Если пользователю нужно часто переключаться между моделями, добавьте их в `models`; тогда они появятся в интерфейсе Велеса.

Подробнее: [Провайдеры и модели](/providers_ru).

## Несколько экземпляров

Отдельные экземпляры нужны, когда вы хотите изолировать проекты, команды или каналы.

```bash theme={null}
veles onboard --config ~/.veles-work/config.json --workspace ~/.veles-work/workspace
veles gateway --config ~/.veles-work/config.json --port 18791
```

Правила:

* у каждого экземпляра должен быть свой `config.json`;
* у каждого рабочего проекта должна быть своя рабочая область;
* если несколько экземпляров работают одновременно, используйте разные порты;
* фоновые задачи и служебные файлы привязаны к выбранной конфигурации и рабочей области.

## Инструменты и ограничения

Велес может читать и писать файлы, искать в интернете, работать с документами, запускать команды и подключать внешние инструменты.

Для постоянной установки включайте ограничение рабочей области:

```json theme={null}
{
  "tools": {
    "restrictToWorkspace": true
  }
}
```

Если запуск команд не нужен, отключите его:

```json theme={null}
{
  "tools": {
    "exec": {
      "enable": false
    }
  }
}
```

Подробнее: [Инструменты, веб-поиск и MCP](/dive-deeper/tools_web_mcp_ru).

## Секреты

Секреты не нужно вставлять в чат или хранить в обычном тексте. Для локального зашифрованного хранилища сгенерируйте ключ:

```bash theme={null}
veles secrets generate-key
```

Затем передайте `VELES_SECRETS_MASTER_KEY` процессу Велеса. Ключ должен быть только на стороне сервера, не в браузере.

Подробнее: [Секреты и токены](/basics/secrets_ru).

## Каналы

Канал — это способ доставить сообщение в Велес: веб-чат, Telegram, почта, мессенджер или собственная интеграция.

Для внешних каналов обязательно настройте список разрешённых отправителей:

```json theme={null}
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "BOT_TOKEN",
      "allowFrom": ["USER_ID"]
    }
  }
}
```

Пустой `allowFrom` запрещает всех. `["*"]` разрешает всех и подходит только для осознанно публичных установок.

Подробнее: [Каналы и интеграции](/channels_ru).

## Подспециалисты и сессии

Велес умеет вести несколько сессий и запускать подспециалистов для независимых частей задачи. Подспециалисты полезны для параллельного исследования, проверки или подготовки отдельного результата.

Не стоит запускать подВелеса для шага, без которого основной диалог не может продолжаться прямо сейчас. В таком случае лучше выполнить работу в текущей сессии.

## Эксплуатационная карта

| Задача                        | Где читать                                                                |
| ----------------------------- | ------------------------------------------------------------------------- |
| Первый запуск                 | [Установка и первый запуск](/setup_ru)                                    |
| Настроить конфигурацию        | [Конфигурация Велеса](/configuration_ru)                                  |
| Настроить модель              | [Провайдеры и модели](/providers_ru)                                      |
| Подключить внешний инструмент | [Инструменты, веб-поиск и MCP](/dive-deeper/tools_web_mcp_ru)             |
| Подключить канал              | [Каналы и интеграции](/channels_ru)                                       |
| Управлять запуском            | [CLI и эксплуатация](/cli_operations_ru)                                  |
| Настроить интерфейс           | [Интерфейс Велеса для продвинутой работы](/veles_interface_operations_ru) |

## Чеклист перед постоянным запуском

* У каждого окружения свой `config.json`.
* Рабочая область не содержит секретов в открытом виде.
* `VELES_SECRETS_MASTER_KEY` передаётся только серверному процессу.
* Включены только нужные каналы.
* Для внешних каналов настроен `allowFrom`.
* Опасные инструменты ограничены рабочей областью или отключены.
* Фоновые задачи видны в интерфейсе и пишут ответы в историю.