Yuanbao

Tencent Yuanbao is het AI-assistentplatform van Tencent. De door de community onderhouden plugin openclaw-plugin-yuanbao verbindt Yuanbao-bots via WebSocket met OpenClaw voor privéberichten en groepschats.

Status: gereed voor productie voor privéberichten met bots en groepschats. WebSocket is de enige ondersteunde verbindingsmodus. Deze plugin wordt door het Tencent Yuanbao-team onderhouden als een externe catalogusvermelding, 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.

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

openclaw gateway restart

Interactieve configuratie (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:

Keur een koppelverzoek goed:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

Groepschats

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

Configuratievoorbeelden

Basisconfiguratie met open beleid voor privéberichten:

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

Beperk privéberichten tot specifieke gebruikers:

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

Schakel de vereiste voor @vermeldingen in groepen uit:

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

Afstemming van uitgaande bezorging:

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

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

Veelgebruikte opdrachten

Yuanbao ondersteunt systeemeigen menu's voor slashopdrachten; opdrachten worden automatisch met het platform gesynchroniseerd wanneer de Gateway start.

Problemen oplossen

Bot reageert niet in groepschats:

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

Bot ontvangt geen berichten:

1. Controleer of de bot in de Yuanbao-app is aangemaakt en goedgekeurd
2. Controleer of appKey en appSecret correct zijn geconfigureerd
3. Controleer of de Gateway actief is: openclaw gateway status
4. Controleer de logboeken: openclaw logs --follow

Bot verzendt lege antwoorden of terugvalantwoorden:

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

App Secret is gelekt:

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

Geavanceerde configuratie

Meerdere accounts

{  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 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 tekst in fragmenten terwijl deze wordt gegenereerd.

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

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

Historische context van 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")    },  },}

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    },  },}

Foutopsporingsmodus

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

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

Routering 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

Ondersteunde berichttypen

Ontvangen: tekst, afbeeldingen, bestanden, audio/spraak, video, stickers/aangepaste emoji en aangepaste elementen (linkkaarten).

Verzenden: tekst (Markdown), afbeeldingen, bestanden, audio, video en stickers.

Discussies en antwoorden: geciteerde antwoorden (configureerbaar via replyToMode); antwoorden in discussies worden niet door het platform ondersteund.

Gerelateerd

• Overzicht van kanalen - alle ondersteunde kanalen
• Koppelen - authenticatie van privéberichten en koppelproces
• Groepen - gedrag van groepschats en vereiste vermeldingen
• Kanaalroutering - sessieroutering voor berichten
• Beveiliging - toegangsmodel en beveiliging aanscherpen