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 yuanbao
openclaw 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