Skip to main content
Tencent Yuanbao — це платформа ШІ-асистента від Tencent. Підтримуваний спільнотою plugin 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, щоб застосувати зміни

Інтерактивне налаштування (альтернатива)

Дотримуйтеся підказок, щоб ввести 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); платформа не підтримує відповіді в гілках.

Пов’язані матеріали