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

【免费下载链接】nonebot 基于 OneBot 标准的 Python 异步 QQ 机器人框架 / Asynchronous QQ robot framework based on OneBot for Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot

前言

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 机器人。

【免费下载链接】nonebot 基于 OneBot 标准的 Python 异步 QQ 机器人框架 / Asynchronous QQ robot framework based on OneBot for Python 项目地址: https://gitcode.com/gh_mirrors/no/nonebot