openclaw-plugin-yuanbao підключає ботів Yuanbao до OpenClaw через WebSocket для приватних повідомлень і групових чатів.
Стан: готовий до промислового використання для приватних повідомлень ботам і групових чатів. WebSocket — єдиний підтримуваний режим підключення. Цей plugin підтримує команда Tencent Yuanbao як зовнішній запис каталогу, а не ядро OpenClaw; наведені нижче відомості про конфігурацію та поведінку (крім установлення й загального інтерфейсу CLI) походять із власної документації plugin і не перевірені за вихідним кодом ядра 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); платформа не підтримує відповіді в гілках.
Пов’язані матеріали
- Огляд каналів — усі підтримувані канали
- Сполучення — автентифікація приватних повідомлень і процес сполучення
- Групи — поведінка групових чатів і обмеження за згадкою
- Маршрутизація каналів — маршрутизація сеансів для повідомлень
- Безпека — модель доступу та посилення захисту