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, Telegram, WhatsApp, Discord, Feishu, Slack, email, QQ, Matrix, DingTalk, WeCom, Mochat или интеграция-расширение.

​
Общая модель

Канал отвечает за доставку сообщений. Цикл работы Велеса остаётся общим: Это значит, что инструменты, память, модель и правила Велеса применяются независимо от того, пришло сообщение из интерфейса, CLI или Telegram.

​
Общие настройки channels

{
  "channels": {
    "sendProgress": true,
    "sendToolHints": false
  }
}
ПолеНазначение
sendProgressОтправлять промежуточный текстовый прогресс
sendToolHintsПоказывать подсказки о вызовах инструментов
Для внешних каналов подсказки об инструментах лучше включать осторожно: они могут раскрывать имена файлов, команды или внутреннюю структуру задачи.

​
allowFrom

Большинство каналов поддерживает whitelist отправителей: 
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:...",
      "allowFrom": ["123456789"]
    }
  }
}
Правила:
  • [] — запретить всем;
  • ["*"] — разрешить всем;
  • список id — разрешить только указанным отправителям.
Не используйте ["*"] для публичного Велеса с включёнными файловыми инструментами, оболочкой или MCP.

​
Telegram

Telegram обычно требует токен Велеса Telegram и allowFrom. 
{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "BOT_TOKEN",
      "allowFrom": ["USER_ID"]
    }
  }
}
После настройки запустите: 
nanobot gateway
Подробнее: Команды Велеса в Telegram.

​
Другие встроенные каналы

В кодовой базе есть встроенные модули каналов для:
КаналНазначение
discordВелес Discord
feishuFeishu/Lark
slackSlack bot
emailПочтовый ассистент IMAP/SMTP
qqИнтеграция QQ
matrixMatrix
dingtalkDingTalk
wecomWeCom
mochatMochat
whatsappWhatsApp через мост
Точные поля зависят от конфигурации канала. Общий принцип одинаковый: включить enabled, задать учётные данные, настроить allowFrom, запустить nanobot gateway.

​
WhatsApp и мост

Для WhatsApp используется мост. Вход запускается командой: 
nanobot channels login
Команда готовит мост, запускает Node.js-процесс и показывает QR-код для привязки устройства. Полезные команды: 
nanobot channels status
nanobot plugins list

​
Каналы-расширения

Велес поддерживает архитектуру расширений для каналов. nanobot onboard добавляет конфигурацию по умолчанию для обнаруженных встроенных каналов и каналов-расширений, не перетирая существующие значения. Для разработки канала читайте Руководство по плагинам каналов.

​
Сессии по каналам

Обычно ключ сессии строится так: 
<channel>:<chat_id>
Примеры: 
web:default
telegram:123456789
cli:direct
Расписания и периодические проверки могут создавать отдельные служебные сессии, но доставка результата должна проходить через сервер Велеса, чтобы интерфейс и история видели тот же ответ, который получил пользователь.

​
Каналы и безопасность

Перед включением внешнего канала проверьте:
  • allowFrom не пустой случайно и не ["*"] без причины;
  • tools.restrictToWorkspace включён;
  • exec выключен или ограничен;
  • секреты не лежат в рабочей области открытым текстом;
  • токен интерфейса и сервера Велеса не опубликован;
  • прогресс и подсказки об инструментах не раскрывают лишнего.