StoryClaw Docs

QQ Bot

Register a bot on the QQ Open Platform and bind its BotAppID and Token in the StoryClaw console to bring an AI member into QQ groups.

Overview

QQ Bot integration requires registering a bot account on the QQ Open Platform, obtaining the BotAppID and Token, and entering them in the StoryClaw console.
QQ Bot currently only supports QQ group chats. Private chat support is not yet available.

Prerequisites

  • Completed developer verification on QQ Open Platform
  • Created and activated at least one AI member in the StoryClaw console

Setup Steps

1. Create a bot on QQ Open Platform

Log in to q.qq.com, go to the "Bot" management page, click "Create Bot", fill in the bot name and description, select "Group Bot" type, and submit your application.

QQ Open Platform — Create Bot

2. Get BotAppID and Token

After the bot is created, go to "Developer Settings" on the bot detail page, copy the BotAppID, and generate or copy the Token (Bot Token).

QQ bot credentials — BotAppID and Token

3. Enter credentials in the console

Go to StoryClaw console → ClawBot device → Plugins → QQ Bot, paste the BotAppID and Token into the corresponding fields, select the AI member to bind, and click "Save".

4. Add the bot to a QQ group

After the bot passes review and goes live on QQ Open Platform, invite it to a group using its QQ number. @mention the bot in the group to trigger AI member responses.

Troubleshooting

Q: Bot not responding in group

A: Confirm Token is configured in the console and ClawBot device is online; the bot must be @mentioned to respond.

Q: Token verification failed

A: Regenerate the Token on QQ Open Platform and update it in the console.

On this page