--- read_when: - Sie möchten einen Yuanbao-Bot verbinden - Sie konfigurieren den Yuanbao-Kanal summary: Überblick, Funktionen und Konfiguration des Yuanbao-Bots title: Yuanbao x-i18n: generated_at: "2026-07-12T01:28:13Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 43488834f588530206b290cb0fb185fd1fe2e1f214ab4a4ccccc49b9b549b6ac source_path: channels/yuanbao.md workflow: 16 --- 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. ```bash openclaw channels add --channel yuanbao --token "appKey:appSecret" ``` `--token` verwendet das durch einen Doppelpunkt getrennte Format `appKey:appSecret`. Sie erhalten diese Werte aus der Yuanbao-App, indem Sie in Ihren Anwendungseinstellungen einen Bot erstellen. ```bash openclaw gateway restart ``` ### Interaktive Einrichtung (Alternative) ```bash openclaw channels login --channel yuanbao ``` Folgen Sie den Eingabeaufforderungen, um Ihre App-ID und Ihr App Secret einzugeben. ## Zugriffssteuerung ### Direktnachrichten `channels.yuanbao.dm.policy`: | Wert | Verhalten | | ---------------- | ---------------------------------------------------------------- | | `open` (Standard) | Alle Benutzer zulassen | | `pairing` | Unbekannte Benutzer erhalten einen Kopplungscode; Freigabe per CLI | | `allowlist` | Nur Benutzer in `allowFrom` können chatten | | `disabled` | Alle Direktnachrichten deaktivieren | So genehmigen Sie eine Kopplungsanfrage: ```bash openclaw pairing list yuanbao openclaw pairing approve yuanbao ``` ### 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: ```json5 { channels: { yuanbao: { appKey: "your_app_key", appSecret: "your_app_secret", dm: { policy: "open", }, }, }, } ``` Direktnachrichten auf bestimmte Benutzer beschränken: ```json5 { 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: ```json5 { channels: { yuanbao: { requireMention: false, }, }, } ``` Ausgehende Zustellung abstimmen: ```json5 { 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 | Befehl | Beschreibung | | ---------- | ---------------------------------- | | `/help` | Verfügbare Befehle anzeigen | | `/status` | Bot-Status anzeigen | | `/new` | Neue Sitzung starten | | `/stop` | Aktuellen Lauf beenden | | `/restart` | OpenClaw neu starten | | `/compact` | Sitzungskontext komprimieren | 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 ```json5 { 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. ```json5 { 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 ```json5 { 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 ```json5 { channels: { yuanbao: { replyToMode: "first", // "off" | "first" | "all" (Standard: "first") }, }, } ``` | Wert | Verhalten | | ------- | ------------------------------------------------------------------ | | `off` | Keine zitierte Antwort | | `first` | Nur die erste Antwort je eingehender Nachricht zitieren (Standard) | | `all` | Jede Antwort zitieren | ### 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. ```json5 { channels: { yuanbao: { markdownHintEnabled: true, // Standard: true }, }, } ``` ### Debug-Modus ```json5 { 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: ```json5 { 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](/de/gateway/configuration) | Einstellung | Beschreibung | Standard | | ------------------------------------------ | ------------------------------------------------------------------ | -------------------------------------- | | `channels.yuanbao.enabled` | Kanal aktivieren/deaktivieren | `true` | | `channels.yuanbao.defaultAccount` | Standardkonto für ausgehendes Routing | `default` | | `channels.yuanbao.accounts..appKey` | App Key (Signierung und Ticketgenerierung) | - | | `channels.yuanbao.accounts..appSecret` | App Secret (Signierung) | - | | `channels.yuanbao.accounts..token` | Vorsigniertes Token (überspringt die automatische Ticketsignierung) | - | | `channels.yuanbao.accounts..name` | Anzeigename des Kontos | - | | `channels.yuanbao.accounts..enabled` | Bestimmtes Konto aktivieren/deaktivieren | `true` | | `channels.yuanbao.dm.policy` | Richtlinie für Direktnachrichten | `open` | | `channels.yuanbao.dm.allowFrom` | Zulassungsliste für Direktnachrichten (Liste von Benutzer-IDs) | - | | `channels.yuanbao.requireMention` | @Erwähnung in Gruppen erforderlich | `true` | | `channels.yuanbao.overflowPolicy` | Behandlung langer Nachrichten (`split` oder `stop`) | `split` | | `channels.yuanbao.replyToMode` | Gruppen-Antwortstrategie (`off`, `first`, `all`) | `first` | | `channels.yuanbao.outboundQueueStrategy` | Strategie für ausgehende Nachrichten (`merge-text` oder `immediate`) | `merge-text` | | `channels.yuanbao.minChars` | Zusammengeführter Text: Mindestzeichenanzahl zum Auslösen des Sendens | `2800` | | `channels.yuanbao.maxChars` | Zusammengeführter Text: maximale Zeichenanzahl je Nachricht | `3000` | | `channels.yuanbao.idleMs` | Zusammengeführter Text: Inaktivitätszeit bis zum automatischen Leeren (ms) | `5000` | | `channels.yuanbao.mediaMaxMb` | Größenlimit für Medien (MB) | `20` | | `channels.yuanbao.historyLimit` | Anzahl der Gruppenchateinträge im Verlaufskontext | `100` | | `channels.yuanbao.disableBlockStreaming` | Streaming-Ausgabe auf Blockebene deaktivieren | `false` | | `channels.yuanbao.fallbackReply` | Ersatzantwort, wenn das Modell keine Inhalte zurückgibt | `暂时无法解答，你可以换个问题问问我哦` | | `channels.yuanbao.markdownHintEnabled` | Markdown-Anweisungen gegen vollständige Codeblock-Einschließung einfügen | `true` | | `channels.yuanbao.debugBotIds` | Bot-ID-Zulassungsliste für Debugging (nicht bereinigte Protokolle) | `[]` | ## 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](/de/channels) – alle unterstützten Kanäle - [Kopplung](/de/channels/pairing) – Authentifizierung für Direktnachrichten und Kopplungsablauf - [Gruppen](/de/channels/groups) – Verhalten von Gruppenchats und Steuerung durch Erwähnungen - [Kanal-Routing](/de/channels/channel-routing) – Sitzungs-Routing für Nachrichten - [Sicherheit](/de/gateway/security) – Zugriffsmodell und Absicherung