开始使用

一切都安装成功后，你就已经做好了进行简单配置以运行一个最小的 NoneBot 实例的准备。

最小实例

如果你已经按照推荐方式安装了 nb-cli，使用脚手架创建一个空项目：

nb create

根据脚手架引导，将在当前目录下创建一个项目目录，项目目录内包含 bot.py。

如果未安装 nb-cli，使用你最熟悉的编辑器或 IDE，创建一个名为 bot.py 的文件，内容如下（这里以 CQHTTP 为例）：

import nonebot
from nonebot.adapters.cqhttp import Bot as CQHTTPBot

nonebot.init()
driver = nonebot.get_driver()
driver.register_adapter("cqhttp", CQHTTPBot)
nonebot.load_builtin_plugins()

if __name__ == "__main__":
    nonebot.run()

解读

在上方 bot.py 中，这几行高亮代码将依次：

使用默认配置初始化 NoneBot
加载 NoneBot 内置的 CQHTTP 协议适配组件
register_adapter 的第一个参数我们传入了一个字符串，该字符串将会在后文配置 CQHTTP 协议端时使用。
加载 NoneBot 内置的插件
在地址 127.0.0.1:8080 运行 NoneBot

在命令行使用如下命令即可运行这个 NoneBot 实例：

# nb-cli
nb run
# 其他
python bot.py

运行后会产生如下日志：

09-14 21:02:00 [INFO] nonebot | Succeeded to import "nonebot.plugins.base"
09-14 21:02:00 [INFO] nonebot | Running NoneBot...
09-14 21:02:00 [INFO] uvicorn | Started server process [1234]
09-14 21:02:00 [INFO] uvicorn | Waiting for application startup.
09-14 21:02:00 [INFO] uvicorn | Application startup complete.
09-14 21:02:00 [INFO] uvicorn | Uvicorn running on http://127.0.0.1:8080 (Press CTRL+C to quit)

配置协议端

在 bot.py 文件中使用 register_adapter 注册协议适配之后即可配置协议端来完成与 NoneBot 的通信，详细配置方法参考：

NoneBot 接受的上报地址与 Driver 有关，默认使用的 FastAPI Driver 所接受的上报地址有：

/{adapter name}/: HTTP POST 上报
/{adapter name}/http/: HTTP POST 上报
/{adapter name}/ws: WebSocket 上报
/{adapter name}/ws/: WebSocket 上报

历史性的第一次对话

一旦新的配置文件正确生效之后，NoneBot 所在的控制台（如果正在运行的话）应该会输出类似下面的内容（两条访问日志）：

09-14 21:31:16 [INFO] uvicorn | ('127.0.0.1', 12345) - "WebSocket /cqhttp/ws" [accepted]
09-14 21:31:16 [INFO] nonebot | WebSocket Connection from CQHTTP Bot 你的QQ号 Accepted!

这表示 CQHTTP 协议端已经成功地使用 CQHTTP 协议连接上了 NoneBot。

:::warning 注意如果到这一步你没有看到上面这样的成功日志，CQHTTP 的日志中在不断地重连或无反应，请注意检查配置中的 IP 和端口是否确实可以访问。比较常见的出错点包括：

NoneBot 监听 0.0.0.0，然后在 CQHTTP 配置中填了 ws://0.0.0.0:8080/cqhttp/ws
在 Docker 容器内运行 CQHTTP，并通过 127.0.0.1 访问宿主机上的 NoneBot
想从公网访问，但没有修改云服务商的安全组策略或系统防火墙
NoneBot 所监听的端口存在冲突，已被其它程序占用
弄混了 NoneBot 的 host、port 参数与 CQHTTP 配置中的 host、port 参数
使用了 ws_reverse_api_url 和 ws_reverse_event_url 而非 universal client
ws:// 错填为 http://
CQHTTP 或 NoneBot 启动时遭到外星武器干扰

请尝试重启 CQHTTP、重启 NoneBot、更换端口、修改防火墙、重启系统、仔细阅读前面的文档及提示、更新 CQHTTP 和 NoneBot 到最新版本等方式来解决。 :::

现在，尝试向你的机器人账号发送如下内容：

/echo 你好，世界

到这里如果一切 OK，你应该会收到机器人给你回复了 你好，世界。这一历史性的对话标志着你已经成功地运行了一个 NoneBot 的最小实例，开始了编写更强大的 QQ 机器人的创意之旅！

4.2 KiB Raw Blame History Unescape Escape

开始使用

最小实例

解读

配置协议端

历史性的第一次对话

4.2 KiB

Raw Blame History