Yuanbao

Tencent Yuanbao is het AI-assistentplatform van Tencent. De OpenClaw-kanaal-Plugin verbindt Yuanbao-bots met OpenClaw via WebSocket, zodat ze met gebruikers kunnen communiceren via directe berichten en groepschats.

Status: productiegereed voor bot-DM's + groepschats. WebSocket is de enige ondersteunde verbindingsmodus.

Snelstart

Vereist OpenClaw 2026.4.10 of hoger. Voer openclaw --version uit om dit te controleren. Werk bij met openclaw update.

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

openclaw gateway restart

Interactieve configuratie (alternatief)

Je kunt ook de interactieve wizard gebruiken:

openclaw channels login --channel yuanbao

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

Toegangscontrole

Directe berichten

Configureer dmPolicy om te bepalen wie de bot een DM kan sturen:

• "pairing" - onbekende gebruikers ontvangen een koppelingscode; keur goed via CLI
• "allowlist" - alleen gebruikers die in allowFrom staan, kunnen chatten
• "open" - alle gebruikers toestaan (standaard)
• "disabled" - alle DM's uitschakelen

Een koppelingsverzoek goedkeuren:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

Groepschats

Vermeldingsvereiste (channels.yuanbao.requireMention):

• true - @mention vereisen (standaard)
• false - reageren zonder @mention

Antwoorden op het bericht van de bot in een groepschat wordt behandeld als een impliciete vermelding.

Configuratievoorbeelden

Basisconfiguratie met open DM-beleid

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

DM's beperken tot specifieke gebruikers

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

@mention-vereiste in groepen uitschakelen

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

Uitgaande berichtbezorging optimaliseren

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

Merge-text-strategie afstemmen

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

Veelgebruikte opdrachten

Yuanbao ondersteunt native slash-command-menu's. Opdrachten worden automatisch met het platform gesynchroniseerd wanneer de gateway start.

Probleemoplossing

Bot reageert niet in groepschats

1. Zorg dat de bot aan de groep is toegevoegd
2. Zorg dat je de bot @mentiont (standaard vereist)
3. Controleer logs: openclaw logs --follow

Bot ontvangt geen berichten

1. Zorg dat de bot is gemaakt en goedgekeurd in de Yuanbao-app
2. Zorg dat appKey en appSecret correct zijn geconfigureerd
3. Zorg dat de gateway draait: openclaw gateway status
4. Controleer logs: openclaw logs --follow

Bot stuurt lege of fallback-antwoorden

1. Controleer of het AI-model geldige content retourneert
2. Het standaard fallback-antwoord is: "暂时无法解答，你可以换个问题问问我哦"
3. Pas dit aan via channels.yuanbao.fallbackReply

App Secret gelekt

1. Reset de App Secret in YuanBao APP
2. Werk de waarde in je configuratie bij
3. Herstart de gateway: 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 specificeren.

Berichtlimieten

• maxChars - maximaal aantal tekens voor één bericht (standaard: 3000 tekens)
• mediaMaxMb - upload-/downloadlimiet voor media (standaard: 20 MB)
• overflowPolicy - gedrag wanneer bericht limiet overschrijdt: "split" (standaard) of "stop"

Streaming

Yuanbao ondersteunt streaminguitvoer op blokniveau. Wanneer ingeschakeld, verzendt de bot tekst in chunks terwijl deze wordt gegenereerd.

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

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

Context van groepschatgeschiedenis

Bepaal hoeveel historische berichten worden opgenomen in de AI-context voor groepschats:

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

Reply-to-modus

Bepaal hoe de bot berichten citeert bij antwoorden in groepschats:

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

Markdown-hintinjectie

Standaard injecteert de bot instructies in de systeemprompt om te voorkomen dat het AI-model het volledige antwoord in markdown-codeblokken plaatst.

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

Debugmodus

Schakel niet-gezuiverde loguitvoer in voor specifieke bot-ID's:

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

Routing voor meerdere agents

Gebruik bindings om Yuanbao-DM's of groepen 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" },      },    },  ],}

Routingvelden:

• match.channel: "yuanbao"
• match.peer.kind: "direct" (DM) 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
• ✅ Aangepaste elementen (linkkaarten, enz.)

Verzenden

• ✅ Tekst (met markdown-ondersteuning)
• ✅ Afbeeldingen
• ✅ Bestanden
• ✅ Audio
• ✅ Video
• ✅ Stickers

Threads en antwoorden

• ✅ Citaatantwoorden (configureerbaar via replyToMode)
• ❌ Thread-antwoorden (niet ondersteund door platform)

Gerelateerd

• Kanalenoverzicht - alle ondersteunde kanalen
• Koppelen - DM-authenticatie en koppelingsflow
• Groepen - groepschatgedrag en vermeldingsgating
• Kanaalrouting - sessierouting voor berichten
• Beveiliging - toegangsmodel en hardening