Yuanbao

Tencent Yuanbao é a plataforma de assistente de IA da Tencent. O plugin de canal do OpenClaw conecta bots do Yuanbao ao OpenClaw via WebSocket para que eles possam interagir com usuários por mensagens diretas e chats em grupo. Status: pronto para produção para DMs de bot + chats em grupo. WebSocket é o único modo de conexão compatível.

Início rápido

Requer OpenClaw 2026.4.10 ou superior. Execute openclaw --version para verificar. Atualize com openclaw update.

Adicione o canal Yuanbao com suas credenciais

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

O valor de --token usa o formato appKey:appSecret separado por dois-pontos. Você pode obter esses dados no aplicativo Yuanbao criando um robô nas configurações da sua aplicação.

Depois que a configuração for concluída, reinicie o gateway para aplicar as alterações

openclaw gateway restart

Configuração interativa (alternativa)

Você também pode usar o assistente interativo:

openclaw channels login --channel yuanbao

Siga as instruções para inserir seu App ID e App Secret.

Controle de acesso

Mensagens diretas

Configure dmPolicy para controlar quem pode enviar DM ao bot:

"pairing" — usuários desconhecidos recebem um código de pareamento; aprove via CLI
"allowlist" — somente usuários listados em allowFrom podem conversar
"open" — permite todos os usuários (padrão)
"disabled" — desativa todas as DMs

Aprovar uma solicitação de pareamento:

openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Chats em grupo

Exigência de menção (channels.yuanbao.requireMention):

true — exige @menção (padrão)
false — responde sem @menção

Responder à mensagem do bot em um chat em grupo é tratado como uma menção implícita.

Exemplos de configuração

Configuração básica com política de DM aberta

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

Restringir DMs a usuários específicos

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

Desativar a exigência de @menção em grupos

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

Otimizar a entrega de mensagens de saída

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

Ajustar a estratégia 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)
    },
  },
}

Comandos comuns

Comando	Descrição
`/help`	Mostra os comandos disponíveis
`/status`	Mostra o status do bot
`/new`	Inicia uma nova sessão
`/stop`	Interrompe a execução atual
`/restart`	Reinicia o OpenClaw
`/compact`	Compacta o contexto da sessão

Yuanbao oferece suporte a menus nativos de comandos com barra. Os comandos são sincronizados automaticamente com a plataforma quando o gateway inicia.

Solução de problemas

O bot não responde em chats em grupo

Verifique se o bot foi adicionado ao grupo
Verifique se você @mencionou o bot (obrigatório por padrão)
Verifique os logs: openclaw logs --follow

O bot não recebe mensagens

Verifique se o bot foi criado e aprovado no aplicativo Yuanbao
Verifique se appKey e appSecret estão configurados corretamente
Verifique se o gateway está em execução: openclaw gateway status
Verifique os logs: openclaw logs --follow

O bot envia respostas vazias ou de fallback

Verifique se o modelo de IA está retornando conteúdo válido
A resposta de fallback padrão é: “暂时无法解答，你可以换个问题问问我哦”
Personalize-a via channels.yuanbao.fallbackReply

App Secret vazado

Redefina o App Secret no YuanBao APP
Atualize o valor na sua configuração
Reinicie o gateway: openclaw gateway restart

Configuração avançada

Várias contas

