Yuanbao

Tencent Yuanbao est la plateforme d’assistant IA de Tencent. Le Plugin de canal OpenClaw connecte les bots Yuanbao à OpenClaw via WebSocket afin qu’ils puissent interagir avec les utilisateurs dans des messages directs et des discussions de groupe.

État : prêt pour la production pour les DM de bot et les discussions de groupe. WebSocket est le seul mode de connexion pris en charge.

# Démarrage rapide

Nécessite OpenClaw 2026.4.10 ou version ultérieure. Exécutez openclaw --version pour vérifier. Mettez à niveau avec openclaw update.

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

openclaw gateway restart

# Configuration interactive (alternative)

Vous pouvez aussi utiliser l’assistant interactif :

openclaw channels login --channel yuanbao

Suivez les invites pour saisir votre ID d’app et votre secret d’app.

# Contrôle d’accès

# Messages directs

Configurez dmPolicy pour contrôler qui peut envoyer un DM au bot :

• "pairing" - les utilisateurs inconnus reçoivent un code d’appairage ; approuvez via la CLI
• "allowlist" - seuls les utilisateurs listés dans allowFrom peuvent discuter
• "open" - autorise tous les utilisateurs (par défaut)
• "disabled" - désactive tous les DM

Approuver une demande d’appairage :

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

# Discussions de groupe

Exigence de mention (channels.yuanbao.requireMention) :

• true - exige une @mention (par défaut)
• false - répond sans @mention

Répondre au message du bot dans une discussion de groupe est traité comme une mention implicite.

# Exemples de configuration

# Configuration de base avec une politique de DM ouverte

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

# Restreindre les DM à des utilisateurs spécifiques

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

# Désactiver l’exigence de @mention dans les groupes

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

# Optimiser la livraison des messages sortants

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

# Ajuster la stratégie 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)
    },
  },
}

# Commandes courantes

Yuanbao prend en charge les menus natifs de commandes slash. Les commandes sont synchronisées automatiquement avec la plateforme au démarrage du Gateway.

# Dépannage

# Le bot ne répond pas dans les discussions de groupe

1. Vérifiez que le bot est ajouté au groupe
2. Vérifiez que vous @mentionnez le bot (requis par défaut)
3. Consultez les journaux : openclaw logs --follow

# Le bot ne reçoit pas les messages

1. Vérifiez que le bot est créé et approuvé dans l’app Yuanbao
2. Vérifiez que appKey et appSecret sont correctement configurés
3. Vérifiez que le Gateway est en cours d’exécution : openclaw gateway status
4. Consultez les journaux : openclaw logs --follow

# Le bot envoie des réponses vides ou de secours

1. Vérifiez si le modèle d’IA renvoie du contenu valide
2. La réponse de secours par défaut est : "暂时无法解答，你可以换个问题问问我哦"
3. Personnalisez-la via channels.yuanbao.fallbackReply

# Secret d’app divulgué

1. Réinitialisez le secret d’app dans YuanBao APP
2. Mettez à jour la valeur dans votre configuration
3. Redémarrez le Gateway : openclaw gateway restart

# Configuration avancée

# Comptes multiples

{
  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 contrôle le compte utilisé lorsque les API sortantes ne spécifient pas d’accountId.

# Limites de messages

• maxChars - nombre maximal de caractères pour un seul message (par défaut : 3000 caractères)
• mediaMaxMb - limite d’envoi/téléchargement de médias (par défaut : 20 Mo)
• overflowPolicy - comportement lorsque le message dépasse la limite : "split" (par défaut) ou "stop"

# Streaming

Yuanbao prend en charge la sortie en Streaming au niveau des blocs. Lorsqu’elle est activée, le bot envoie le texte par segments au fur et à mesure de sa génération.

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

Définissez disableBlockStreaming: true pour envoyer la réponse complète dans un seul message.

# Contexte d’historique des discussions de groupe

Contrôlez le nombre de messages historiques inclus dans le contexte IA pour les discussions de groupe :

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

# Mode de réponse à

Contrôlez la façon dont le bot cite les messages lorsqu’il répond dans les discussions de groupe :

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

# Injection d’indice Markdown

Par défaut, le bot injecte des instructions dans l’invite système pour empêcher le modèle d’IA d’envelopper toute la réponse dans des blocs de code markdown.

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

# Mode de débogage

Activez la sortie de journal non assainie pour des ID de bots spécifiques :

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

# Routage multi-agent

Utilisez bindings pour router les DM ou groupes Yuanbao vers différents agents.

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

Champs de routage :

• match.channel : "yuanbao"
• match.peer.kind : "direct" (DM) ou "group" (discussion de groupe)
• match.peer.id : ID utilisateur ou code de groupe

# Référence de configuration

Configuration complète : Configuration du Gateway

# Types de messages pris en charge

# Réception

• ✅ Texte
• ✅ Images
• ✅ Fichiers
• ✅ Audio / Voix
• ✅ Vidéo
• ✅ Stickers / Émojis personnalisés
• ✅ Éléments personnalisés (cartes de liens, etc.)

# Envoi

• ✅ Texte (avec prise en charge markdown)
• ✅ Images
• ✅ Fichiers
• ✅ Audio
• ✅ Vidéo
• ✅ Stickers

# Fils et réponses

• ✅ Réponses citées (configurables via replyToMode)
• ❌ Réponses de fil (non prises en charge par la plateforme)

# Liens connexes

• Vue d’ensemble des canaux - tous les canaux pris en charge
• Appairage - authentification DM et flux d’appairage
• Groupes - comportement des discussions de groupe et contrôle par mention
• Routage des canaux - routage de session pour les messages
• Sécurité - modèle d’accès et renforcement