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

WeChat (Weixin)

В этом руководстве описывается настройка канала Qwen Code в WeChat через официальный API iLink Bot.

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

  • Учетная запись WeChat с возможностью сканирования QR-кодов (мобильное приложение)
  • Доступ к платформе iLink Bot (официальный API ботов WeChat)

Настройка

1. Вход через QR-код

WeChat использует аутентификацию по QR-коду вместо статического токена бота. Выполните команду входа:

qwen channel configure-weixin

Будет отображен URL с QR-кодом. Отсканируйте его в мобильном приложении WeChat для аутентификации. Ваши учетные данные сохранятся в ~/.qwen/channels/weixin/account.json.

2. Настройка канала

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

{
  "channels": {
    "my-weixin": {
      "type": "weixin",
      "senderPolicy": "pairing",
      "allowedUsers": [],
      "sessionScope": "user",
      "cwd": "/path/to/your/project",
      "model": "qwen3.5-plus",
      "instructions": "You are a concise coding assistant responding via WeChat. Keep responses under 500 characters. Use plain text only."
    }
  }
}

Примечание: каналы WeChat не используют поле token — учетные данные получаются на этапе входа через QR-код.

3. Запуск канала

# Start only the WeChat channel
qwen channel start my-weixin
 
# Or start all configured channels together
qwen channel start

Откройте WeChat и отправьте сообщение боту. Во время обработки запроса агентом вы увидите индикатор набора текста (”…”), после чего появится ответ.

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

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

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

Файлы: Отправьте PDF, файл с кодом или любой другой документ. Бот загрузит и расшифрует его из CDN WeChat, сохранит локально, а агент прочитает его с помощью файловых инструментов. Работает с любой моделью.

Параметры конфигурации

Каналы WeChat поддерживают все стандартные параметры каналов (см. Обзор каналов), а также:

ПараметрОписание
baseUrlПереопределяет базовый URL API iLink Bot (по умолчанию: https://ilinkai.weixin.qq.com)

Ключевые отличия от Telegram

  • Аутентификация: Вход по QR-коду вместо статического токена бота. Сессии могут истекать — в этом случае канал приостановит работу и запишет сообщение в лог.
  • Форматирование: WeChat поддерживает только обычный текст. Markdown в ответах агента автоматически удаляется.
  • Индикатор набора текста: WeChat использует встроенный индикатор ”…”, а не текстовое сообщение “Working…”.
  • Группы: iLink Bot в WeChat работает только в личных сообщениях — групповые чаты не поддерживаются.
  • Шифрование медиа: Изображения и файлы шифруются в CDN WeChat алгоритмом AES-128-ECB. Канал прозрачно обрабатывает их расшифровку.

Рекомендации

  • Используйте инструкции для обычного текста — Поскольку WeChat удаляет весь markdown, добавьте в инструкции фразу вроде “Use plain text only”, чтобы агент не генерировал ответы с форматированием, которые будут выглядеть неаккуратно.
  • Делайте ответы короткими — Всплывающие окна сообщений WeChat лучше всего работают с лаконичным текстом. Добавление ограничения по символам в инструкции поможет (например, “Keep responses under 500 characters”).
  • Истечение сессии — Если в логах появляется “Session expired (errcode -14)”, значит, сессия входа в WeChat истекла. Остановите канал и повторно выполните qwen channel configure-weixin для входа.
  • Ограничение доступа — Используйте senderPolicy: "pairing" или "allowlist", чтобы контролировать, кто может общаться с ботом. Подробности см. в Сопряжение в ЛС.

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

”WeChat account not configured”

Сначала выполните qwen channel configure-weixin для входа через QR-код.

”Session expired (errcode -14)”

Сессия входа в WeChat истекла. Остановите канал и снова запустите qwen channel configure-weixin.

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

  • Проверьте вывод терминала на наличие ошибок
  • Убедитесь, что канал запущен (qwen channel start my-weixin)
  • При использовании senderPolicy: "allowlist" убедитесь, что ваш WeChat user ID указан в allowedUsers

Не работают изображения

  • Убедитесь, что в конфигурации канала указана model с поддержкой vision (например, qwen3.5-plus)
  • Проверьте терминал на ошибки загрузки из CDN — они могут указывать на проблемы с сетью
Last updated on
TelegramDingTalk