How to Connect OpenClaw to QQ Bot

Prerequisites

• ✓An existing OpenClaw deployment with the Gateway running (see the main OpenClaw install docs before adding channels).
• ✓A QQ Bot account with access to the QQ Bot API.
• ✓Access to the OpenClaw Gateway config so you can enable and route chat channels.

Steps

1. 1

   Understand how QQ Bot fits into OpenClaw channels

   QQ Bot is one of many messaging platforms that OpenClaw can connect to through the Gateway. It appears in the supported channels list as a bundled plugin, which means you do not install it separately.

   Knowing this upfront helps you treat QQ Bot like any other first-class channel instead of hunting for an extra package.

   textCopy

   *   [QQ Bot](https://docs.openclaw.ai/channels/qqbot) — QQ Bot API; private chat, group chat, and rich media (bundled plugin).

2. 2

   Review supported channel behavior and routing

   OpenClaw can run multiple chat channels at the same time and route messages per chat. When you add QQ Bot, it participates in the same routing and safety rules as Telegram, Slack, or WhatsApp.

   This matters if you plan to expose the same agent over several apps or need to control which chats can reach your agent.

   textCopy

   Notes
   
   *   Channels can run simultaneously; configure multiple and OpenClaw will route per chat.
   *   Group behavior varies by channel; see [Groups](https://docs.openclaw.ai/channels/groups).
   *   DM pairing and allowlists are enforced for safety; see [Security](https://docs.openclaw.ai/gateway/security).

3. 3

   Plan your QQ Bot group and DM usage

   QQ Bot supports private chat, group chat, and rich media, but group behavior in OpenClaw varies by channel. Before wiring QQ Bot into your production agent, decide whether you want it active in group chats, DMs, or both.

   This will influence how you configure groups, broadcast groups, and pairing rules in the Gateway.

   textCopy

   *   [QQ Bot](https://docs.openclaw.ai/channels/qqbot) — QQ Bot API; private chat, group chat, and rich media (bundled plugin).
   *   Group behavior varies by channel; see [Groups](https://docs.openclaw.ai/channels/groups).
   *   [Broadcast Groups](https://docs.openclaw.ai/channels/broadcast-groups)

4. 4

   Use channel configuration docs for pairing and safety

   Once QQ Bot is enabled in your Gateway config, you still need to think about who can talk to your agent. OpenClaw enforces DM pairing and allowlists for safety, and the channel configuration docs cover pairing, group messages, and troubleshooting.

   Use these sections to tune how QQ Bot chats are accepted and how errors are diagnosed.

   textCopy

   *   [Pairing](https://docs.openclaw.ai/channels/pairing)
   *   [Group Messages](https://docs.openclaw.ai/channels/group-messages)
   *   [Groups](https://docs.openclaw.ai/channels/groups)
   *   [Broadcast Groups](https://docs.openclaw.ai/channels/broadcast-groups)
   *   [Channel Routing](https://docs.openclaw.ai/channels/channel-routing)
   *   [Channel Location Parsing](https://docs.openclaw.ai/channels/location)
   *   Troubleshooting: [Channel troubleshooting](https://docs.openclaw.ai/channels/troubleshooting).

Troubleshooting

Frequently asked questions