Yuanbao - OpenClaw

Tencent Yuanbao ist Tencents KI-Assistentenplattform. Das OpenClaw-Kanal-Plugin verbindet Yuanbao-Bots über WebSocket mit OpenClaw, damit sie über Direktnachrichten und Gruppenchats mit Benutzern interagieren können. Status: produktionsbereit für Bot-Direktnachrichten + Gruppenchats. WebSocket ist der einzige unterstützte Verbindungsmodus.

Schnellstart

Erfordert OpenClaw 2026.4.10 oder höher. Führen Sie openclaw --version aus, um dies zu prüfen. Aktualisieren Sie mit openclaw update.

Fügen Sie den Yuanbao-Kanal mit Ihren Anmeldedaten hinzu

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

Der Wert --token verwendet das durch Doppelpunkte getrennte Format appKey:appSecret. Sie können diese Werte aus der Yuanbao-App abrufen, indem Sie in Ihren Anwendungseinstellungen einen Roboter erstellen.

Starten Sie nach Abschluss der Einrichtung den Gateway neu, um die Änderungen anzuwenden

openclaw gateway restart

Interaktive Einrichtung (Alternative)

Sie können auch den interaktiven Assistenten verwenden:

openclaw channels login --channel yuanbao

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

Zugriffskontrolle

Direktnachrichten

Konfigurieren Sie dmPolicy, um zu steuern, wer dem Bot Direktnachrichten senden kann:

"pairing" - unbekannte Benutzer erhalten einen Kopplungscode; Genehmigung über CLI
"allowlist" - nur in allowFrom aufgeführte Benutzer können chatten
"open" - alle Benutzer zulassen (Standard)
"disabled" - alle Direktnachrichten deaktivieren

Kopplungsanfrage genehmigen:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Gruppenchats

Erwähnungspflicht (channels.yuanbao.requireMention):

true - @mention erforderlich (Standard)
false - ohne @mention antworten

Das Antworten auf die Nachricht des Bots in einem Gruppenchat wird als implizite Erwähnung behandelt.

Konfigurationsbeispiele

Grundeinrichtung 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"],
      },
    },
  },
}

@mention-Pflicht in Gruppen deaktivieren

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

Zustellung ausgehender Nachrichten optimieren

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

Merge-text-Strategie abstimmen

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

Häufige Befehle

Befehl	Beschreibung
`/help`	Verfügbare Befehle anzeigen
`/status`	Bot-Status anzeigen
`/new`	Eine neue Sitzung starten
`/stop`	Den aktuellen Lauf stoppen
`/restart`	OpenClaw neu starten
`/compact`	Sitzungskontext komprimieren

Yuanbao unterstützt native Slash-Command-Menüs. Befehle werden beim Start des Gateway automatisch mit der Plattform synchronisiert.

Fehlerbehebung

Bot antwortet in Gruppenchats nicht

Stellen Sie sicher, dass der Bot zur Gruppe hinzugefügt wurde
Stellen Sie sicher, dass Sie den Bot per @mention erwähnen (standardmäßig erforderlich)
Protokolle prüfen: openclaw logs --follow

Bot empfängt keine Nachrichten

Stellen Sie sicher, dass der Bot in der Yuanbao-App erstellt und genehmigt wurde
Stellen Sie sicher, dass appKey und appSecret korrekt konfiguriert sind
Stellen Sie sicher, dass der Gateway ausgeführt wird: openclaw gateway status
Protokolle prüfen: openclaw logs --follow

Bot sendet leere oder Fallback-Antworten

Prüfen Sie, ob das KI-Modell gültige Inhalte zurückgibt
Die standardmäßige Fallback-Antwort lautet: “暂时无法解答，你可以换个问题问问我哦”
Passen Sie sie über channels.yuanbao.fallbackReply an

App Secret offengelegt

Setzen Sie das App Secret in der YuanBao APP zurück
Aktualisieren Sie den Wert in Ihrer Konfiguration
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 steuert, welches Konto verwendet wird, wenn ausgehende APIs kein accountId angeben.

Nachrichtenlimits

maxChars - maximale Zeichenanzahl für eine einzelne Nachricht (Standard: 3000 Zeichen)
mediaMaxMb - Limit für Medien-Upload/-Download (Standard: 20 MB)
overflowPolicy - Verhalten, wenn die Nachricht das Limit überschreitet: "split" (Standard) oder "stop"

Streaming

Yuanbao unterstützt Streaming-Ausgabe auf Blockebene. Wenn aktiviert, sendet der Bot Text in Blöcken, während er ihn generiert.

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

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

Gruppenchathistorie-Kontext

Steuern Sie, wie viele frühere Nachrichten für Gruppenchats in den KI-Kontext aufgenommen werden:

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

Reply-to-Modus

Steuern Sie, wie der Bot Nachrichten beim Antworten in Gruppenchats zitiert:

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

