Yuanbao

Tencent Yuanbao es la plataforma de asistente de IA de Tencent. El plugin openclaw-plugin-yuanbao, mantenido por la comunidad, conecta bots de Yuanbao con OpenClaw mediante WebSocket para mensajes directos y chats grupales.

Estado: listo para producción para mensajes directos a bots y chats grupales. WebSocket es el único modo de conexión compatible. Este plugin es mantenido por el equipo de Tencent Yuanbao como una entrada de catálogo externa, no por el núcleo de OpenClaw; los detalles de configuración y comportamiento que aparecen a continuación (más allá de la instalación y la interfaz genérica de la CLI) proceden de la documentación del propio plugin y no se han verificado con el código fuente del núcleo de OpenClaw.

Inicio rápido

Requiere OpenClaw 2026.4.10 o posterior. Compruébelo con openclaw --version; actualice con openclaw update.

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

openclaw gateway restart

Configuración interactiva (alternativa)

openclaw channels login --channel yuanbao

Siga las indicaciones para introducir su ID de aplicación y su secreto de aplicación.

Control de acceso

Mensajes directos

channels.yuanbao.dm.policy:

Apruebe una solicitud de vinculación:

openclaw pairing list yuanbaoopenclaw pairing approve yuanbao <CODE>

Chats grupales

channels.yuanbao.requireMention (valor predeterminado: true): exige una @mención antes de que el bot responda en un grupo. Responder al propio mensaje del bot se considera una mención implícita.

Ejemplos de configuración

Configuración básica con una política abierta de mensajes directos:

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

Restrinja los mensajes directos a usuarios específicos:

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

Desactive el requisito de @mención en los grupos:

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

Ajuste de la entrega saliente:

{  channels: {    yuanbao: {      outboundQueueStrategy: "merge-text",      minChars: 2800, // almacenar en búfer hasta alcanzar esta cantidad de caracteres      maxChars: 3000, // forzar la división por encima de este límite      idleMs: 5000, // vaciar automáticamente tras el tiempo de espera de inactividad (ms)    },  },}

Establezca outboundQueueStrategy: "immediate" para enviar cada fragmento sin almacenamiento en búfer.

Comandos habituales

Yuanbao admite menús nativos de comandos con barra diagonal; los comandos se sincronizan automáticamente con la plataforma cuando se inicia el Gateway.

Solución de problemas

El bot no responde en los chats grupales:

1. Confirme que el bot se haya añadido al grupo
2. Confirme que haya @mencionado al bot (requerido de forma predeterminada)
3. Consulte los registros: openclaw logs --follow

El bot no recibe mensajes:

1. Confirme que el bot se haya creado y aprobado en la aplicación de Yuanbao
2. Confirme que appKey y appSecret estén configurados correctamente
3. Confirme que el Gateway esté en ejecución: openclaw gateway status
4. Consulte los registros: openclaw logs --follow

El bot envía respuestas vacías o de reserva:

1. Compruebe si el modelo de IA devuelve contenido válido
2. Respuesta de reserva predeterminada: "暂时无法解答，你可以换个问题问问我哦"
3. Personalícela con channels.yuanbao.fallbackReply

Se ha filtrado el secreto de aplicación:

1. Restablezca el secreto de aplicación en la aplicación de Yuanbao
2. Actualice el valor en su configuración
3. Reinicie el Gateway: openclaw gateway restart

Configuración avanzada

Varias cuentas

{  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 controla qué cuenta se utiliza cuando las API salientes no especifican un accountId.

Límites de mensajes

• maxChars: cantidad máxima de caracteres de un solo mensaje (valor predeterminado: 3000)
• mediaMaxMb: límite de carga y descarga de contenido multimedia (valor predeterminado: 20 MB)
• overflowPolicy: comportamiento cuando un mensaje supera el límite, "split" (predeterminado) o "stop"

Transmisión

Yuanbao admite salida transmitida por bloques; el bot envía el texto en fragmentos a medida que lo genera.

{  channels: {    yuanbao: {      disableBlockStreaming: false, // transmisión por bloques activada (predeterminado)    },  },}

Establezca disableBlockStreaming: true para enviar la respuesta completa en un solo mensaje.

Contexto del historial de chats grupales

{  channels: {    yuanbao: {      historyLimit: 100, // predeterminado: 100; establezca 0 para desactivarlo    },  },}

Controla cuántos mensajes históricos se incluyen en el contexto de la IA para los chats grupales.

Modo de respuesta a mensajes

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

Inyección de indicaciones para Markdown

De forma predeterminada, el bot inyecta una instrucción en el mensaje del sistema para impedir que el modelo encierre toda la respuesta en un bloque de código Markdown.

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

Modo de depuración

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

Activa la salida de registros sin depurar para los identificadores de bot indicados.

Enrutamiento multiagente

Utilice bindings para enrutar los mensajes directos o grupos de Yuanbao a distintos agentes:

{  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" (mensaje directo) o "group" (chat grupal)
• match.peer.id: identificador de usuario o código de grupo

Referencia de configuración

Configuración completa: Configuración del Gateway

Tipos de mensajes compatibles

Recepción: texto, imágenes, archivos, audio/voz, vídeo, adhesivos/emojis personalizados y elementos personalizados (tarjetas de enlace).

Envío: texto (Markdown), imágenes, archivos, audio, vídeo y adhesivos.

Hilos y respuestas: respuestas con cita (configurables mediante replyToMode); la plataforma no admite respuestas en hilos.

Contenido relacionado

• Descripción general de los canales - todos los canales compatibles
• Vinculación - autenticación de mensajes directos y flujo de vinculación
• Grupos - comportamiento de los chats grupales y control mediante menciones
• Enrutamiento de canales - enrutamiento de sesiones para mensajes
• Seguridad - modelo de acceso y refuerzo de seguridad