QQ

Connect your LemonClaw instance to QQ using the QQ Open Platform Bot API

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

• A QQ account
• Access to QQ Open Platform (developer account)
• A LemonClaw instance:
  • Hosted: create a Claw instance
  • Self-hosted: install LemonClaw

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

Type	Description
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.

Bot not responding

• 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

'invalid appid' error

• Double-check the AppID — it should be a numeric string
• Make sure you’re using the correct AppSecret (not the token)