Wert	Verhalten
`"off"`	Keine Zitatantwort
`"first"`	Nur die erste Antwort pro eingehender Nachricht zitieren (Standard)
`"all"`	Jede Antwort zitieren

Markdown-Hinweis-Injektion

Standardmäßig fügt der Bot Anweisungen in den System-Prompt ein, um zu verhindern, dass das KI-Modell die gesamte Antwort in Markdown-Codeblöcke einschließt.

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

Debug-Modus

Aktivieren Sie nicht bereinigte Protokollausgabe für bestimmte Bot-IDs:

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

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" },
      },
    },
  ],
}

Routing-Felder:

match.channel: "yuanbao"
match.peer.kind: "direct" (Direktnachricht) oder "group" (Gruppenchat)
match.peer.id: Benutzer-ID oder Gruppencode

Konfigurationsreferenz

Vollständige Konfiguration: Gateway-Konfiguration

Einstellung	Beschreibung	Standard
`channels.yuanbao.enabled`	Kanal aktivieren/deaktivieren	`true`
`channels.yuanbao.defaultAccount`	Standardkonto für ausgehendes Routing	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (für Signierung und Ticketerstellung verwendet)	-
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (für Signierung verwendet)	-
`channels.yuanbao.accounts.<id>.token`	Vorab signiertes Token (überspringt automatische Ticketsignierung)	-
`channels.yuanbao.accounts.<id>.name`	Anzeigename des Kontos	-
`channels.yuanbao.accounts.<id>.enabled`	Bestimmtes Konto aktivieren/deaktivieren	`true`
`channels.yuanbao.dm.policy`	Richtlinie für Direktnachrichten	`open`
`channels.yuanbao.dm.allowFrom`	Allowlist für Direktnachrichten (Liste von Benutzer-IDs)	-
`channels.yuanbao.requireMention`	@mention in Gruppen erforderlich	`true`
`channels.yuanbao.overflowPolicy`	Verarbeitung langer Nachrichten (`split` oder `stop`)	`split`
`channels.yuanbao.replyToMode`	Reply-to-Strategie für Gruppen (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Ausgehende Strategie (`merge-text` oder `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Merge-text: Mindestanzahl Zeichen zum Auslösen des Sendens	`2800`
`channels.yuanbao.maxChars`	Merge-text: maximale Zeichen pro Nachricht	`3000`
`channels.yuanbao.idleMs`	Merge-text: Leerlauf-Timeout vor automatischem Flush (ms)	`5000`
`channels.yuanbao.mediaMaxMb`	Mediengrößenlimit (MB)	`20`
`channels.yuanbao.historyLimit`	Einträge für Gruppenchathistorie-Kontext	`100`
`channels.yuanbao.disableBlockStreaming`	Streaming-Ausgabe auf Blockebene deaktivieren	`false`
`channels.yuanbao.fallbackReply`	Fallback-Antwort, wenn die KI keinen Inhalt zurückgibt	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Markdown-Anweisungen gegen Umbruch in Codeblöcke injizieren	`true`
`channels.yuanbao.debugBotIds`	Debug-Allowlist für Bot-IDs (nicht bereinigte Protokolle)	`[]`

Unterstützte Nachrichtentypen

Empfangen

✅ Text
✅ Bilder
✅ Dateien
✅ Audio / Sprache
✅ Video
✅ Sticker / benutzerdefinierte Emoji
✅ Benutzerdefinierte Elemente (Linkkarten usw.)

Senden

✅ Text (mit Markdown-Unterstützung)
✅ Bilder
✅ Dateien
✅ Audio
✅ Video
✅ Sticker

Threads und Antworten

✅ Zitatantworten (konfigurierbar über replyToMode)
❌ Thread-Antworten (von der Plattform nicht unterstützt)

Documentation Index

​Schnellstart

​Interaktive Einrichtung (Alternative)

​Zugriffskontrolle

​Direktnachrichten

​Gruppenchats

​Konfigurationsbeispiele

​Grundeinrichtung mit offener Richtlinie für Direktnachrichten

​Direktnachrichten auf bestimmte Benutzer beschränken

​@mention-Pflicht in Gruppen deaktivieren

​Zustellung ausgehender Nachrichten optimieren

​Merge-text-Strategie abstimmen

​Häufige Befehle

​Fehlerbehebung

​Bot antwortet in Gruppenchats nicht

​Bot empfängt keine Nachrichten

​Bot sendet leere oder Fallback-Antworten

​App Secret offengelegt

​Erweiterte Konfiguration

​Mehrere Konten

​Nachrichtenlimits

​Streaming

​Gruppenchathistorie-Kontext

​Reply-to-Modus

​Markdown-Hinweis-Injektion

​Debug-Modus

​Multi-Agent-Routing

​Konfigurationsreferenz

​Unterstützte Nachrichtentypen

​Empfangen

​Senden

​Threads und Antworten

​Verwandte Themen