如果你还没有安装NTQQ和LiteLoaderQQNT:https://blog.kafuuchino.fun/archives/1825
安装LLOneBot插件:https://github.com/LLOneBot/LLOneBot
基于NoneBot2搭建:
NoneBot2官方文档:https://nonebot.dev/docs/
安装Python:https://www.python.org/downloads/ 本文中使用的Python版本是3.12.3
将pip切换到国内源:
# 清华源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 阿里源
pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
# 腾讯源
pip config set global.index-url http://mirrors.cloud.tencent.com/pypi/simple
# 豆瓣源
pip config set global.index-url http://pypi.douban.com/simple/
# 换回默认源
pip config unset global.index-url
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-11.png)
安装 pipx 和 nonebot2 脚手架:
# 安装pipx
pip install pipx
# 将pipx下的虚拟环境添加到path
pipx ensurepath
# 安装nonebot脚手架
pipx install nb-cli
安装完成后,新建一个文件夹用于存放机器人项目,并在当前路径打开终端,或打开终端后cd到机器人项目的路径:
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-13.png)
输入nb,可以看到一个向导:
选择创建一个nonebot项目,回车
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-14.png)
选择初学者,回车
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-15.png)
输入你要创建的机器人项目的名称并回车
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-16.png)
使用空格选中OneBot V11适配器,回车
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-17.png)
这里使用默认的FastAPI驱动器即可,直接回车
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-18.png)
立即安装依赖并且创建虚拟环境
创建虚拟环境可以防止你的机器人使用的依赖和电脑上已有的Python发生冲突,还可以方便迁移机器人(相当于直接在你机器人的项目路径里又装了个Python)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-20.png)
这里我们按空格选择并回车,使用内置的echo插件
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-21.png)
可以看到,机器人项目已经创建完成了
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-22.png)
右键使用记事本编辑机器人的配置文件(.env.prod)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-23.png)
在其中添加下列内容,根据你的实际情况进行修改,保存文件
ONEBOT_ACCESS_TOKEN=114514chino # 配置 Onebot的token
HOST=0.0.0.0 # 配置 NoneBot2 监听的 IP/主机名
PORT=7070 # 配置 NoneBot2 监听的端口
SUPERUSERS=["1279478673"] # 配置 NoneBot 超级用户(QQ号)
NICKNAME=["香风智乃"] # 配置机器人的昵称
COMMAND_START=["/", ""] # 配置命令起始字符
COMMAND_SEP=["."] # 配置命令分割字符
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-24.png)
打开QQ设置,配置LLOneBot
启用反向WebSocket服务,前面其他的服务用不到可以关掉,配置Access token,token需要和刚刚配置文件里的一致
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-25.png)
添加监听地址ws://127.0.0.1:7070/onebot/v11/ws,这里的端口7070要和刚刚配置文件里的端口一致,保存设置
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-26.png)
cd进刚刚创建的机器人项目路径,输入nb run --reload启动机器人
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-27.png)
出现这样的日志就说明机器人启动完成了,如果没有就检查一下刚刚的配置哪里有问题
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-28.png)
这时我们就可以私聊机器人来测试了
刚刚创建机器人项目的时候,我们选择了自带的echo插件,这个插件的作用是让机器人复读一遍你的话
发送:echo 测试
可以看到机器人回复了复读的消息,说明机器人已经搭建起来没有问题了
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-29.png)
之后,根据你的需要,去nonebot的插件商店给你的机器人添加更多功能吧~
当然,你也可以自己开发插件(
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-30.png)
插件的安装方式就是复制安装命令,在机器人没有运行的状态下,在终端里输入就可以了(要先cd进机器人的项目路径哦)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-31.png)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-32.png)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-34.png)
可以通过编辑项目配置文件来控制要加载哪些已经安装的插件:
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-35.png)
基于Koishi搭建:
Koishi官方文档:https://koishi.chat/zh-CN/
下载并安装koishi,进入主界面
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-36.png)
点击依赖管理,点击右上角的全部更新(小火箭图标),然后点击应用更改(对钩),确认安装
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-37.png)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-38.png)
耐心等待依赖更新完成,根据网络情况这一步可能会花费较多的时间
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-39.png)
更新完成后,在任务栏托盘图标中重启koishi
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-40.png)
在插件市场中搜索onebot,安装onebot适配器
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-41.png)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-42.png)
安装完成后,再次进入插件市场,找到刚刚的适配器,点击修改
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-43.png)
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-44.png)
此时我们来到了onebot适配器的设置,填入机器人账号和token
这里的token要和在QQNT的LLOneBot插件中配置的token一致
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-46.png)
配置LLOneBot中的token和监听地址并保存:
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-47.png)
回到刚刚的适配器设置,启用插件
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-48.png)
可以看到koishi已经连接到了QQ
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-49.png)
这时候就可以在插件市场里给机器人添加其他的功能插件了,插件的安装和配置和刚刚的onebot适配器安装类似
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-50.png)
可以很方便的在沙盒中测试机器人的反馈(这里安装了echo插件):
![](https://chino-img.oss-cn-beijing.aliyuncs.com/wp-content/uploads/2024/04/image-51.png)
至此,两种搭建方式就全部介绍完了,当然,你也可以搭建同时基于nonebot2和koishi的机器人,充分利用两种框架的不同插件生态,只要保证两个框架的监听端口和插件功能不冲突即可。
Comments 4 条评论
nb-cli 推荐使用 pipx 安装呢(
@呵呵です 豪德,忘记了(![](https://s.nmxc.ltd/sakurairo_vision/@2.5/smilies/tiebapng/icon_huaji.png)
您好,请问一下,我跟着您的教程来,终端已经显示连接成功了,但是私聊机器人echo没有回复,可能是什么原因呢?
@tcfafk864 如果echo插件安装没有问题,并且也和QQNT连接正常,可能是命令前缀的问题呢