Skip to main content
Connect QQ (the most popular messaging app in China) to your Claw instance using the official QQ Open Platform Bot API.

​
Prerequisites

​
Setup Guide

1

Create a QQ Bot Application

  1. Go to QQ Open Platform
  2. Log in and go to the Bot section
  3. Click Create Bot
  4. Fill in the bot information (name, avatar, description)
  5. Submit for review
2

Get Credentials

  1. Once approved, go to your bot’s Development Settings
  2. Copy the AppID
  3. Copy the AppSecret (Client Secret)
3

Configure Sandbox (for Testing)

  1. In the bot settings, go to Sandbox Configuration
  2. Add your QQ number to the sandbox whitelist
  3. This allows you to test before going live
Start with sandbox mode to verify everything works before submitting for production review.
4

Configure in LemonData Dashboard

  1. Go to your Claw Dashboard
  2. Click the settings icon on your instance
  3. Open the IM Integrations tab
  4. Expand the QQ section
  5. Paste your AppID and AppSecret
  6. Click Save
5

Start Chatting

  1. In QQ, search for your bot or add it as a friend
  2. Send a message
  3. The first user is automatically paired as the owner — no code needed!
  4. Start chatting with AI!

​
Supported Message Types

TypeDescription
C2C (Private)Direct messages to the bot
Group @mention@mention the bot in a QQ group
ChannelMessages in QQ channels (频道)

​
Troubleshooting

  • Verify AppID and AppSecret are correct
  • Check that your QQ number is in the sandbox whitelist (if testing)
  • Make sure the bot application is approved
  • Double-check the AppID — it should be a numeric string
  • Make sure you’re using the correct AppSecret (not the token)