Yuanbao

Tencent Yuanbao is het AI-assistentplatform van Tencent. De door de community onderhouden openclaw-plugin-yuanbao-plugin verbindt Yuanbao-bots via WebSocket met OpenClaw voor privéberichten en groepschats. Status: productieklaar voor privéberichten met bots en groepschats. WebSocket is de enige ondersteunde verbindingsmodus. Deze plugin wordt als externe catalogusvermelding onderhouden door het Tencent Yuanbao-team, niet door de kern van OpenClaw; de onderstaande configuratie- en gedragsdetails (afgezien van de installatie en de algemene CLI-interface) zijn afkomstig uit de eigen documentatie van de plugin en zijn niet geverifieerd aan de hand van de broncode van de OpenClaw-kern.

Snel aan de slag

Vereist OpenClaw 2026.4.10 of hoger. Controleer dit met openclaw --version; voer een upgrade uit met openclaw update.

Voeg het Yuanbao-kanaal toe met je inloggegevens

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

--token gebruikt met dubbele punten gescheiden appKey:appSecret. Verkrijg deze vanuit de Yuanbao-app door een bot te maken in de instellingen van je applicatie.

Start de Gateway opnieuw om de wijziging toe te passen

openclaw gateway restart

Interactieve installatie (alternatief)

openclaw channels login --channel yuanbao

Volg de aanwijzingen om je App ID en App Secret in te voeren.

Toegangsbeheer

Privéberichten

channels.yuanbao.dm.policy:

Waarde	Gedrag
`open` (standaard)	Alle gebruikers toestaan
`pairing`	Onbekende gebruikers krijgen een koppelingscode; keur deze goed via de CLI
`allowlist`	Alleen gebruikers in `allowFrom` kunnen chatten
`disabled`	Alle privéberichten uitschakelen

Een koppelingsverzoek goedkeuren:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Groepschats

channels.yuanbao.requireMention (standaard true): vereist een @vermelding voordat de bot in een groep reageert. Een antwoord op een bericht van de bot zelf wordt als een impliciete vermelding beschouwd.

Configuratievoorbeelden

Basisconfiguratie, open beleid voor privéberichten:

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

Privéberichten beperken tot specifieke gebruikers:

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

De vereiste voor een @vermelding in groepen uitschakelen:

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

Uitgaande bezorging afstemmen:

{
  channels: {
    yuanbao: {
      outboundQueueStrategy: "merge-text",
      minChars: 2800, // bufferen tot dit aantal tekens
      maxChars: 3000, // boven deze limiet geforceerd splitsen
      idleMs: 5000, // automatisch verzenden na time-out wegens inactiviteit (ms)
    },
  },
}

Stel outboundQueueStrategy: "immediate" in om elk fragment zonder buffering te verzenden.

Veelgebruikte opdrachten

Opdracht	Beschrijving
`/help`	Beschikbare opdrachten tonen
`/status`	Botstatus tonen
`/new`	Een nieuwe sessie starten
`/stop`	De huidige uitvoering stoppen
`/restart`	OpenClaw opnieuw starten
`/compact`	De sessiecontext comprimeren

Yuanbao ondersteunt systeemeigen menu’s voor slash-opdrachten; opdrachten worden automatisch met het platform gesynchroniseerd wanneer de Gateway start.

Problemen oplossen

Bot reageert niet in groepschats:

Controleer of de bot aan de groep is toegevoegd
Controleer of je de bot met @ vermeldt (standaard vereist)
Controleer de logboeken: openclaw logs --follow

Bot ontvangt geen berichten:

Controleer of de bot in de Yuanbao-app is gemaakt en goedgekeurd
Controleer of appKey en appSecret correct zijn geconfigureerd
Controleer of de Gateway actief is: openclaw gateway status
Controleer de logboeken: openclaw logs --follow

Bot verzendt lege antwoorden of terugvalantwoorden:

Controleer of het AI-model geldige inhoud retourneert
Standaard terugvalantwoord: “暂时无法解答，你可以换个问题问问我哦”
Pas dit aan met channels.yuanbao.fallbackReply

App Secret is uitgelekt:

Stel het App Secret opnieuw in de Yuanbao-app in
Werk de waarde in je configuratie bij
Start de Gateway opnieuw: openclaw gateway restart

Geavanceerde configuratie

Meerdere accounts

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

defaultAccount bepaalt welk account wordt gebruikt wanneer uitgaande API’s geen accountId opgeven.

Berichtlimieten

maxChars: maximaal aantal tekens per bericht (standaard 3000)
mediaMaxMb: limiet voor het uploaden/downloaden van media (standaard 20 MB)
overflowPolicy: gedrag wanneer een bericht de limiet overschrijdt, "split" (standaard) of "stop"

Streaming

Yuanbao ondersteunt streaminguitvoer op blokniveau; de bot verzendt de tekst tijdens het genereren in fragmenten.

{
  channels: {
    yuanbao: {
      disableBlockStreaming: false, // blokstreaming ingeschakeld (standaard)
    },
  },
}

Stel disableBlockStreaming: true in om het volledige antwoord in één bericht te verzenden.

Geschiedeniscontext voor groepschats

{
  channels: {
    yuanbao: {
      historyLimit: 100, // standaard: 100, stel in op 0 om uit te schakelen
    },
  },
}

Bepaalt hoeveel historische berichten voor groepschats in de AI-context worden opgenomen.

