---
id: qq-botpy
version: "1.2.1"
license: Tencent
license_treatment: permissive
maintenance: dormant
---

# qq-botpy — qq robot client with python3

License: permissive · Maintenance: dormant · Downloads: 259.4K/mo

## What it is and what it does

qq-botpy is an async Python framework for building bots on Tencent's QQ Open Platform. It wraps the platform's REST API and event streaming, letting you define a bot by subclassing `botpy.Client` and implementing event handlers like `on_at_message_create` for @-mentions or `on_ready` for startup. The framework manages connection lifecycle, intent subscription, and async message dispatch via aiohttp, with APScheduler available for scheduled tasks and PyYAML for config loading.

You register which event types to listen for via an `Intents` object, then call `client.run()` with your app credentials. The framework handles incoming events as typed objects (e.g., `Message`), and you reply or post via `self.api` methods. It's designed for guild-based chat bots and direct messages, with built-in support for rich message types (embeds, markdown, keyboards, file attachments).

Use it for:

- Build a QQ guild bot that responds to @-mentions with automated replies or command processing.
- Create a scheduled announcement bot using APScheduler to post messages at fixed times.
- Implement a moderation or logging bot that listens to guild member events and message changes.
- Develop a bot that fetches external data and posts formatted embeds or markdown messages to QQ channels.
- Set up a bot that handles direct messages and routes them to a backend service.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python framework for building QQ chat bots that connect to Tencent's QQ Open Platform API, handling message events, API calls, and bot lifecycle management.

Yes, if you are building a QQ bot and accept dormant maintenance. The framework is stable with no known vulnerabilities and low install friction. However, expect no active support or updates—verify that the current API surface matches your QQ Open Platform version before committing to production use.

## Install

pip install qq-botpy
uv add qq-botpy
poetry add qq-botpy

## Installing qq-botpy

Before you install: Low friction install via wheel distribution. Maintenance is dormant—last release was 2024-03-22 and no commits since 2024-09-14—so expect no active bug fixes or feature updates, though the codebase remains available.

License in practice: Licensed under a permissive Tencent license (not SPDX-identified), which typically permits use and modification without restriction; verify the exact terms in the repository if redistribution or commercial use is planned.

Quickstart:

pip install qq-botpy

import botpy
from botpy.types.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await message.reply(content="Hello")

intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid="YOUR_APPID", token="YOUR_TOKEN")

Requires Python 3.7+. Needs valid QQ Open Platform credentials (appid and token) to connect.

Verify before relying:

- Whether the dormant maintenance status affects stability or compatibility with current QQ Open Platform API versions.
- Specific Python version support ceiling (requires_python is unspecified in metadata).
- Whether aiohttp, PyYAML, and APScheduler versions are pinned or have known compatibility constraints.

## Package facts

- License: Tencent (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 259.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

qq bot framework python, tencent qq robot client, qq message event handler, qq bot api integration, async qq bot development, qq guild bot framework, qq bot event listener, async-bot-framework, qq-platform, event-driven

[View on SkillFed](https://skillfed.io/packages/qq-botpy) · [View on PyPI](https://pypi.org/project/qq-botpy/)