QQ Bot Messaging Skill

基于 qq-botpy 的 QQ 机器人消息收发框架。

安装依赖

pip install qq-botpy

配置

创建 config.yaml：

appid: "YOUR_APPID"
secret: "YOUR_SECRET"

三种消息场景

1. 频道 @ 消息（Guild）

• Intent：public_guild_messages=True
• 事件：on_at_message_create(message: Message)
• 消息对象：from botpy.message import Message
• 回复：await message.reply(content="...")
• 主动发送：await self.api.post_message(channel_id=..., content=..., msg_id=message.id)
• 用户标识：message.author.id，频道：message.channel_id
• 解析指令：消息内容含 <@!botid> 前缀，需先剔除（见 scripts/bot_utils.py 中的 parse_cmd()）

2. C2C 私聊消息

• Intent：public_messages=True
• 事件：on_c2c_message_create(message: C2CMessage)
• 消息对象：from botpy.message import C2CMessage
• 回复：await message._api.post_c2c_message(openid=..., msg_type=0, msg_id=message.id, content=...)
• 用户标识：message.author.user_openid

3. 群 @ 消息（Group）

• Intent：public_messages=True
• 事件：on_group_at_message_create(message: GroupMessage)
• 消息对象：from botpy.message import GroupMessage
• 回复：await message._api.post_group_message(group_openid=..., msg_type=0, msg_id=message.id, content=...)
• 用户标识：message.author.member_openid，群：message.group_openid

C2C 和群消息共用 public_messages=True，可同时监听两者。

定时推送循环

使用 asyncio.create_task() 启动后台协程实现定时推送：

task = asyncio.create_task(self._push_loop(key, message))
tasks[key] = task
# 取消：tasks.pop(key).cancel()

循环内用 await asyncio.sleep(seconds) 等待，用 try/except asyncio.CancelledError 优雅退出。

启动模板

# Python 3.10+ 必须显式创建 event loop
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)

intents = botpy.Intents(public_guild_messages=True, public_messages=True)
client = MyBot(intents=intents)
client.run(appid=config["appid"], secret=config["secret"])

完整模板

见 scripts/bot_template.py，包含三种消息处理器 + 定时推送的完整可运行示例。

常见问题

| 问题 | 原因 | 解决 | |------|------|------| | RuntimeError: There is no current event loop | Python 3.10+ 不再自动创建 loop | 启动前调用 asyncio.new_event_loop() + asyncio.set_event_loop() | | 收不到消息 | Intent 未开启 | C2C/群需要 public_messages=True，频道需要 public_guild_messages=True | | 发消息失败 | msg_id 过期（被动消息有效期短） | 定时推送需申请主动消息权限，或每次收到消息后更新 msg_id |