大家好，我是顺亿，今天来和大家聊聊如何用 Lagrange.OneBot 和 NoneBot 搭建一个 QQ 机器人。这篇文章会带你一步步完成搭建，让你轻松上手。
前置准备
- 确保你的 Debian 12 服务器已安装基础工具：tar、vim、python3（3.9 及以上版本）、curl（可选）。
- 服务器具备网络连接，可以访问 GitHub 下载资源。
- 拥有一个可正常登录的 QQ 账号（建议使用非主号）。
第一步：部署 Lagrange.OneBot（协议层）
- 下载运行 Lagrange.OneBot。
- 上传到服务器，解压并移动可执行文件。
- 为可执行文件添加执行权限。
- 启动程序，扫码登录 QQ。
- 配置为 systemd 服务，实现开机自启。
第二步：安装 NoneBot 脚手架（框架层）
- 安装 pipx。
- 安装 NoneBot 脚手架。
- 验证安装。
第三步：创建 NoneBot 项目并连接 Lagrange
- 初始化 NoneBot 项目。
- 选择项目模板、项目名称、适配器、驱动器、插件存储位置。
- 安装依赖，创建虚拟环境。
- 安装内置插件。
- 启动 NoneBot 并验证连接。
第四步：配置 NoneBot 后台运行
- 使用 nohup 或 systemd 配置后台运行。
第五步：测试机器人功能测试
- 新建 test.py 文件并写入测试代码。
- 在群聊发送“测试”，验证机器人是否正常运行。
第六步：修改通信端口（可选）
- 停止相关服务。
- 修改 Lagrange 和 NoneBot 的端口配置。
- 重启服务验证。
通过以上步骤，你已成功搭建了一个 QQ 机器人。接下来可以开发自定义插件扩展功能。
我是顺亿，如果你对编程有疑问，欢迎关注「趣航编程网」（www.vqhf.com）了解更多内容。