1.开发环境要求

1.1在开始之前您需要准备：

（1）一个开放公域、群聊权限的机器人账号

（2）一台可联网、运行稳定的计算机或服务器（建议：win10系统及以上，x86处理器）

（3）Python3.8及以上的开发环境（Nonebot基于Python运行）

（4）一款趁手的开发IDE (本文以VScode为例)

1.2确认机器人账号权限

在QQ机器人管理平台中，请确保您的机器人账号设置、拥有图示功能或权限

机器人类型必须为公域机器人

创建一个少于20人的沙箱群并开放权限

确保以上权限开放后就可以在沙箱群中“设置-群机器人”将机器人拉入群。

2.配置开发环境

2.1安装NoneBot

请参照自行参照NoneBot官方网站“快速入门”安装NoneBot

接下来的步骤默认您已经安装了NoneBot及NoneBot Cli框架。

2.2创建一个项目

在想要创建项目的文件夹下使用 nb create 指令创建一个新项目，随后按控制台提示进行即可（上下键选择，空格键选中或取消，回车键确定）

其中需要注意的：

驱动器：必须选中 HTTPX（HTTPX驱动器）以及 websockets（websockets驱动器）

适配器：必须选中 QQ（QQ官方机器人）

插件存储位置：建议选择 在“src”文件夹中

是否创建虚拟环境：如果项目后续需要迁移至其他目录或计算机建议选“是”

2.2机器人配置

完成机器人项目创建后使用趁手的IDE打开项目文件夹，根据以下图片打开目标文件并填写相关信息：

如图所示

图中的 id、token、secret可在管理平台中指示位置获取。

如图所示

请注意，id、token、secret三项不得透露给除您以外的其他任何人 ，其作用相当于账号密码。如不慎泄露，请立即前往平台重置。

以下是填写模板：

ENVIRONMENT=dev

DRIVER=~httpx+~websockets 

QQ_IS_SANDBOX=false 

COMMAND_START=["/"] 

QQ_BOTS=' 

[

    {

        "id":"",

        "token":"",

        "secret":"",

        "intent":{

            "c2c_group_at_messages":true,

            "public_guild_messages":true

        }

    }

]'

以上内容建议手打一遍，直接复制可能会有隐藏空格等情况导致文件解析失败(详见评论区)

注意：QQ_BOT内的内容(以及其他list结构配置，dict结构无需)需要使用单引号括起

2.3运行机器人 在终端或IDE内终端使用 nb run --reload 指令启动机器人（--reload 代表项目内文件有更改机器人就会热重载）。

如果一切正常将会在控制台看到以下画面：

注意保密

可以在控制台中 [EventType.READY] 成功获取到了机器人的信息。

请注意，在dev模式下会输出更详细的调试信息，其中也包括id、token、secret三项，因此在截图请教他人时请注意信息保密。

3.开发插件

在 src/plugins 文件夹中我们开始创建一个插件，那就命名为“ping”吧！我们在给机器人发送 “Ping”的时候，机器人就会回复我们“Pong!”

代码如下：

如图所示

保存以上代码后，我们可以发现控制台检测到文件的更新并开始重载机器人了。

(注：经后续测试 ping.finish() 是可以正常使用的)

4.测试插件

似乎一切就绪，我们来到沙箱群开始测试吧

成功啦！

如果您的机器人也是如上图回复的您，那么已经证明您已经完成的本文的所有内容！接下来将交给无限创意的你了！

如果任何问题请先熟读NoneBot文档及QQ官方机器人官方文档。

机器人名称头像版权归原作者所有，如有侵权请联系删除。