Skip to main content

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-задачи

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

По умолчанию Велес использует файл: 
~/.nanobot/config.json
Имя каталога осталось техническим наследием. В пользовательской документации продукт называется Велесом, но команды и пути пока используют nanobot. Рабочая область задаётся в конфигурации: 
{
  "agents": {
    "defaults": {
      "workspace": "~/.nanobot/workspace"
    }
  }
}
Практические рекомендации:
  • создавайте отдельную рабочую область для каждого проекта;
  • не смешивайте личную память и память рабочего проекта;
  • для экспериментов используйте отдельный файл конфигурации;
  • не храните секреты в файлах рабочей области.

​
Модели

Модель по умолчанию и список моделей для переключателя задаются в agents.defaults: 
{
  "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; тогда они появятся в интерфейсе Велеса. Подробнее: Провайдеры и модели.

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

Отдельные экземпляры нужны, когда вы хотите изолировать проекты, команды или каналы. 
nanobot onboard --config ~/.nanobot-work/config.json --workspace ~/.nanobot-work/workspace
nanobot gateway --config ~/.nanobot-work/config.json --port 18791
Правила:
  • у каждого экземпляра должен быть свой config.json;
  • у каждого рабочего проекта должна быть своя рабочая область;
  • если несколько экземпляров работают одновременно, используйте разные порты;
  • фоновые задачи и служебные файлы привязаны к выбранной конфигурации и рабочей области.

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

Велес может читать и писать файлы, искать в интернете, работать с документами, запускать команды и подключать внешние инструменты. Для постоянной установки включайте ограничение рабочей области: 
{
  "tools": {
    "restrictToWorkspace": true
  }
}
Если запуск команд не нужен, отключите его: 
{
  "tools": {
    "exec": {
      "enable": false
    }
  }
}
Подробнее: Инструменты, веб-поиск и MCP.

​
Секреты

Секреты не нужно вставлять в чат или хранить в обычном тексте. Для локального зашифрованного хранилища сгенерируйте ключ: 
nanobot secrets generate-key
Затем передайте NANOBOT_SECRETS_MASTER_KEY процессу Велеса. Ключ должен быть только на стороне сервера, не в браузере. Подробнее: Секреты и токены.

​
Каналы

Канал — это способ доставить сообщение в Велес: веб-чат, Telegram, почта, мессенджер или собственная интеграция. Для внешних каналов обязательно настройте список разрешённых отправителей: 
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "BOT_TOKEN",
      "allowFrom": ["USER_ID"]
    }
  }
}
Пустой allowFrom запрещает всех. ["*"] разрешает всех и подходит только для осознанно публичных установок. Подробнее: Каналы и интеграции.

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

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

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

ЗадачаГде читать
Первый запускУстановка и первый запуск
Настроить конфигурациюКонфигурация Велеса
Настроить модельПровайдеры и модели
Подключить внешний инструментИнструменты, веб-поиск и MCP
Подключить каналКаналы и интеграции
Управлять запускомCLI и эксплуатация
Настроить интерфейсИнтерфейс Велеса для продвинутой работы

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

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