Yuanbao - OpenClaw

Tencent Yuanbao — це платформа AI-помічника від Tencent. Канальний Plugin OpenClaw підключає ботів Yuanbao до OpenClaw через WebSocket, щоб вони могли взаємодіяти з користувачами через прямі повідомлення та групові чати. Статус: готово до продакшну для DM ботів і групових чатів. WebSocket — єдиний підтримуваний режим підключення.

Швидкий старт

Потрібен OpenClaw 2026.4.10 або новіший. Запустіть openclaw --version, щоб перевірити. Оновіть за допомогою openclaw update.

Додайте канал Yuanbao зі своїми обліковими даними

openclaw channels add --channel yuanbao --token "appKey:appSecret"

Значення --token використовує формат appKey:appSecret, розділений двокрапкою. Ви можете отримати їх у застосунку Yuanbao, створивши робота в налаштуваннях вашого застосунку.

Після завершення налаштування перезапустіть gateway, щоб застосувати зміни

openclaw gateway restart

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

Ви також можете скористатися інтерактивним майстром:

openclaw channels login --channel yuanbao

Дотримуйтеся підказок, щоб ввести ідентифікатор застосунку та секрет застосунку.

Контроль доступу

Прямі повідомлення

Налаштуйте dmPolicy, щоб керувати тим, хто може надсилати DM боту:

"pairing" - невідомі користувачі отримують код сполучення; схвалюйте через CLI
"allowlist" - спілкуватися можуть лише користувачі, указані в allowFrom
"open" - дозволити всіх користувачів (типово)
"disabled" - вимкнути всі DM

Схвалити запит на сполучення:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Групові чати

Вимога згадки (channels.yuanbao.requireMention):

true - вимагати @mention (типово)
false - відповідати без @mention

Відповідь на повідомлення бота в груповому чаті вважається неявною згадкою.

Приклади конфігурації

Базове налаштування з відкритою політикою DM

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "open",
      },
    },
  },
}

Обмежити DM певними користувачами

{
  channels: {
    yuanbao: {
      appKey: "your_app_key",
      appSecret: "your_app_secret",
      dm: {
        policy: "allowlist",
        allowFrom: ["user_id_1", "user_id_2"],
      },
    },
  },
}

Вимкнути вимогу @mention у групах

{
  channels: {
    yuanbao: {
      requireMention: false,
    },
  },
}

Оптимізувати доставку вихідних повідомлень

{
  channels: {
    yuanbao: {
      // Send each chunk immediately without buffering
      outboundQueueStrategy: "immediate",
    },
  },
}

Налаштувати стратегію merge-text

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // buffer until this many chars
      maxChars: 3000, // force split above this limit
      idleMs: 5000, // auto-flush after idle timeout (ms)
    },
  },
}

Поширені команди

Команда	Опис
`/help`	Показати доступні команди
`/status`	Показати статус бота
`/new`	Почати новий сеанс
`/stop`	Зупинити поточний запуск
`/restart`	Перезапустити OpenClaw
`/compact`	Стиснути контекст сеансу

Yuanbao підтримує нативні меню slash-команд. Команди автоматично синхронізуються з платформою під час запуску gateway.

Усунення несправностей

Бот не відповідає в групових чатах

Переконайтеся, що бота додано до групи
Переконайтеся, що ви згадали бота через @mention (типово обов’язково)
Перевірте журнали: openclaw logs --follow

Бот не отримує повідомлення

Переконайтеся, що бота створено та схвалено в застосунку Yuanbao
Переконайтеся, що appKey і appSecret налаштовано правильно
Переконайтеся, що gateway запущено: openclaw gateway status
Перевірте журнали: openclaw logs --follow

Бот надсилає порожні або резервні відповіді

Перевірте, чи AI-модель повертає валідний вміст
Типова резервна відповідь: “暂时无法解答，你可以换个问题问问我哦”
Налаштуйте її через channels.yuanbao.fallbackReply

App Secret витік

Скиньте App Secret у YuanBao APP
Оновіть значення у своїй конфігурації
Перезапустіть gateway: openclaw gateway restart

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

Кілька акаунтів

