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.

​
Конфигурация Велеса

Основной файл конфигурации Велеса обычно находится в ~/.nanobot/config.json. При запуске с --config можно использовать другой файл. Ключи принимаются в camelCase и snake_case, но в пользовательском JSON лучше держаться camelCase.

​
Общая структура

{
  "agents": {},
  "providers": {},
  "gateway": {},
  "channels": {},
  "tools": {},
  "secrets": {},
  "skills": {}
}

​
agents

Раздел agents.defaults задаёт поведение Велеса по умолчанию. 
{
  "agents": {
    "defaults": {
      "workspace": "~/.nanobot/workspace",
      "model": "anthropic/claude-opus-4-5",
      "provider": "auto",
      "maxTokens": 8192,
      "contextWindowTokens": 65536,
      "temperature": 0.1,
      "maxToolIterations": 40,
      "reasoningEffort": "medium",
      "models": [
        { "id": "openrouter/openai/gpt-5.4", "label": "GPT 5.4" },
        { "id": "anthropic/claude-sonnet-4-6", "label": "Claude Sonnet" }
      ]
    }
  }
}
Важные поля:
ПолеНазначение
workspaceРабочая область Велеса
modelМодель по умолчанию
modelsСписок моделей для переключателя в интерфейсе Велеса
providerЯвный провайдер или auto
contextWindowTokensОценка доступного контекста
maxToolIterationsМаксимум итераций модель-инструменты
reasoningEffortУровень рассуждения для моделей, которые это поддерживают

​
providers

Каждый провайдер обычно имеет apiKey, apiBase и иногда extraHeaders. 
{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-..."
    },
    "ollama": {
      "apiBase": "http://localhost:11434"
    },
    "custom": {
      "apiKey": "no-key",
      "apiBase": "http://localhost:8000/v1"
    }
  }
}
OAuth-провайдеры вроде openaiCodex и githubCopilot не требуют обычного apiKey в config.json. Подробнее: Провайдеры и модели.

​
gateway

Раздел gateway настраивает сервер Велеса: интерфейс, внутренние вызовы, каналы, расписания и периодические проверки. 
{
  "gateway": {
    "host": "0.0.0.0",
    "port": 18790,
    "token": "длинный-секрет",
    "heartbeat": {
      "enabled": true,
      "intervalS": 1800
    }
  }
}
gateway.token обязателен для запуска сервера. Не публикуйте его и не вставляйте в чат.

​
channels

channels содержит настройки встроенных каналов и каналов-расширений. Общие поля: 
{
  "channels": {
    "sendProgress": true,
    "sendToolHints": false,
    "telegram": {
      "enabled": true,
      "token": "123456:...",
      "allowFrom": ["123456789"]
    }
  }
}
allowFrom — белый список отправителей. Пустой список означает запрет всем. Чтобы разрешить всех, укажите ["*"]. Подробнее: Каналы и интеграции.

​
tools

Раздел tools управляет встроенными инструментами, веб-поиском, MCP, памятью, распознаванием текста, аудио и глубоким исследованием. 
{
  "tools": {
    "restrictToWorkspace": true,
    "exec": {
      "enable": true,
      "timeout": 60,
      "pathAppend": ""
    },
    "web": {
      "proxy": "http://127.0.0.1:7890",
      "search": {
        "provider": "duckduckgo",
        "maxResults": 5
      }
    }
  }
}
Для постоянной установки включайте restrictToWorkspace, особенно если включён exec или внешние MCP-серверы. Подробнее: Инструменты, веб-поиск и MCP.

​
sessionMemory и memoryFlush

sessionMemory управляет сохранением итогов завершённых сессий в память. 
{
  "tools": {
    "sessionMemory": {
      "enabled": true,
      "maxMessages": 20,
      "minUserMessages": 3,
      "deleteBehavior": "hide"
    },
    "memoryFlush": {
      "enabled": true,
      "thresholdTokens": 4000
    }
  }
}
deleteBehavior: "hide" скрывает сессии из списков интерфейса Велеса, но оставляет точный поиск и возможность повторной активации. delete физически удаляет файлы через обычные пути удаления.

​
vectorMemory

Векторная память индексирует документы для поиска по проекту. 
{
  "tools": {
    "vectorMemory": {
      "enabled": true,
      "embeddingModel": "openrouter/openai/text-embedding-3-small",
      "chunkTokens": 512,
      "chunkOverlap": 64,
      "syncIntervalSeconds": 60
    }
  }
}
Используйте её для больших папок docs/ и материалов, которые Велес должен находить по смыслу.

​
secrets

secrets описывает источники SecretRef: окружение, файл или команду. 
{
  "secrets": {
    "providers": {
      "env": {
        "source": "env",
        "allowlist": ["OPENROUTER_API_KEY"]
      }
    },
    "defaults": {
      "providers.openrouter.apiKey": "env:OPENROUTER_API_KEY"
    }
  }
}
Для локального зашифрованного хранилища нужен NANOBOT_SECRETS_MASTER_KEY. Подробнее: Секреты и токены.

​
skills

skills.entries включает настройки отдельных навыков. 
{
  "skills": {
    "entries": {
      "github": {
        "enabled": true,
        "env": {
          "GH_TOKEN": { "source": "local", "target": "skills.github.env.GH_TOKEN" }
        }
      }
    }
  }
}
Секреты окружения, объявленные навыком, могут появляться автоматически из метаданных SKILL.md, даже если вы не добавляли их вручную в config.json.