{
  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 qual conta é usada quando as APIs de saída não especificam um accountId.

Limites de mensagens

maxChars — contagem máxima de caracteres em uma única mensagem (padrão: 3000 caracteres)
mediaMaxMb — limite de upload/download de mídia (padrão: 20 MB)
overflowPolicy — comportamento quando a mensagem excede o limite: "split" (padrão) ou "stop"

Streaming

Yuanbao oferece suporte a saída de streaming em nível de bloco. Quando ativado, o bot envia texto em partes conforme ele gera.

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

Defina disableBlockStreaming: true para enviar a resposta completa em uma mensagem.

Contexto do histórico de chats em grupo

Controle quantas mensagens históricas são incluídas no contexto de IA para chats em grupo:

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

Modo reply-to

Controle como o bot cita mensagens ao responder em chats em grupo:

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

Valor	Comportamento
`"off"`	Sem resposta citada
`"first"`	Cita apenas a primeira resposta por mensagem recebida (padrão)
`"all"`	Cita todas as respostas

Injeção de dica de Markdown

Por padrão, o bot injeta instruções no prompt do sistema para impedir que o modelo de IA envolva toda a resposta em blocos de código markdown.

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

Modo de depuração

Ative a saída de logs não sanitizados para IDs de bot específicos:

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

Roteamento multiagente

Use bindings para rotear DMs ou grupos do Yuanbao para agentes diferentes.

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

Campos de roteamento:

match.channel: "yuanbao"
match.peer.kind: "direct" (DM) ou "group" (chat em grupo)
match.peer.id: ID de usuário ou código do grupo

Referência de configuração

Configuração completa: Configuração do Gateway

Configuração	Descrição	Padrão
`channels.yuanbao.enabled`	Ativa/desativa o canal	`true`
`channels.yuanbao.defaultAccount`	Conta padrão para roteamento de saída	`default`
`channels.yuanbao.accounts.<id>.appKey`	App Key (usada para assinatura e geração de ticket)	—
`channels.yuanbao.accounts.<id>.appSecret`	App Secret (usada para assinatura)	—
`channels.yuanbao.accounts.<id>.token`	Token pré-assinado (ignora a assinatura automática de ticket)	—
`channels.yuanbao.accounts.<id>.name`	Nome de exibição da conta	—
`channels.yuanbao.accounts.<id>.enabled`	Ativa/desativa uma conta específica	`true`
`channels.yuanbao.dm.policy`	Política de DM	`open`
`channels.yuanbao.dm.allowFrom`	Allowlist de DM (lista de IDs de usuário)	—
`channels.yuanbao.requireMention`	Exige @menção em grupos	`true`
`channels.yuanbao.overflowPolicy`	Tratamento de mensagens longas (`split` ou `stop`)	`split`
`channels.yuanbao.replyToMode`	Estratégia de reply-to em grupo (`off`, `first`, `all`)	`first`
`channels.yuanbao.outboundQueueStrategy`	Estratégia de saída (`merge-text` ou `immediate`)	`merge-text`
`channels.yuanbao.minChars`	Merge-text: caracteres mínimos para acionar envio	`2800`
`channels.yuanbao.maxChars`	Merge-text: caracteres máximos por mensagem	`3000`
`channels.yuanbao.idleMs`	Merge-text: tempo limite de ociosidade antes de auto-flush (ms)	`5000`
`channels.yuanbao.mediaMaxMb`	Limite de tamanho de mídia (MB)	`20`
`channels.yuanbao.historyLimit`	Entradas de contexto do histórico de chats em grupo	`100`
`channels.yuanbao.disableBlockStreaming`	Desativa a saída de streaming em nível de bloco	`false`
`channels.yuanbao.fallbackReply`	Resposta de fallback quando a IA não retorna conteúdo	`暂时无法解答，你可以换个问题问问我哦`
`channels.yuanbao.markdownHintEnabled`	Injeta instruções anti-encapsulamento em markdown	`true`
`channels.yuanbao.debugBotIds`	IDs de bot na whitelist de depuração (logs não sanitizados)	`[]`

Tipos de mensagem compatíveis

Receber

✅ Texto
✅ Imagens
✅ Arquivos
✅ Áudio / Voz
✅ Vídeo
✅ Figurinhas / Emoji personalizado
✅ Elementos personalizados (cartões de link etc.)

Enviar

✅ Texto (com suporte a markdown)
✅ Imagens
✅ Arquivos
✅ Áudio
✅ Vídeo
✅ Figurinhas

Threads e respostas

✅ Respostas citadas (configurável via replyToMode)
❌ Respostas em thread (não compatíveis com a plataforma)

Relacionado

Visão geral dos canais — todos os canais compatíveis
Pareamento — autenticação de DM e fluxo de pareamento
Grupos — comportamento de chats em grupo e controle por menção
Roteamento de canais — roteamento de sessão para mensagens
Segurança — modelo de acesso e hardening

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Yuanbao

Yuanbao

Início rápido

Configuração interativa (alternativa)

Controle de acesso

Mensagens diretas

Chats em grupo

Exemplos de configuração

Configuração básica com política de DM aberta

Restringir DMs a usuários específicos

Desativar a exigência de @menção em grupos

Otimizar a entrega de mensagens de saída

Ajustar a estratégia merge-text

Comandos comuns

Solução de problemas

O bot não responde em chats em grupo

O bot não recebe mensagens

O bot envia respostas vazias ou de fallback

App Secret vazado

Configuração avançada

Várias contas

Limites de mensagens

Streaming

Contexto do histórico de chats em grupo

Modo reply-to

Injeção de dica de Markdown

Modo de depuração

Roteamento multiagente

Referência de configuração

Tipos de mensagem compatíveis

Receber

Enviar

Threads e respostas

Relacionado

Overview

Mainstream messaging

Developer and self-hosted

Regional platforms

Configuration

Documentation Index

​Yuanbao

​Início rápido

​Configuração interativa (alternativa)

​Controle de acesso

​Mensagens diretas

​Chats em grupo

​Exemplos de configuração

​Configuração básica com política de DM aberta

​Restringir DMs a usuários específicos

​Desativar a exigência de @menção em grupos

​Otimizar a entrega de mensagens de saída

​Ajustar a estratégia merge-text

​Comandos comuns

​Solução de problemas

​O bot não responde em chats em grupo

​O bot não recebe mensagens

​O bot envia respostas vazias ou de fallback

​App Secret vazado

​Configuração avançada

​Várias contas

​Limites de mensagens

​Streaming

​Contexto do histórico de chats em grupo

​Modo reply-to

​Injeção de dica de Markdown

​Modo de depuração

​Roteamento multiagente

​Referência de configuração

​Tipos de mensagem compatíveis

​Receber

​Enviar

​Threads e respostas

​Relacionado

Yuanbao

Início rápido

Configuração interativa (alternativa)

Controle de acesso

Mensagens diretas

Chats em grupo

Exemplos de configuração

Configuração básica com política de DM aberta

Restringir DMs a usuários específicos

Desativar a exigência de @menção em grupos

Otimizar a entrega de mensagens de saída

Ajustar a estratégia merge-text

Comandos comuns

Solução de problemas

O bot não responde em chats em grupo

O bot não recebe mensagens

O bot envia respostas vazias ou de fallback

App Secret vazado

Configuração avançada

Várias contas

Limites de mensagens

Streaming

Contexto do histórico de chats em grupo

Modo reply-to

Injeção de dica de Markdown

Modo de depuração

Roteamento multiagente

Referência de configuração

Tipos de mensagem compatíveis

Receber

Enviar

Threads e respostas

Relacionado