Antwoordmodus

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

Waarde	Gedrag
`off`	Geen geciteerd antwoord
`first`	Alleen het eerste antwoord per binnenkomend bericht citeren (standaard)
`all`	Elk antwoord citeren

Markdown-hintinjectie

Standaard injecteert de bot een instructie in de systeemprompt om te voorkomen dat het model het volledige antwoord in een Markdown-codeblok plaatst.

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

Debugmodus

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

Schakelt niet-geanonimiseerde logboekuitvoer in voor de vermelde bot-ID’s.

Routing met meerdere agents

Gebruik bindings om privéberichten of groepen van Yuanbao naar verschillende agents te routeren:

{
  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" (privébericht) of "group" (groepschat)
match.peer.id: gebruikers-ID of groepscode

Configuratiereferentie

Volledige configuratie: Gateway-configuratie

Instelling	Beschrijving	Standaard
`channels.yuanbao.enabled`	Het kanaal in-/uitschakelen	`true`
`channels.yuanbao.defaultAccount`	Standaardaccount voor uitgaande routing	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (ondertekening + ticketgeneratie)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (ondertekening)	-
`channels.yuanbao.accounts.<id>.token`	Vooraf ondertekend token (slaat automatische ticketondertekening over)	-
`channels.yuanbao.accounts.<id>.name`	Weergavenaam van account	-
`channels.yuanbao.accounts.<id>.enabled`	Een specifiek account in-/uitschakelen	`true`
`channels.yuanbao.dm.policy`	Beleid voor privéberichten	`open`
`channels.yuanbao.dm.allowFrom`	Toestaanlijst voor privéberichten (lijst met gebruikers-ID’s)	-
`channels.yuanbao.requireMention`	@Vermelding in groepen vereisen	`true`
`channels.yuanbao.overflowPolicy`	Afhandeling van lange berichten (`split` of `stop`)	`split`
`channels.yuanbao.replyToMode`	Strategie voor groepsantwoorden (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Uitgaande strategie (`merge-text` of `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Tekst samenvoegen: minimumaantal tekens om verzending te activeren	`2800`
`channels.yuanbao.maxChars`	Tekst samenvoegen: maximumaantal tekens per bericht	`3000`
`channels.yuanbao.idleMs`	Tekst samenvoegen: time-out wegens inactiviteit vóór automatisch verzenden (ms)	`5000`
`channels.yuanbao.mediaMaxMb`	Limiet voor mediagrootte (MB)	`20`
`channels.yuanbao.historyLimit`	Contextitems uit de geschiedenis van groepschats	`100`
`channels.yuanbao.disableBlockStreaming`	Streaminguitvoer op blokniveau uitschakelen	`false`
`channels.yuanbao.fallbackReply`	Terugvalantwoord wanneer het model geen inhoud retourneert	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Markdown-instructies tegen volledige codeblokken injecteren	`true`
`channels.yuanbao.debugBotIds`	Bot-ID’s op de debugtoestaanlijst (niet-geanonimiseerde logboeken)	`[]`

Ondersteunde berichttypen

Ontvangen: tekst, afbeeldingen, bestanden, audio/spraak, video, stickers/aangepaste emoji, aangepaste elementen (linkkaarten). Verzenden: tekst (Markdown), afbeeldingen, bestanden, audio, video, stickers. Threads en antwoorden: geciteerde antwoorden (configureerbaar via replyToMode); threadantwoorden worden niet door het platform ondersteund.

Gerelateerd

Overzicht van kanalen - alle ondersteunde kanalen
Koppelen - DM-authenticatie en koppelingsflow
Groepen - gedrag van groepschats en vermelding als voorwaarde
Kanaalroutering - sessieroutering voor berichten
Beveiliging - toegangsmodel en beveiligingsmaatregelen

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Snel aan de slag

Interactieve installatie (alternatief)

Toegangsbeheer

Privéberichten

Groepschats

Configuratievoorbeelden

Veelgebruikte opdrachten

Problemen oplossen

Geavanceerde configuratie

Meerdere accounts

Berichtlimieten

Streaming

Geschiedeniscontext voor groepschats

Antwoordmodus

Markdown-hintinjectie

Debugmodus

Routing met meerdere agents

Configuratiereferentie

Ondersteunde berichttypen

Gerelateerd

​Snel aan de slag

​Interactieve installatie (alternatief)

​Toegangsbeheer

​Privéberichten

​Groepschats

​Configuratievoorbeelden

​Veelgebruikte opdrachten

​Problemen oplossen

​Geavanceerde configuratie

​Meerdere accounts

​Berichtlimieten

​Streaming

​Geschiedeniscontext voor groepschats

​Antwoordmodus

​Markdown-hintinjectie

​Debugmodus

​Routing met meerdere agents

​Configuratiereferentie

​Ondersteunde berichttypen

​Gerelateerd

Snel aan de slag

Interactieve installatie (alternatief)

Toegangsbeheer

Privéberichten

Groepschats

Configuratievoorbeelden

Veelgebruikte opdrachten

Problemen oplossen

Geavanceerde configuratie

Meerdere accounts

Berichtlimieten

Streaming

Geschiedeniscontext voor groepschats

Antwoordmodus

Markdown-hintinjectie

Debugmodus

Routing met meerdere agents

Configuratiereferentie

Ondersteunde berichttypen

Gerelateerd