完整的QQ机器人项目，包含所有必要组件和配置
包含所有必要的配置文件和启动脚本
内置echo和weather插件，可直接测试使用
完整的搭建指南和使用说明
安装pipx和nb-cli脚手架工具
# 安装pipx python -m pip install --user pipx python -m pipx ensurepath # 安装nb-cli pipx install nb-cli # 验证安装 nb
使用脚手架创建NoneBot项目
# 创建项目 nb # 选择： # 1. 创建NoneBot项目 # 2. 模板选择：bootstrap # 3. 适配器选择：QQ官方机器人 # 4. 依赖选择：HTTPX、websocket # 5. 安装依赖：是 # 6. 创建虚拟环境：是
修改配置文件，连接QQ机器人
# .env.prod 配置示例
QQ_BOTS='[
{
"id": "你的机器人ID",
"token": "你的机器人Token",
"secret": "你的机器人Secret",
"intent": {
"guilds": true,
"guild_members": true,
"direct_message": true,
"open_forum_event": true,
"message_create": true,
"message_delete": true,
"message_guild": true,
"forum_event": true
}
}
]'
QQ_USE_WEBSOCKET=true
启动机器人并测试连通性
# 启动机器人 python bot.py # 预期输出： # 02-13 14:30:45 [INFO] nonebot | NoneBot is initializing... # 02-13 14:30:45 [INFO] nonebot | Current Env: prod # 02-13 14:30:45 [INFO] nonebot | Succeeded to load adapter "QQ" # 02-13 14:30:45 [INFO] nonebot | Running NoneBot...
noneBot-qq-bot/ ├── bot.py # 启动脚本 ├── .env.prod # 环境配置 ├── pyproject.toml # 项目配置 ├── requirements.txt # 依赖列表 ├── plugins/ # 插件目录 │ ├── __init__.py │ ├── echo.py # echo插件 │ └── weather.py # 天气插件 └── .venv/ # 虚拟环境
在.env.prod中配置机器人信息
use_websocket必须设为true
在pyproject.toml中配置
测试机器人连通性的基础插件
用户：@机器人 echo 你好机器人：你好查询指定城市的天气信息
用户：@机器人 天气 北京机器人：
🏙️ 北京天气信息：
🌡️ 温度：25°C
☁️ 天气：晴
💧 湿度：45%| 命令 | 别名 | 功能 | 示例 |
|---|---|---|---|
| @机器人 | - | 获取欢迎信息 | @机器人 |
| 天气 | weather, 查天气 | 查询天气 | 天气 上海 |
| echo | - | 回显消息 | echo 测试 |
| 帮助 | help, h | 显示帮助 | 帮助 |
按照以下步骤快速启动你的QQ机器人：
pip install -r requirements.txt
编辑 .env.prod 文件
python bot.py