Skip to main content
Tencent Yuanbao — платформа ИИ-ассистента от Tencent. Поддерживаемый сообществом плагин openclaw-plugin-yuanbao подключает ботов Yuanbao к OpenClaw через WebSocket для личных сообщений и групповых чатов. Статус: готов к промышленной эксплуатации для личных сообщений ботам и групповых чатов. WebSocket — единственный поддерживаемый режим подключения. Этот плагин поддерживается командой Tencent Yuanbao как внешняя запись каталога, а не основной командой OpenClaw; приведённые ниже сведения о конфигурации и поведении (помимо установки и общего интерфейса CLI) взяты из документации самого плагина и не сверены с исходным кодом ядра OpenClaw.

Быстрый старт

Требуется OpenClaw 2026.4.10 или более поздней версии. Проверьте версию с помощью openclaw --version; обновите с помощью openclaw update.
1

Добавьте канал Yuanbao со своими учётными данными

--token использует разделённые двоеточием appKey:appSecret. Получите их в приложении Yuanbao, создав бота в настройках приложения.
2

Перезапустите Gateway, чтобы применить изменение

Интерактивная настройка (альтернативный вариант)

Следуйте подсказкам, чтобы ввести App ID и App Secret.

Управление доступом

Личные сообщения

channels.yuanbao.dm.policy: Подтвердите запрос на сопряжение:

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

channels.yuanbao.requireMention (по умолчанию true): прежде чем бот ответит в группе, требуется @упоминание. Ответ на собственное сообщение бота считается неявным упоминанием.

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

Базовая настройка с открытой политикой личных сообщений:
Ограничение личных сообщений указанными пользователями:
Отключение требования @упоминания в группах:
Настройка исходящей доставки:
Установите outboundQueueStrategy: "immediate", чтобы отправлять каждый фрагмент без буферизации.

Основные команды

Yuanbao поддерживает встроенные меню команд с косой чертой; команды автоматически синхронизируются с платформой при запуске Gateway.

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

Бот не отвечает в групповых чатах:
  1. Убедитесь, что бот добавлен в группу
  2. Убедитесь, что вы @упомянули бота (по умолчанию это обязательно)
  3. Проверьте журналы: openclaw logs --follow
Бот не получает сообщения:
  1. Убедитесь, что бот создан и одобрен в приложении Yuanbao
  2. Убедитесь, что appKey и appSecret настроены правильно
  3. Убедитесь, что Gateway запущен: openclaw gateway status
  4. Проверьте журналы: openclaw logs --follow
Бот отправляет пустые или резервные ответы:
  1. Проверьте, возвращает ли модель ИИ допустимое содержимое
  2. Резервный ответ по умолчанию: “暂时无法解答,你可以换个问题问问我哦”
  3. Настройте его с помощью channels.yuanbao.fallbackReply
Утечка App Secret:
  1. Сбросьте App Secret в приложении Yuanbao
  2. Обновите значение в конфигурации
  3. Перезапустите Gateway: openclaw gateway restart

Расширенная конфигурация

Несколько учётных записей

defaultAccount определяет, какая учётная запись используется, когда в исходящих API не указан accountId.

Ограничения сообщений

  • maxChars: максимальное количество символов в одном сообщении (по умолчанию 3000)
  • mediaMaxMb: ограничение на отправку и скачивание медиафайлов (по умолчанию 20 МБ)
  • overflowPolicy: поведение при превышении сообщением ограничения: "split" (по умолчанию) или "stop"

Потоковая передача

Yuanbao поддерживает потоковый вывод на уровне блоков; бот отправляет текст фрагментами по мере его создания.
Установите disableBlockStreaming: true, чтобы отправлять полный ответ одним сообщением.

Контекст истории группового чата

Определяет, сколько предыдущих сообщений включается в контекст ИИ для групповых чатов.

Режим ответа на сообщение

Добавление подсказки Markdown

По умолчанию бот добавляет в системный промпт инструкцию, запрещающую модели заключать весь ответ в блок кода Markdown.

Режим отладки

Включает вывод журналов без очистки данных для ботов с указанными идентификаторами.

Маршрутизация между несколькими агентами

Используйте bindings, чтобы направлять личные сообщения или группы Yuanbao разным агентам:
  • match.channel: "yuanbao"
  • match.peer.kind: "direct" (личное сообщение) или "group" (групповой чат)
  • match.peer.id: идентификатор пользователя или код группы

Справочник по конфигурации

Полная конфигурация: Конфигурация Gateway

Поддерживаемые типы сообщений

Получение: текст, изображения, файлы, аудио и голосовые сообщения, видео, стикеры и пользовательские эмодзи, пользовательские элементы (карточки ссылок). Отправка: текст (Markdown), изображения, файлы, аудио, видео, стикеры. Ветки и ответы: ответы с цитированием (настраиваются через replyToMode); платформа не поддерживает ответы в ветках.

См. также