{
  channels: {
    yuanbao: {
      defaultAccount: "main",
      accounts: {
        main: {
          appKey: "key_xxx",
          appSecret: "secret_xxx",
          name: "Primary bot",
        },
        backup: {
          appKey: "key_yyy",
          appSecret: "secret_yyy",
          name: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

defaultAccount керує тим, який акаунт використовується, коли вихідні API не вказують accountId.

Обмеження повідомлень

maxChars - максимальна кількість символів в одному повідомленні (типово: 3000 символів)
mediaMaxMb - обмеження завантаження/вивантаження медіа (типово: 20 МБ)
overflowPolicy - поведінка, коли повідомлення перевищує ліміт: "split" (типово) або "stop"

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

Yuanbao підтримує потокове виведення на рівні блоків. Коли його ввімкнено, бот надсилає текст частинами під час генерації.

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // block streaming enabled (default)
    },
  },
}

Установіть disableBlockStreaming: true, щоб надіслати повну відповідь одним повідомленням.

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

Керуйте тим, скільки історичних повідомлень включається до AI-контексту для групових чатів:

{
  channels: {
    yuanbao: {
      historyLimit: 100, // default: 100, set 0 to disable
    },
  },
}

Режим reply-to

Керуйте тим, як бот цитує повідомлення, відповідаючи в групових чатах:

{
  channels: {
    yuanbao: {
      replyToMode: "first", // "off" | "first" | "all" (default: "first")
    },
  },
}

Значення	Поведінка
`"off"`	Без відповіді з цитуванням
`"first"`	Цитувати лише першу відповідь на вхідне повідомлення (типово)
`"all"`	Цитувати кожну відповідь

Вставлення підказки Markdown

Типово бот вставляє інструкції в системний prompt, щоб запобігти обгортанню всієї відповіді AI-моделлю в кодові блоки markdown.

{
  channels: {
    yuanbao: {
      markdownHintEnabled: true, // default: true
    },
  },
}

Режим налагодження

Увімкніть несанітизований вивід журналів для певних ідентифікаторів ботів:

{
  channels: {
    yuanbao: {
      debugBotIds: ["bot_user_id_1", "bot_user_id_2"],
    },
  },
}

Маршрутизація кількох агентів

Використовуйте bindings, щоб маршрутизувати DM або групи Yuanbao до різних агентів.

{
  agents: {
    list: [
      { id: "main" },
      { id: "agent-a", workspace: "/home/user/agent-a" },
      { id: "agent-b", workspace: "/home/user/agent-b" },
    ],
  },
  bindings: [
    {
      agentId: "agent-a",
      match: {
        channel: "yuanbao",
        peer: { kind: "direct", id: "user_xxx" },
      },
    },
    {
      agentId: "agent-b",
      match: {
        channel: "yuanbao",
        peer: { kind: "group", id: "group_zzz" },
      },
    },
  ],
}

Поля маршрутизації:

match.channel: "yuanbao"
match.peer.kind: "direct" (DM) або "group" (груповий чат)
match.peer.id: ідентифікатор користувача або код групи

Довідник конфігурації

Повна конфігурація: Конфігурація Gateway

Налаштування	Опис	Типово
`channels.yuanbao.enabled`	Увімкнути/вимкнути канал	`true`
`channels.yuanbao.defaultAccount`	Типовий акаунт для вихідної маршрутизації	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (використовується для підписування та генерації ticket)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (використовується для підписування)	-
`channels.yuanbao.accounts.<id>.token`	Попередньо підписаний token (пропускає автоматичне підписування ticket)	-
`channels.yuanbao.accounts.<id>.name`	Відображувана назва акаунта	-
`channels.yuanbao.accounts.<id>.enabled`	Увімкнути/вимкнути певний акаунт	`true`
`channels.yuanbao.dm.policy`	Політика DM	`open`
`channels.yuanbao.dm.allowFrom`	Allowlist DM (список ідентифікаторів користувачів)	-
`channels.yuanbao.requireMention`	Вимагати @mention у групах	`true`
`channels.yuanbao.overflowPolicy`	Обробка довгих повідомлень (`split` або `stop`)	`split`
`channels.yuanbao.replyToMode`	Стратегія reply-to для груп (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Вихідна стратегія (`merge-text` або `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Merge-text: мінімум символів для запуску надсилання	`2800`
`channels.yuanbao.maxChars`	Merge-text: максимум символів на повідомлення	`3000`
`channels.yuanbao.idleMs`	Merge-text: тайм-аут бездіяльності перед автоматичним flush (мс)	`5000`
`channels.yuanbao.mediaMaxMb`	Обмеження розміру медіа (МБ)	`20`
`channels.yuanbao.historyLimit`	Записи контексту історії групового чату	`100`
`channels.yuanbao.disableBlockStreaming`	Вимкнути потокове виведення на рівні блоків	`false`
`channels.yuanbao.fallbackReply`	Резервна відповідь, коли AI не повертає вміст	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Вставляти інструкції проти обгортання markdown	`true`
`channels.yuanbao.debugBotIds`	Allowlist ідентифікаторів ботів для налагодження (несанітизовані журнали)	`[]`

Підтримувані типи повідомлень

Отримання

✅ Текст
✅ Зображення
✅ Файли
✅ Аудіо / голос
✅ Відео
✅ Стікери / власні emoji
✅ Власні елементи (картки посилань тощо)

Надсилання

✅ Текст (з підтримкою markdown)
✅ Зображення
✅ Файли
✅ Аудіо
✅ Відео
✅ Стікери

Threads і відповіді

✅ Відповіді з цитуванням (налаштовується через replyToMode)
❌ Відповіді в threads (не підтримується платформою)

Пов’язане

Огляд каналів - усі підтримувані канали
Сполучення - автентифікація DM і потік сполучення
Групи - поведінка групових чатів і gating згадок
Маршрутизація каналів - маршрутизація сеансів для повідомлень
Безпека - модель доступу та посилення захисту

Documentation Index

​Швидкий старт

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

​Контроль доступу

​Прямі повідомлення

​Групові чати

​Приклади конфігурації

​Базове налаштування з відкритою політикою DM

​Обмежити DM певними користувачами

​Вимкнути вимогу @mention у групах

​Оптимізувати доставку вихідних повідомлень

​Налаштувати стратегію merge-text

​Поширені команди

​Усунення несправностей

​Бот не відповідає в групових чатах

​Бот не отримує повідомлення

​Бот надсилає порожні або резервні відповіді

​App Secret витік

​Розширена конфігурація

​Кілька акаунтів

​Обмеження повідомлень

​Потокове передавання

​Контекст історії групового чату

​Режим reply-to

​Вставлення підказки Markdown

​Режим налагодження

​Маршрутизація кількох агентів

​Довідник конфігурації

​Підтримувані типи повідомлень

​Отримання

​Надсилання

​Threads і відповіді

​Пов’язане