第1.2版教程

教程之前先进行一个广:欢迎来到我们咕鹭社游玩,目前有两个兴趣部,分别是音游群(1035163544)和技术开发群(1063790484),我们小站顶部也有直达链接,欢迎有兴趣的朋友加入我们咕鹭社_❤❤❤

前言

不想听我废话的可以直接跳到教程正文
最近搭了个QQbot,支持许多好玩的功能,其中最好玩的功能就是AI伪装人类聊天功能,具体多好玩呢,给你们看其中一段截图:
(这里的人格是舞萌圈小鬼身份)

这个相比于普通的AI聊天有什么优势?
1.会人类说话一样的断句分句;
2.会模拟人的情感,以及有自己的说话风格等;
3.可以切换多种人格,每一种人格都可能会发生很好玩的对话;
4.可以联系上下文,拥有自己的"记忆",并且能记住所有群友;
5.不会有传统AI聊天特有的动作描述

正所谓实践才是检验真理的唯一标准,只有自己搭建过玩过才知道这个机器人有多好玩
为了支持我们QQbot更加人性化个性化~~(其实是被人催写教程)~~,遂写下这篇教程。
如果你觉得这篇教程对你有帮助,欢迎收藏,转发给其他需要的朋友~

教程正文

原理解释

本教程采用的是NapCat+koishi+Yesimbot组合,具体是什么意思呢,我来给大家解释一下:
NapCat:相当于一个信使,能帮你把QQ上接收到的信息传递到其他平台上,例如我们接下来要讲的koishi;
koishi~~(不是恋恋)~~:相当于一个大脑或者主控,他可以接受到NapCat的信息,并对这些信息进行处理加工,以方便接各类插件对信息进行加工并发送;
Yesimbot:相当于一个加工器,同时也是botAI的灵魂,可以把从koishi接收到的信息喂给AI,然后再分析AI的回答进行一个真人化的处理。
~~很好我相信你没听懂我的解释,不用管这么多了直接搭建就完事了~~
如果没听懂的话可以参照一下文章末尾给出的参考文章

搭建教程

先给你打个气:本教程不需要你写任何代码,也不需要你知道多少原理,照着做就可以了
准备工作:
首先,你需要如下东西:
1.一个没有被封号,可以正常发送消息的QQ号;
2.一台可以支持24小时运行的服务器(自家电脑也行,但是机器人存活时长取决于你电脑开机时长)
3.一个语言对话AI的API(推荐deepseekAPI,花费少又智能)
服务器环境:
你的服务器可以是windows,或者linux系统(mac未知),并且安装了Docker;
本篇将以linux环境为背景进行搭建部署,使用windows的同学可以使用linux子系统或者把linux的命令译成windows系统操作

搭建NapCat

只需要一条命令即可完成搭建:

docker run -d -e WS_ENABLE=true -e NAPCAT_GID=0 -e NAPCAT_UID=0 -p 3001:3001 -p 6099:6099  --restart=always docker.1ms.run/mlikiowa/napcat-docker:latest

(此方法已废弃,但是可以参考,如果上面给出的方法用不了可以尝试此条)搭建第一步是什么?新建文件夹。是的你需要先新建一个文件夹存放NapCat相关文件,最好给足权限,命名随意,这里使用napcat:

mkdir napcat && cd napcat

然后在此目录下新建一个名为docker-compose.yml的文件,并写入以下内容:

docker-compose.yml

version: "3"
services:
  napcat:
    environment:
      - NAPCAT_UID=${NAPCAT_UID}
      - NAPCAT_GID=${NAPCAT_GID}
    ports:
      - 3000:3000
      - 3001:3001
      - 6099:6099
    container_name: napcat
    network_mode: bridge
    restart: always
    image: mlikiowa/napcat-docker:latest

这段配置的作用是使用 NapCat 官方提供的 Docker 镜像，映射好端口，并确保容器在重启后自动运行
写好后,在此目录下执行如下命令

docker-compose up -d

