NoneBot 入门指南：从零开始搭建你的第一个QQ机器人

前言

NoneBot 是一个基于 Python 的异步 QQ 机器人框架，它提供了丰富的功能和灵活的扩展性。本文将带你从零开始，一步步搭建一个最简单的 NoneBot 实例，并实现基础的机器人功能。

环境准备

在开始之前，请确保你已经完成以下准备工作：

1. 安装 Python 3.7 或更高版本
2. 安装 NoneBot 框架
3. 配置好 go-cqhttp（或其他兼容的 CQHTTP 实现）

创建最小实例

让我们从一个最简单的 NoneBot 实例开始。创建一个名为 bot.py 的文件，内容如下：

import nonebot

if __name__ == '__main__':
    nonebot.init()
    nonebot.load_builtin_plugins()
    nonebot.run(host='127.0.0.1', port=8080)

这段代码做了三件事：

1. nonebot.init() - 使用默认配置初始化 NoneBot
2. nonebot.load_builtin_plugins() - 加载 NoneBot 内置插件
3. nonebot.run() - 启动 NoneBot 服务

关于监听地址

host 参数指定了 NoneBot 监听的网络地址：

• 127.0.0.1：仅监听本地回环地址，适合 go-cqhttp 和 NoneBot 在同一台机器上运行的情况
• 0.0.0.0：监听所有可用网络接口，适合 go-cqhttp 运行在其他机器或容器中的情况

运行 NoneBot

在命令行中执行以下命令启动你的机器人：

python bot.py

成功启动后，你将看到类似以下的日志输出：

[2021-08-12 19:33:09,378 nonebot] INFO: Succeeded to import "nonebot.plugins.base"
[2021-08-12 19:33:09,378 nonebot] INFO: Running on 127.0.0.1:8080
 * Serving Quart app ''
 * Environment: production
 * Please use an ASGI server (e.g. Hypercorn) directly in production
 * Debug mode: True
 * Running on http://127.0.0.1:8080 (CTRL + C to quit)

配置 go-cqhttp

为了让 go-cqhttp 能够与 NoneBot 通信，我们需要修改 go-cqhttp 的配置文件 config.yml：

servers:
  - ws-reverse:
      universal: ws://127.0.0.1:8080/ws/

配置注意事项

1. 确保 ws:// 协议前缀正确
2. IP 地址和端口必须与 nonebot.run() 中的参数一致
3. 如果 NoneBot 和 go-cqhttp 不在同一台机器上，需要使用正确的网络可达地址

验证连接

配置完成后，重启 go-cqhttp。如果一切正常，你将在 NoneBot 的控制台看到类似以下的连接日志：

[2021-08-12 19:51:28,017] 127.0.0.1:54125 GET /ws/ 1.1 101 - 9254

这表示 go-cqhttp 已成功连接到 NoneBot。

常见问题排查

如果连接失败，请检查以下方面：

1. 网络连通性：确保 NoneBot 和 go-cqhttp 之间网络可达
2. 端口冲突：确认端口未被其他程序占用
3. 防火墙设置：检查防火墙是否阻止了相关端口的通信
4. 配置一致性：确保两端的 IP 和端口配置匹配

第一次对话

现在，向你的机器人发送以下消息：

/echo 你好，世界

如果一切正常，机器人会回复相同的消息："你好，世界"。这个简单的 echo 功能是由 NoneBot 内置的基础插件提供的。

下一步

恭喜你成功搭建了第一个 NoneBot 实例！接下来你可以：

1. 探索更多内置插件的功能
2. 学习如何开发自定义插件
3. 了解 NoneBot 的配置系统和中间件机制
4. 研究如何部署到生产环境

NoneBot 提供了丰富的功能和灵活的扩展方式，让你能够构建功能强大的 QQ 机器人。