Skip to main content
Connect QQ (the most popular messaging app in China) to your LemonClaw instance using the official QQ Open Platform Bot API. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments.

​
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

Open the LemonClaw WebUI

  1. If you’re using hosted Claw, go to your Claw Dashboard and click Open WebUI
  2. If you’re self-hosting LemonClaw, open your own WebUI (for example http://your-ip:18789) and sign in with your token
  3. In the WebUI, navigate to Settings → Channels
  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
Current LemonClaw QQ support covers direct messages and group @bot events. Plain non-mention group messages and QQ channel (频道) conversations are not handled yet.

​
Troubleshooting

Current LemonClaw QQ support covers direct messages and group @bot events. Plain non-mention group messages and QQ channel conversations are not handled yet.
  • 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)