如果你的步骤正确了并且网络良好,你就会看到docker开始构建容器并且下载napcat文件的消息,过一段时间后就会提示容器构建完成,完成后napcat已经在你的后台运行了,接下来就是登上napcat后台进行配置.
NapCat配置
容器启动后,日志里会有如下类似内容:
[info] [NapCat] [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=xxxxxxxx
这条是告诉你访问后台的链接,但是需要如下事项:
如果是在服务器上登入后台可以忽略如下内容,直接使用日志给出的链接登录

首先,确保你的3000,3001和6099端口是开放的,然后将此链接的127.0.0.1替换成你的服务器公网ip,最终得出来的链接是:http://<你的服务器IP>:6099/webui?token=xxxxxxxx

把后台链接复制到浏览器上,就可以进入Napcat后台,刚进入时会提示登录QQ,这边推荐选扫码登录,打开你的手机版QQ,扫码,会提示是否登录LinuxQQ(如果之前有其他Linux设备登录QQ的话会被顶掉),确认登录即可

登陆后你就进入NapCat后台啦,后台长这个样子:

注意!账号信息冒绿点了才算是登录上了,如果是灰色的说明掉线了,要重新登录
接下来点击左侧的网络配置

点击新建

选择Websocket服务器选项

然后注意勾选图中红框的选项,一定要注意把ip地址改成0.0.0.0,否则会通信不了(如果是连接到另一个服务器的koishi插件请填写另一个服务器的公网ip,在同一台服务器下部署所有服务可以忽略这条)

打码地方的那一串token,可以自行用个记事本保存,后面要用(不建议手抄)

搭建koishi

进入服务器终端,输入

docker run -p 5140:5140 koishijs/koishi

等它搭建完后,就可以通过http://<你的服务器IP>:5140进入你的Koishi后台
注意!要记得开放5140端口!
进入后,同意下用户协议,恭喜你来到了koishi这个强大的bot插件平台!

koishi后台主页
接下来我们需要改一下下载源方便下载最新最热
打开左边栏的第二个齿轮一样的按钮
然后在里面找到market插件
如图所示

翻到这里,找到这个框,我们过会要输入一个下载源

新建一个空页面,进入这个网站https://status.nekohouse.cafe/status/registry
选择一个通信状况良好的下载源

这里我们选择最底下那个(作者亲测好用),点那个链接

点进去后会跳转到一个页面,页面内容我们不用管,直接复制顶上面的链接

也就是https://gitee.com/shangxueink/koishi-registry-aggregator/raw/gh-pages/market.json
复制它,然后粘贴到那个market插件里的下载源框里:

记得点上面的重载配置!这样才能生效!

接下来更新所有依赖,方便我们后续更好的安装插件等操作
点击左侧栏的第四个按钮"依赖管理"
然后点击右上角的小火箭一样的图标"全部更新"

然后点击小火箭旁边的应用更改,也就是那个√
然后点击确认更新就可以静待更新完成了

将koishi连接到NapCat

NapCat 采用了兼容 OneBot 协议,所以我们对接NapCat时,需要在koishi安装OneBot插件
如何安装插件呢,很简单:
第一步,点击左侧栏第三个按钮"插件市场",如果你的市场提示没东西或者未连接上,说明你上面更换下载源的步骤可能错了或者你选择的下载源暂时用不了,需要重新进行更换.
第二步,搜索adapter-onebot
第三步,点击第一个插件的添加按钮
如图所示(我这里添加过了所以这里变为了修改)

点击添加后在弹出的页面直接点击左下角的安装即可.
安装好后,会重新回到其他页面,此时再打开插件商城页面
这时候你会发现你之前添加的adapter-onebot插件的添加按钮变为了修改,点击修改
点最左边的"配置"按钮

进入配置页面,填入如下框:
selfld:你在NapCat登录的QQ号;
token:在NapCat创建WebsocketServer时保存的token(图中写错了,勿喷)
protocol:选择ws(WebsocketServer)
endpoint:填入http://NapCat所在服务器的ip地址:3001
注意!!!此处不要填写 127.0.0.1 或 localhost，那样只会连接到 Koishi 容器自声，导致连接失败。务必使用 NapCat 容器的实际 IP 地址！

一定不要忘了点右上角的保存!!!!!!!

保存配置后,点击右上角的最左边那个启动按钮,
如果日志提示

这样koishi和NapCat算是正式完成连接啦
(如果提示failed to connect请检查上述步骤是否正确,例如创建WebSocket Server时ip地址是否为0.0.0.0,各大端口是否开放等)

想测试一下是否完成连接,可以尝试对自己的bot发一句status或者help,如果有相应那就是连上啦
(没连上的原因很多,如果onebot插件日志提示连接成功但是没响应,就去napcat后台检查一下是否掉线了,如果没掉线也有可能是你的bot号被风控了,可以拿一个正常使用的账号测试一下)

配置Yesimbot插件

yesimbot是一款强大的koishi AI插件,他可以让你的bot使用AI功能模仿人类进行对话,官方给出的特性:

主要特性
🤖 动态意愿系统: 独创的四层意愿模型，让机器人拥有“人性化”的发言逻辑，在适当的时机自然地加入对话。
🧠 高级记忆管理: 结合长期核心记忆与自动摘要的短期记忆，确保对话的连贯性和深度。
☁️ 强大的模型服务: 支持多种 LLM 提供商，可设置复杂的故障转移和负载均衡策略。
🛠️ 可扩展的工具集: 通过插件化的工具系统，可以无限扩展机器人的能力边界，执行搜索、计算、代码执行等复杂任务。
⚙️ 深度可定制: 从性格、提示词到每一个响应细节，几乎所有方面都可进行精细配置。
🚀 易于上手的配置: 提供创新的交互式 setup 指令，引导用户轻松完成初始配置。

yesimbot官方群聊,配置过程中遇到的任何问题都可以进去询问(在问问题时请详细描述所遇到的问题,以及带好相对应的截图和日志)
具体有多好用等你用上了就知道了,现在我们来开始配置吧
首先进入koishi插件市场,搜索yesimbot,一般第一个就是

(如果你搜出来的结果没图片中的多的话说明你下载源过时了,需要重新配置个新的下载源)
和添加onebot插件一样,点击添加,安装,然后重新进入插件市场,点击修改,点击配置,进入yesimbot配置页面
需要注意的是yesimbot插件需要database,notifier,puppeteer插件作为前置,如果没有请按照按照onebot插件的方法依次安装即可

Yesimbot配置

进入配置页面后,我们需要修改一些配置项,在修改之前,你需要准备一个AIapi密钥
具体怎么获取网上一大堆教程,这边推荐用deepseek-chat,花费少又好用,具体获取请前往deepseek开放平台

在模型服务中,在providers项,点击添加项目,如果底下有空的providers就可以不用添加直接使用底下的
添加好后,点击providers[0]的展开以编辑,就会弹出一些配置项

对以下几项进行修改:
providers[0].name:填写你所使用的api提供商的名称,例如deepseek开放平台用户请填写deepseek,API易用户请填写apiyi,以此类推
providers[0].type:这里请根据你所买的AIapi的情况进行选择,普遍都兼容openAI接口,可以选择openAI项(第一项),也可以在里面找到你所使用的ai的名称,比如deepseek用户可以选择DeepSeek选项
providers[0].baseURL:请找到你所使用的api提供商的开发文档,里面会告诉你baseURL,deepseek开放平台用户请看这里
deepseek开发文档
providers[0].apiKey:这里填写好你准备好的API密钥,deepseek用户请在这里获取:deepseekAPI
后面的代理请根据自己的情况进行填写,默认不填写

接下来点击providers[0].models的添加项目,添加一个AI模型,如果底下已经有了空白模版可以直接编辑空白模版
添加好后,在providers[0].models[XXX]点击展开以编辑
然后编辑如下几项:
providers[0].models[0].modelId:这里填写你要使用的AI大模型的名称,具体名称可以去提供商的开发文档或者定价文档里面查看,deepseek定价文档,deepseek用户推荐使用deepseek-chat
providers[0].models[0].abilities:这里根据你所使用的AI大模型的能力进行勾选,一定要勾选嵌入!!!
下面的一些设置请根据自己的情况进行修改,普通用户默认即可

翻到底下的唤醒条件栏目,根据图中进行填写:
点击添加行,在新行中的平台填写onebot,频道类型选择群组,频道用户或用户ID填写praivate:*
这样你的bot就会响应他所有加的群聊
如果想要bot响应私聊用户,可以再添加行,按照上面的内容添加,但是频道类型请选择私聊

需要私聊请添加图中所示的内容

只回复单个人或者单个群聊要怎么填我也不知道,要去yesimobot官方群聊问问

到这里时,基本可以启动了.点击右上角的保存按钮,然后启动!

这时候启动后,你会发现还是用不了,因为我们还需要配置几个只有启动才能选择的配置项
首先找到modelGroups项,添加两个modelGroups
如图所示

这两个Groups的配置项中,这些配置项都填写相同的内容即可:
modelGroups[0]/[1].models:全部都添加一个项目
modelGroups[0]/[1].models[0]:这里只有启动插件才会有选择项,启动后选择你配置好的AI即可

然后有一个配置项在两个Group中需要填写不同的项
modelGroups[0].name和modelGroups[1].name:填写内容随意,请填写两个不同的名称方便区分(图中这里Groups[1]的名称后面改成deepseek-txttxt2了)
modelGroups[0].strategy:这里选择故障转移
modelGroups[1].strategy:这里选择轮询/负载均衡

然后翻到模型组配置这里,
task.chat选择第一个模型组的名称
task.embed选择第二个模型组的名称

配置完成后,点击右上角的重载配置,然后重启一遍插件(停用插件→启用插件),你的bot的AI功能就可以使用啦!

这时候你可以到群聊里艾特你的机器人,看日志有没有把你的消息传输到AI模型那里并输出,如果步骤没有出问题的话,只要等待一会bot就会回应你啦!

但是!!!!!

这里还不是终点!

我们还没有对AIbot的人格进行设置!
人格是什么?人格大概意思就是给ai的一些描述,比如说在ai的人格文件里面写:"你是一只猫娘",这样AI就会根据你写的人格,进行一个语言风格的模拟和行为模拟
具体怎么设置人格呢,回到koishi的后台主界面,在左侧栏找到文件选项(第五个按钮)
进入文件页面后依次根据红框找到persona.md文件,点开它进行配置

这个文件就是bot的人格文件,你需要根据自己的需求进行一个修改,修改完成后,你的bot就会遵循你写的人格进行发言

到这里才算是真正的完成啦!

到这里AIbot的教程差不多就结束了,不过这不是终点,你可以继续到插件市场寻找好玩的插件,丰富bot的功能,也可以进入yesimbot群聊,探索更多yesimbot的潜力,你甚至都可以加入他们的开发团队继续改进和完善这个神奇的插件!

本人文笔不好,一些地方难免会表述错误或者出现技术错误,欢迎各位在评论区中指出!
后续也会发表更多教程,欢迎大家关注我们的小站喵!

参考文章:基于Koishi、Chatluna和NapCat：QQ群聊机器人的部署教程
感谢yesimbot群聊中各路大佬的支持和帮助!!!