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, чтобы применить изменение
Интерактивная настройка (альтернативный вариант)
Управление доступом
Личные сообщения
channels.yuanbao.dm.policy:
Подтвердите запрос на сопряжение:
Групповые чаты
channels.yuanbao.requireMention (по умолчанию true): прежде чем бот ответит в группе, требуется @упоминание. Ответ на собственное сообщение бота считается неявным упоминанием.
Примеры конфигурации
Базовая настройка с открытой политикой личных сообщений:outboundQueueStrategy: "immediate", чтобы отправлять каждый фрагмент без буферизации.
Основные команды
Yuanbao поддерживает встроенные меню команд с косой чертой; команды автоматически синхронизируются с платформой при запуске Gateway.
Устранение неполадок
Бот не отвечает в групповых чатах:- Убедитесь, что бот добавлен в группу
- Убедитесь, что вы @упомянули бота (по умолчанию это обязательно)
- Проверьте журналы:
openclaw logs --follow
- Убедитесь, что бот создан и одобрен в приложении Yuanbao
- Убедитесь, что
appKeyиappSecretнастроены правильно - Убедитесь, что Gateway запущен:
openclaw gateway status - Проверьте журналы:
openclaw logs --follow
- Проверьте, возвращает ли модель ИИ допустимое содержимое
- Резервный ответ по умолчанию: “暂时无法解答,你可以换个问题问问我哦”
- Настройте его с помощью
channels.yuanbao.fallbackReply
- Сбросьте App Secret в приложении Yuanbao
- Обновите значение в конфигурации
- Перезапустите 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); платформа не поддерживает ответы в ветках.
См. также
- Обзор каналов - все поддерживаемые каналы
- Сопряжение - аутентификация в личных сообщениях и процесс сопряжения
- Группы - поведение групповых чатов и фильтрация по упоминаниям
- Маршрутизация каналов - маршрутизация сообщений по сеансам
- Безопасность - модель доступа и усиление защиты