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.

​
Установка и первый запуск

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

​
Что нужно понимать заранее

Для первого запуска важно знать три вещи:
  • CLI-команды nanobot пока сохраняют техническое имя старого исполняемого файла;
  • рабочая область хранит файлы, память и служебные данные Велеса;
  • графический интерфейс подключается к серверу Велеса и показывает чат, задачи, файлы, сессии и секреты.
Велес может работать и без графического интерфейса: через CLI или каналы вроде Telegram.

​
Быстрый старт Велеса

Создайте конфигурацию и рабочую область: 
nanobot onboard
Команда создаёт:
  • ~/.nanobot/config.json — основной файл конфигурации;
  • ~/.nanobot/workspace — рабочую область Велеса;
  • шаблонные файлы инструкций и памяти.
Для интерактивной настройки используйте мастер: 
nanobot onboard --wizard

​
Настройте модель

Минимально нужен хотя бы один LLM-провайдер и модель по умолчанию. Пример через OpenRouter: 
{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-..."
    }
  },
  "agents": {
    "defaults": {
      "model": "openrouter/openai/gpt-5.4"
    }
  }
}
Если вы используете локальную модель или OAuth-провайдера, смотрите Провайдеры и модели.

​
Проверьте CLI

Одно сообщение: 
nanobot agent -m "Привет. Кратко проверь, что ты работаешь."
Интерактивный режим: 
nanobot agent
Выход из интерактивного режима: exit, quit, /exit, /quit, :q или Ctrl+D. Полезные параметры: 
nanobot agent --no-markdown
nanobot agent --logs
nanobot agent --workspace /path/to/workspace
nanobot agent --config ~/.nanobot-work/config.json

​
Запустите сервер

Сервер нужен для интерфейса Велеса, каналов, расписаний, периодических проверок и внутренних операций с рабочей областью. 
nanobot gateway
Если в конфигурации не задан gateway.token, сервер не запустится. Токен нужен для авторизации интерфейса Велеса и внутренних клиентов. Пример: 
{
  "gateway": {
    "host": "0.0.0.0",
    "port": 18790,
    "token": "замените-на-длинный-секрет"
  }
}

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

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

​
Docker

Базовый сценарий: 
docker compose run --rm nanobot-cli onboard
docker compose up -d nanobot-gateway
docker compose logs -f nanobot-gateway
При ручном Docker-запуске монтируйте .nanobot, чтобы сохранить конфиг и рабочую область: 
docker run -v ~/.nanobot:/root/.nanobot -p 18790:18790 nanobot gateway

​
Systemd

Для постоянного Linux-запуска обычно создают user service, который вызывает: 
ExecStart=%h/.local/bin/nanobot gateway
Restart=always
Перед этим проверьте путь: 
which nanobot

​
Что читать дальше