Yuanbao

Tencent Yuanbao ist Tencents Plattform für KI-Assistenten. Das von der Community gepflegte Plugin openclaw-plugin-yuanbao verbindet Yuanbao-Bots über WebSocket mit OpenClaw, um Direktnachrichten und Gruppenchats zu ermöglichen.

Status: Produktionsbereit 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 (über die Installation und die allgemeine CLI-Oberfläche hinaus) 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 die Version 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.

Zugriffssteuerung

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 gilt als implizite Erwähnung.

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 Zeitüberschreitung bei Inaktivität automatisch leeren (ms)    },  },}

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

Häufig verwendete Befehle

Yuanbao unterstützt native Menüs für Slash-Befehle. Die Befehle werden beim Start des Gateways automatisch mit der Plattform synchronisiert.

Fehlerbehebung

Der Bot antwortet nicht in Gruppenchats:

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

Der Bot empfängt keine Nachrichten:

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

Der Bot sendet leere Antworten oder Ersatzantworten:

1. Prüfen Sie, ob das KI-Modell gültige Inhalte zurückgibt
2. Standardmäßige Ersatzantwort: "暂时无法解答，你可以换个问题问问我哦"
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 den 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- und 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)    },  },}

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

Gruppenchats als Verlaufskontext

{  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.

Antwortmodus

{  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 die nicht bereinigte Protokollausgabe für die aufgeführten Bot-IDs.

Routing für mehrere Agenten

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 – Authentifizierung für Direktnachrichten und Kopplungsablauf
• Gruppen – Verhalten von Gruppenchats und Steuerung durch Erwähnungen
• Kanal-Routing – Sitzungs-Routing für Nachrichten
• Sicherheit – Zugriffsmodell und Absicherung