Yuanbao

Tencent Yuanbao è la piattaforma di assistente AI di Tencent. Il Plugin del canale OpenClaw connette i bot Yuanbao a OpenClaw tramite WebSocket, così possono interagire con gli utenti attraverso messaggi diretti e chat di gruppo.

Stato: pronto per la produzione per DM dei bot + chat di gruppo. WebSocket è l'unica modalità di connessione supportata.

# Avvio rapido

Richiede OpenClaw 2026.4.10 o versione successiva. Esegui openclaw --version per controllare. Aggiorna con openclaw update.

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

openclaw gateway restart

# Configurazione interattiva (alternativa)

Puoi anche usare la procedura guidata interattiva:

openclaw channels login --channel yuanbao

Segui le istruzioni per inserire il tuo App ID e App Secret.

# Controllo degli accessi

# Messaggi diretti

Configura dmPolicy per controllare chi può inviare DM al bot:

• "pairing" - gli utenti sconosciuti ricevono un codice di abbinamento; approva tramite CLI
• "allowlist" - solo gli utenti elencati in allowFrom possono chattare
• "open" - consenti tutti gli utenti (predefinito)
• "disabled" - disabilita tutti i DM

Approva una richiesta di abbinamento:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

# Chat di gruppo

Requisito di menzione (channels.yuanbao.requireMention):

• true - richiede @menzione (predefinito)
• false - risponde senza @menzione

Rispondere al messaggio del bot in una chat di gruppo viene trattato come una menzione implicita.

# Esempi di configurazione

# Configurazione di base con criterio DM aperto

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

# Limita i DM a utenti specifici

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

# Disabilita il requisito di @menzione nei gruppi

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

# Ottimizza la consegna dei messaggi in uscita

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

# Regola la strategia merge-text

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

# Comandi comuni

Yuanbao supporta menu nativi per comandi slash. I comandi vengono sincronizzati automaticamente con la piattaforma all'avvio del Gateway.

# Risoluzione dei problemi

# Il bot non risponde nelle chat di gruppo

1. Assicurati che il bot sia aggiunto al gruppo
2. Assicurati di @menzionare il bot (richiesto per impostazione predefinita)
3. Controlla i log: openclaw logs --follow

# Il bot non riceve messaggi

1. Assicurati che il bot sia creato e approvato nell'app Yuanbao
2. Assicurati che appKey e appSecret siano configurati correttamente
3. Assicurati che il Gateway sia in esecuzione: openclaw gateway status
4. Controlla i log: openclaw logs --follow

# Il bot invia risposte vuote o di fallback

1. Controlla se il modello AI restituisce contenuti validi
2. La risposta di fallback predefinita è: "暂时无法解答，你可以换个问题问问我哦"
3. Personalizzala tramite channels.yuanbao.fallbackReply

# App Secret trapelato

1. Reimposta l'App Secret in YuanBao APP
2. Aggiorna il valore nella tua configurazione
3. Riavvia il Gateway: openclaw gateway restart

# Configurazione avanzata

# Account multipli

{
  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 controlla quale account viene usato quando le API in uscita non specificano un accountId.

# Limiti dei messaggi

• maxChars - numero massimo di caratteri per singolo messaggio (predefinito: 3000 caratteri)
• mediaMaxMb - limite di upload/download dei media (predefinito: 20 MB)
• overflowPolicy - comportamento quando il messaggio supera il limite: "split" (predefinito) o "stop"

# Streaming

Yuanbao supporta l'output in streaming a livello di blocco. Quando è abilitato, il bot invia testo a blocchi mentre lo genera.

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

Imposta disableBlockStreaming: true per inviare la risposta completa in un unico messaggio.

# Contesto della cronologia delle chat di gruppo

Controlla quanti messaggi storici sono inclusi nel contesto AI per le chat di gruppo:

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

# Modalità reply-to

Controlla come il bot cita i messaggi quando risponde nelle chat di gruppo:

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

# Iniezione di suggerimento Markdown

Per impostazione predefinita, il bot inietta istruzioni nel prompt di sistema per impedire al modello AI di racchiudere l'intera risposta in blocchi di codice markdown.

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

# Modalità debug

Abilita l'output di log non sanificato per ID bot specifici:

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

# Routing multi-agente

Usa bindings per instradare DM o gruppi Yuanbao ad agenti diversi.

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

Campi di routing:

• match.channel: "yuanbao"
• match.peer.kind: "direct" (DM) o "group" (chat di gruppo)
• match.peer.id: ID utente o codice gruppo

# Riferimento di configurazione

Configurazione completa: Configurazione del Gateway

# Tipi di messaggio supportati

# Ricezione

• ✅ Testo
• ✅ Immagini
• ✅ File
• ✅ Audio / Voce
• ✅ Video
• ✅ Sticker / Emoji personalizzate
• ✅ Elementi personalizzati (schede link, ecc.)

# Invio

• ✅ Testo (con supporto markdown)
• ✅ Immagini
• ✅ File
• ✅ Audio
• ✅ Video
• ✅ Sticker

# Thread e risposte

• ✅ Risposte con citazione (configurabili tramite replyToMode)
• ❌ Risposte nei thread (non supportate dalla piattaforma)

# Correlati

• Panoramica dei canali - tutti i canali supportati
• Abbinamento - autenticazione DM e flusso di abbinamento
• Gruppi - comportamento delle chat di gruppo e gate sulle menzioni
• Routing dei canali - routing di sessione per i messaggi
• Sicurezza - modello di accesso e hardening