Yuanbao

Yuanbao

Tencent Yuanbao is Tencent's AI assistant platform. The OpenClaw channel plugin connects Yuanbao bots to OpenClaw over WebSocket so they can interact with users through direct messages and group chats.

Status: production-ready for bot DMs + group chats. WebSocket is the only supported connection mode.

Quick start

text
Copy
The `--token` value uses colon-separated `appKey:appSecret` format. You can obtain these from the Yuanbao app by creating a robot in your application settings.

Interactive setup (alternative)

You can also use the interactive wizard:

bash
Copy
openclaw channels login --channel yuanbao

Follow the prompts to enter your App ID and App Secret.

Access control

Direct messages

Configure

• text

  Copy

  "pairing"
  — unknown users receive a pairing code; approve via CLI
• text

  Copy

  "allowlist"
  — only users listed in
  text

  Copy

  allowFrom
  can chat
• text

  Copy

  "open"
  — allow all users (default)
• text

  Copy

  "disabled"
  — disable all DMs

Approve a pairing request:

bash
Copy
openclaw pairing list yuanbao
openclaw pairing approve yuanbao <CODE>

Group chats

Mention requirement (

• text

  Copy

  true
  — require @mention (default)
• text

  Copy

  false
  — respond without @mention

Replying to the bot's message in a group chat is treated as an implicit mention.

Configuration examples

Basic setup with open DM policy

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

Restrict DMs to specific users

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

Disable @mention requirement in groups

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

Optimize outbound message delivery

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

Tune merge-text strategy

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

Common commands

Troubleshooting

Bot does not respond in group chats

1. Ensure the bot is added to the group
2. Ensure you @mention the bot (required by default)
3. Check logs:
   text

   Copy

   openclaw logs --follow

Bot does not receive messages

1. Ensure the bot is created and approved in the Yuanbao app
2. Ensure
   text

   Copy

   appKey
   and
   text

   Copy

   appSecret
   are correctly configured
3. Ensure the gateway is running:
   text

   Copy

   openclaw gateway status
4. Check logs:
   text

   Copy

   openclaw logs --follow

Bot sends empty or fallback replies

1. Check if the AI model is returning valid content
2. The default fallback reply is: "暂时无法解答，你可以换个问题问问我哦"
3. Customize it via
   text

   Copy

   channels.yuanbao.fallbackReply

App Secret leaked

1. Reset the App Secret in YuanBao APP
2. Update the value in your config
3. Restart the gateway:
   text

   Copy

   openclaw gateway restart

Advanced configuration

Multiple accounts

json5
Copy
{
  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,
        },
      },
    },
  },
}

Message limits

• text

  Copy

  maxChars
  — single message max character count (default:
  text

  Copy

  3000
  chars)
• text

  Copy

  mediaMaxMb
  — media upload/download limit (default:
  text

  Copy

  20
  MB)
• text

  Copy

  overflowPolicy
  — behavior when message exceeds limit:
  text

  Copy

  "split"
  (default) or
  text

  Copy

  "stop"

Streaming

Yuanbao supports block-level streaming output. When enabled, the bot sends text in chunks as it generates.

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

Set

Group chat history context

Control how many historical messages are included in the AI context for group chats:

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

Reply-to mode

Control how the bot quotes messages when replying in group chats:

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

Markdown hint injection

By default, the bot injects instructions in the system prompt to prevent the AI model from wrapping the entire reply in markdown code blocks.

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

Debug mode

Enable unsanitized log output for specific bot IDs:

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

Multi-agent routing

Use

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

Routing fields:

• text

  Copy

  match.channel
  :
  text

  Copy

  "yuanbao"
• text

  Copy

  match.peer.kind
  :
  text

  Copy

  "direct"
  (DM) or
  text

  Copy

  "group"
  (group chat)
• text

  Copy

  match.peer.id
  : user ID or group code

Configuration reference

Full configuration: Gateway configuration

Supported message types

Receive

• ✅ Text
• ✅ Images
• ✅ Files
• ✅ Audio / Voice
• ✅ Video
• ✅ Stickers / Custom emoji
• ✅ Custom elements (link cards, etc.)

Send

• ✅ Text (with markdown support)
• ✅ Images
• ✅ Files
• ✅ Audio
• ✅ Video
• ✅ Stickers

Threads and replies

• ✅ Quote replies (configurable via
  text

  Copy

  replyToMode
  )
• ❌ Thread replies (not supported by platform)

Related

• Channels Overview — all supported channels
• Pairing — DM authentication and pairing flow
• Groups — group chat behavior and mention gating
• Channel Routing — session routing for messages
• Security — access model and hardening