Yuanbao

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.

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

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

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

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

# Bot empfängt keine Nachrichten

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

# Bot sendet leere oder Fallback-Antworten

1. Prüfen Sie, ob das KI-Modell gültige Inhalte zurückgibt
2. Die standardmäßige Fallback-Antwort lautet: "暂时无法解答，你可以换个问题问问我哦"
3. Passen Sie sie über 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 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")
    },
  },
}

# 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

# 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)

# Verwandte Themen

• Kanalübersicht - alle unterstützten Kanäle
• Kopplung - Authentifizierung für Direktnachrichten und Kopplungsablauf
• Gruppen - Gruppenchatverhalten und Erwähnungsgating
• Kanal-Routing - Sitzungsrouting für Nachrichten
• Sicherheit - Zugriffsmodell und Härtung