Skip to Content
Руководство для пользователейВозможностиКаналыTelegram

Telegram

В этом руководстве описывается настройка канала Qwen Code в Telegram.

Предварительные требования

  • Аккаунт Telegram
  • Токен бота Telegram (см. ниже)

Создание бота

  1. Откройте Telegram и найдите @BotFather 
  2. Отправьте /newbot и следуйте инструкциям, чтобы выбрать имя и username
  3. BotFather выдаст вам токен бота — сохраните его в надёжном месте

Поиск вашего User ID

Для использования senderPolicy: "allowlist" или "pairing" вам потребуется ваш Telegram user ID (числовой идентификатор, а не username).

Самый простой способ его узнать:

  1. Найдите @userinfobot  в Telegram
  2. Отправьте ему любое сообщение — в ответ он пришлёт ваш user ID

Настройка

Добавьте канал в ~/.qwen/settings.json:

{
  "channels": {
    "my-telegram": {
      "type": "telegram",
      "token": "$TELEGRAM_BOT_TOKEN",
      "senderPolicy": "allowlist",
      "allowedUsers": ["YOUR_USER_ID"],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "instructions": "You are a concise coding assistant responding via Telegram. Keep responses short.",
      "groupPolicy": "disabled",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Установите токен бота в качестве переменной окружения:

export TELEGRAM_BOT_TOKEN=<your-token-from-botfather>

Или добавьте его в файл .env, который будет загружен перед запуском.

Запуск

# Start only the Telegram channel
qwen channel start my-telegram
 
# Or start all configured channels together
qwen channel start

Затем откройте вашего бота в Telegram и отправьте сообщение. Вы должны сразу увидеть индикатор “Working…”, после чего последует ответ агента.

Групповые чаты

Чтобы использовать бота в группах Telegram:

  1. Установите groupPolicy в "allowlist" или "open" в конфигурации канала
  2. Отключите privacy mode в BotFather: /mybots → выберите вашего бота → Bot Settings → Group Privacy → Turn Off
  3. Добавьте бота в группу. Если он уже был в группе, удалите и добавьте его снова (Telegram кэширует настройки приватности на момент добавления бота)
  4. При использовании groupPolicy: "allowlist" добавьте chat ID группы в groups в вашей конфигурации

По умолчанию бот требует @mention или ответ на сообщение, чтобы реагировать в группах. Установите "requireMention": false для конкретной группы, чтобы он отвечал на все сообщения (полезно для выделенных групп задач). Полные сведения см. в разделе Group Chats.

Изображения и файлы

Боту можно отправлять не только текст, но и фотографии и документы.

Фотографии: Отправьте фото, и агент проанализирует его, используя свои возможности vision. Для этого требуется мультимодальная модель — добавьте "model": "qwen3.5-plus" (или другую модель с поддержкой vision) в конфигурацию канала. Подписи к фото передаются в качестве текста сообщения.

Документы: Отправьте PDF, файл с кодом или любой другой документ. Бот скачает его и сохранит локально, чтобы агент мог прочитать его с помощью файловых инструментов. Работает с любой моделью. Лимит размера файла в Telegram составляет 20 МБ.

Советы

  • Делайте инструкции краткими — в Telegram действует лимит на сообщение в 4096 символов. Добавление указаний вроде “keep responses short” помогает агенту укладываться в ограничения.
  • Используйте sessionScope: "user" — это создаёт отдельный диалог для каждого пользователя. Используйте /clear, чтобы начать заново.
  • Ограничьте доступ — используйте senderPolicy: "allowlist" для фиксированного списка пользователей или "pairing", чтобы новые пользователи могли запрашивать доступ по коду, который вы подтверждаете через CLI. Подробности см. в разделе DM Pairing.

Форматирование сообщений

Markdown-ответы агента автоматически преобразуются в HTML, совместимый с Telegram. Поддерживаются блоки кода, жирный шрифт, курсив, ссылки и списки.

Устранение неполадок

Бот не отвечает

  • Убедитесь, что токен бота указан верно и переменная окружения установлена
  • Проверьте, что ваш user ID указан в allowedUsers при использовании senderPolicy: "allowlist", или что вы получили одобрение при использовании "pairing"
  • Проверьте вывод терминала на наличие ошибок

Бот не отвечает в группах

  • Убедитесь, что groupPolicy установлен в "allowlist" или "open" (по умолчанию "disabled")
  • При использовании "allowlist" проверьте, что chat ID группы указан в конфигурации groups
  • Убедитесь, что Group Privacy отключена в BotFather — без этого бот не видит сообщения в группах, не являющиеся командами
  • Если вы изменили privacy mode после добавления бота в группу, удалите и добавьте бота снова
  • По умолчанию бот требует @mention или ответ. Для проверки отправьте @yourbotname hello

”Sorry, something went wrong processing your message”

Обычно это означает, что агент столкнулся с ошибкой. Проверьте вывод терминала для получения подробностей.

Бот долго отвечает

Агент может выполнять несколько вызовов инструментов (чтение файлов, поиск и т. д.). Индикатор “Working…” отображается во время обработки агентом. Сложные задачи могут занимать минуту и более.

Last updated on
ОбзорWeChat