Yuanbao

Tencent Yuanbao ist die KI-Assistentenplattform von Tencent. Das von der Community gepflegte Plugin openclaw-plugin-yuanbao verbindet Yuanbao-Bots über WebSocket mit OpenClaw und ermöglicht Direktnachrichten und Gruppenchats.

Status: produktionsreif für Bot-Direktnachrichten und Gruppenchats. WebSocket ist der einzige unterstützte Verbindungsmodus. Dieses Plugin wird vom Tencent-Yuanbao-Team als externer Katalogeintrag gepflegt, nicht vom OpenClaw-Kernteam; die nachfolgenden Konfigurations- und Verhaltensdetails (abgesehen von der Installation und der generischen CLI-Oberfläche) stammen aus der eigenen Dokumentation des Plugins und wurden nicht anhand des OpenClaw-Kernquellcodes überprüft.

Schnellstart

Erfordert OpenClaw 2026.4.10 oder höher. Prüfen Sie dies mit openclaw --version; führen Sie das Upgrade mit openclaw update durch.

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

openclaw gateway restart

Interaktive Einrichtung (Alternative)

openclaw channels login --channel yuanbao

Folgen Sie den Eingabeaufforderungen, um Ihre App ID und Ihr App Secret einzugeben.

Zugriffskontrolle

Direktnachrichten

channels.yuanbao.dm.policy:

So genehmigen Sie eine Kopplungsanfrage:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

Gruppenchats

channels.yuanbao.requireMention (Standard true): Erfordert eine @Erwähnung, bevor der Bot in einer Gruppe antwortet. Eine Antwort auf die eigene Nachricht des Bots wird als implizite Erwähnung behandelt.

Konfigurationsbeispiele

Grundlegende Einrichtung mit offener Richtlinie für Direktnachrichten:

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

Direktnachrichten auf bestimmte Benutzer beschränken:

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

Anforderung einer @Erwähnung in Gruppen deaktivieren:

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

Ausgehende Zustellung abstimmen:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // puffern, bis diese Zeichenanzahl erreicht ist      maxChars: 3000, // oberhalb dieses Grenzwerts Aufteilung erzwingen      idleMs: 5000, // nach Inaktivitätszeitüberschreitung automatisch senden (ms)    },  },}

Setzen Sie outboundQueueStrategy: "immediate", um jeden Abschnitt ohne Pufferung zu senden.

Häufig verwendete Befehle

Yuanbao unterstützt native Schrägstrichbefehlsmenüs; die Befehle werden beim Start des Gateways automatisch mit der Plattform synchronisiert.

Fehlerbehebung

Bot antwortet nicht in Gruppenchats:

1. Bestätigen Sie, dass der Bot der Gruppe hinzugefügt wurde
2. Bestätigen Sie, dass Sie den Bot mit @ erwähnen (standardmäßig erforderlich)
3. Prüfen Sie die Protokolle: openclaw logs --follow

Bot empfängt keine Nachrichten:

1. Bestätigen Sie, dass der Bot in der Yuanbao-App erstellt und genehmigt wurde
2. Bestätigen Sie, dass appKey und appSecret korrekt konfiguriert sind
3. Bestätigen Sie, dass das Gateway ausgeführt wird: openclaw gateway status
4. Prüfen Sie die Protokolle: openclaw logs --follow

Bot sendet leere Antworten oder Ausweichantworten:

1. Prüfen Sie, ob das KI-Modell gültige Inhalte zurückgibt
2. Standardmäßige Ausweichantwort: „暂时无法解答，你可以换个问题问问我哦“
3. Passen Sie sie mit channels.yuanbao.fallbackReply an

App Secret offengelegt:

1. Setzen Sie das App Secret in der Yuanbao-App zurück
2. Aktualisieren Sie den Wert in Ihrer Konfiguration
3. Starten Sie das Gateway neu: openclaw gateway restart

Erweiterte Konfiguration

Mehrere Konten

{  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 legt fest, welches Konto verwendet wird, wenn ausgehende APIs keine accountId angeben.

Nachrichtenlimits

• maxChars: maximale Zeichenanzahl einer einzelnen Nachricht (Standard 3000)
• mediaMaxMb: Limit für das Hoch-/Herunterladen von Medien (Standard 20 MB)
• overflowPolicy: Verhalten, wenn eine Nachricht das Limit überschreitet, "split" (Standard) oder "stop"

Streaming

Yuanbao unterstützt Streaming-Ausgaben auf Blockebene; der Bot sendet den Text während der Generierung abschnittsweise.

{  channels: {    yuanbao: {      disableBlockStreaming: false, // Block-Streaming aktiviert (Standard)    },  },}

Setzen Sie disableBlockStreaming: true, um die vollständige Antwort in einer einzigen Nachricht zu senden.

Verlaufskontext für Gruppenchats

{  channels: {    yuanbao: {      historyLimit: 100, // Standard: 100, zum Deaktivieren auf 0 setzen    },  },}

Legt fest, wie viele frühere Nachrichten bei Gruppenchats in den KI-Kontext aufgenommen werden.

Antwortbezugsmodus

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

Einfügen eines Markdown-Hinweises

Standardmäßig fügt der Bot dem System-Prompt eine Anweisung hinzu, die verhindert, dass das Modell die gesamte Antwort in einen Markdown-Codeblock einschließt.

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

Debug-Modus

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

Aktiviert unbereinigte Protokollausgaben für die aufgeführten Bot-IDs.

Multi-Agent-Routing

Verwenden Sie bindings, um Yuanbao-Direktnachrichten oder -Gruppen an verschiedene Agenten weiterzuleiten:

{  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" (Direktnachricht) oder "group" (Gruppenchat)
• match.peer.id: Benutzer-ID oder Gruppencode

Konfigurationsreferenz

Vollständige Konfiguration: Gateway-Konfiguration

Unterstützte Nachrichtentypen

Empfangen: Text, Bilder, Dateien, Audio/Sprachnachrichten, Video, Sticker/benutzerdefinierte Emojis, benutzerdefinierte Elemente (Linkkarten).

Senden: Text (Markdown), Bilder, Dateien, Audio, Video, Sticker.

Threads und Antworten: zitierte Antworten (über replyToMode konfigurierbar); Thread-Antworten werden von der Plattform nicht unterstützt.

Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Kopplung - DM-Authentifizierung und Kopplungsablauf
• Gruppen - Verhalten von Gruppenchats und Erwähnungsfilterung
• Kanal-Routing - Sitzungs-Routing für Nachrichten
• Sicherheit - Zugriffsmodell und Absicherung