Botpy 文档Better QQBot Python SDK docs

快速开始

API 参考

简单易用

简洁的 API 设计，只需继承 Client 类并实现事件处理方法即可快速构建机器人。

异步驱动

基于 asyncio 和 aiohttp 实现，支持高性能的异步事件处理和并发连接。

功能全面

覆盖频道、私信、群聊、C2C、音频、论坛、日程等所有QQ机器人API。

事件驱动

WebSocket 实时事件推送，支持频道消息、成员变动、互动回调等多种事件。

扩展丰富

内置指令系统、定时任务、YAML配置、颜色转换等实用扩展模块。

示例完善

20+ 完整示例代码，覆盖各种消息类型和业务场景。

快速上手

python

import botpy
from botpy.message import Message

class MyClient(botpy.Client):
    async def on_at_message_create(self, message: Message):
        await message.reply(content=f"收到你的@消息了: {message.content}")

intents = botpy.Intents(public_guild_messages=True)
client = MyClient(intents=intents)
client.run(appid="你的appid", secret="你的secret")

安装

bash

pip install qq-botpy