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 de bots y chats grupales. WebSocket es el único modo de conexión compatible. Este Plugin lo mantiene el equipo de Tencent Yuanbao como una entrada de catálogo externa, no el núcleo de OpenClaw; los detalles de configuración/comportamiento siguientes (más allá de la instalación y la superficie genérica de la CLI) provienen de la documentación propia del Plugin y no se han verificado contra el código fuente del núcleo de OpenClaw.
Inicio rápido
Requiere OpenClaw 2026.4.10 o superior. Compruébalo conopenclaw --version; actualiza con openclaw update.
Añade el canal Yuanbao con tus credenciales
--token usa appKey:appSecret separado por dos puntos. Obtén estos valores desde la aplicación Yuanbao creando un bot en la configuración de tu aplicación.Configuración interactiva (alternativa)
Control de acceso
Mensajes directos
channels.yuanbao.dm.policy:
| Valor | Comportamiento |
|---|---|
open (predeterminado) | Permite todos los usuarios |
pairing | Los usuarios desconocidos reciben un código de emparejamiento; aprueba mediante CLI |
allowlist | Solo pueden chatear los usuarios de allowFrom |
disabled | Desactiva todos los mensajes directos |
Chats grupales
channels.yuanbao.requireMention (predeterminado true): requiere una @mención antes de que el bot responda en un grupo. Responder al propio mensaje del bot se trata como una mención implícita.
Ejemplos de configuración
Configuración básica, política de mensajes directos abierta:outboundQueueStrategy: "immediate" para enviar cada fragmento sin búfer.
Comandos comunes
| Comando | Descripción |
|---|---|
/help | Muestra los comandos disponibles |
/status | Muestra el estado del bot |
/new | Inicia una sesión nueva |
/stop | Detiene la ejecución actual |
/restart | Reinicia OpenClaw |
/compact | Compacta el contexto de la sesión |
Solución de problemas
El bot no responde en chats grupales:- Confirma que el bot se haya añadido al grupo
- Confirma que @mencionas al bot (obligatorio de forma predeterminada)
- Revisa los registros:
openclaw logs --follow
- Confirma que el bot se haya creado y aprobado en la aplicación Yuanbao
- Confirma que
appKeyyappSecretestén configurados correctamente - Confirma que el gateway esté en ejecución:
openclaw gateway status - Revisa los registros:
openclaw logs --follow
- Comprueba si el modelo de IA está devolviendo contenido válido
- Respuesta de fallback predeterminada: “暂时无法解答,你可以换个问题问问我哦”
- Personaliza con
channels.yuanbao.fallbackReply
- Restablece el App Secret en la aplicación Yuanbao
- Actualiza el valor en tu configuración
- Reinicia el gateway:
openclaw gateway restart
Configuración avanzada
Varias cuentas
defaultAccount controla qué cuenta se usa cuando las API salientes no especifican un accountId.
Límites de mensajes
maxChars: número máximo de caracteres de un solo mensaje (predeterminado3000)mediaMaxMb: límite de carga/descarga de medios (predeterminado20MB)overflowPolicy: comportamiento cuando un mensaje supera el límite,"split"(predeterminado) o"stop"
Streaming
Yuanbao admite salida de streaming a nivel de bloque; el bot envía texto en fragmentos a medida que lo genera.disableBlockStreaming: true para enviar la respuesta completa en un solo mensaje.
Contexto de historial de chats grupales
Modo de respuesta a
| Valor | Comportamiento |
|---|---|
off | Sin respuesta citada |
first | Cita solo la primera respuesta por mensaje entrante (predeterminado) |
all | Cita cada respuesta |
Inyección de sugerencia de Markdown
De forma predeterminada, el bot inyecta una instrucción de prompt de sistema para impedir que el modelo envuelva toda la respuesta en un bloque de código Markdown.Modo de depuración
Enrutamiento multiagente
Usabindings para enrutar mensajes directos o grupos de Yuanbao a distintos agentes:
match.channel:"yuanbao"match.peer.kind:"direct"(mensaje directo) o"group"(chat grupal)match.peer.id: ID de usuario o código de grupo
Referencia de configuración
Configuración completa: Configuración del Gateway| Ajuste | Descripción | Predeterminado |
|---|---|---|
channels.yuanbao.enabled | Activar/desactivar el canal | true |
channels.yuanbao.defaultAccount | Cuenta predeterminada para enrutamiento saliente | default |
channels.yuanbao.accounts.<id>.appKey | App Key (firma + generación de ticket) | - |
channels.yuanbao.accounts.<id>.appSecret | App Secret (firma) | - |
channels.yuanbao.accounts.<id>.token | Token prefirmado (omite la firma automática de ticket) | - |
channels.yuanbao.accounts.<id>.name | Nombre visible de la cuenta | - |
channels.yuanbao.accounts.<id>.enabled | Activar/desactivar una cuenta específica | true |
channels.yuanbao.dm.policy | Política de mensajes directos | open |
channels.yuanbao.dm.allowFrom | Allowlist de mensajes directos (lista de IDs de usuario) | - |
channels.yuanbao.requireMention | Requerir @mención en grupos | true |
channels.yuanbao.overflowPolicy | Manejo de mensajes largos (split o stop) | split |
channels.yuanbao.replyToMode | Estrategia de respuesta a en grupo (off, first, all) | first |
channels.yuanbao.outboundQueueStrategy | Estrategia saliente (merge-text o immediate) | merge-text |
channels.yuanbao.minChars | Merge-text: caracteres mínimos para activar el envío | 2800 |
channels.yuanbao.maxChars | Merge-text: caracteres máximos por mensaje | 3000 |
channels.yuanbao.idleMs | Merge-text: tiempo de inactividad antes del auto-flush (ms) | 5000 |
channels.yuanbao.mediaMaxMb | Límite de tamaño de medios (MB) | 20 |
channels.yuanbao.historyLimit | Entradas de contexto de historial de chats grupales | 100 |
channels.yuanbao.disableBlockStreaming | Desactivar salida de streaming a nivel de bloque | false |
channels.yuanbao.fallbackReply | Respuesta de fallback cuando el modelo no devuelve contenido | 暂时无法解答,你可以换个问题问问我哦 |
channels.yuanbao.markdownHintEnabled | Inyectar instrucciones antienvoltura de Markdown | true |
channels.yuanbao.debugBotIds | IDs de bot de allowlist de depuración (registros sin sanitizar) | [] |
Tipos de mensaje compatibles
Recepción: texto, imágenes, archivos, audio/voz, video, stickers/emoji personalizados, elementos personalizados (tarjetas de enlace). Envío: texto (Markdown), imágenes, archivos, audio, video, stickers. Hilos y respuestas: respuestas citadas (configurables mediantereplyToMode); la plataforma no admite respuestas en hilos.
Relacionado
- Resumen de canales - todos los canales compatibles
- Emparejamiento - autenticación de mensajes directos y flujo de emparejamiento
- Grupos - comportamiento de chats grupales y control por mención
- Enrutamiento de canales - enrutamiento de sesiones para mensajes
- Seguridad - modelo de acceso y endurecimiento