Skip to main content
This feature is currently in beta. You can enable automation to keep the process running persistently.

Preview

QQ Bot chat demo QQ Bot video demo

Setup Steps

1

Register a QQ Bot

Go to QQ Open Platform and register a bot account.Register QQ Bot
2

Create a Bot Application

Create a new bot application on the platform. Select the “Mini Program” type.Create bot application
3

Get Credentials and Take a Screenshot

Find your AppID and AppSecret on the bot management page, then take a screenshot of that page.Get credentials
4

Deploy in Happycapy

Open a new Happycapy conversation and send the following prompt:
安装这个 https://github.com/Yv3s-y4ng/qq-bridge 到本地并部署
Then send your credentials screenshot to Happycapy. It will automatically extract the AppID and AppSecret and complete the deployment.
Once deployed, your QQ bot is live.

Two Modes

Normal Chat Mode

QQ messages are forwarded directly to Claude, and Claude’s replies are sent back to QQ. It’s like using Happycapy right inside QQ.

Emotional Companion Mode

Built-in AI characters (3 female + 3 male) with unique personalities, speech patterns, and emotional arcs. Supports AI-generated images and videos.

Commands

CommandEffect
/modeSwitch between normal chat and companion mode
/resetReset all state and re-select mode