[部署记录]将AI接入QQ：AstrBot+NapCat

前言

之前用一些基于wxauto的项目搭建的微信虚拟助手被制裁了，只能转移到QQ来了。根据我的习惯，记录了一份部署过程，有的文本是使用OCR识别，可能会有小问题，欢迎各位大佬指导、纠错。这份教程不带有推广和任何的AFF标签，只是一篇部署记录，同时这篇也是我第一次用Obsidian来写的，之前都是使用Typora

部署环境

以下环境为我自己的云服务器环境，也可能支持比下面更差的环境，但是我没试过，可以自己尝试，或者带着配置、礼貌的前往官方社群询问

• Windows Server 2019


• 内存2GB


• CPU2核


• 储存30GB


• 公网IP

预先准备

1. 一个支持OpenAI的API接口的供应商，并准备好密钥之类的东西，如果使用国内厂商，请寻找OpenAI兼容文档页面中的API地址，准备好的东西用一个TXT准备好

Python安装

碎碎念：虽然我的电脑上安装好了Python，但是还是有个底，以防下次忘记勾选了

前往python-windows安装包-阿里云开源镜像站下载3.11.9的版本的Python（注意哦，只要大于3.10就可以啦，这两个的要求是3.10以上）

下载好后运行他，按照图示操作吧

安装AstrBot

前往github下载Source code (zip)文件

然后解压这个压缩包，运行launcher_astrbot_en.bat

等待部署，然后有一条日志显示类似 🌈 管理面板已启动，可访问 并附带了几条链接。打开其中一个链接即可访问 AstrBot 管理面板。

默认用户名和密码是 astrbot 和 astrbot。

然后我们前往这个的任意网站，使用默认用户名和密码登陆，然后修改密码。

安装NapCat

这里我使用的一键版仅适用 Windows.AMD64

前往github下载NapCat.Shell.Windows.OneKey.zip

解压这个压缩包

运行NapCatInstaller.exe 等待自动化配置

进去 NapCat.XXXX.Shell 目录

启动 napcat.bat

一般这里的二维码会很糊，然后他给了路径直接复制进去打开就行

面板链接在二维码上面，默认是6099端口

进入面板，默认密码是napcat，记得修改密码

配置NapCat

前往网络配置

新建Websocket客户端

配置如下内容

- 勾选 `启用`。

- `URL` 填写 `ws://宿主机IP:端口/ws`。如 `ws://1.2.3.4:6199/ws`。

- 消息格式：`Array`

- 心跳间隔: `5000`

- 重连间隔: `5000`

配置AstrBot

链接NapCat

前往消息平台

添加适配器

输入前面配的参数即可

看下面的日志，如下图显示就是链接成功了

测试

使用另外一个QQ发送/help出现清单即为成功

配置服务商

前往服务提供商

文本

有你用的供应商就选，没有直接选中OPENAI

填入前面准备好的信息

文本转语音

有你用的供应商就选，没有直接选中OPENAI

配置和前面一样，只是换个模型，和加个音色

语音转文本

这个他没有提供其他的供应商，然后我也没用过其他的，我就直接配whisper了

配置和前面一样，只是换个模型

嵌入模型

有你用的供应商就选，没有直接选中OPENAI

配置和前面一样，只是换个模型

设置(左边的配置文件)

以下为推荐配置

1. 启用大语言模型聊天：服务提供商-大语言模型设置


2. 配置人设：服务提供商-人格场景设置


3. 会话隔离：消息平台-会话隔离


4. ID限制：消息平台-会话隔离


5. 管理员限制：其他配置


6. 时区：其他配置

MCP

虽然这里有好多好多MCP，但是兜兜转转，我感觉只有高德那个还可以，可以查路径，还可以查天气，至于联网搜索…我还是喜欢手动查资料，哈哈，可以自己动手研究以下，点那个添加，然后配一下KEY的事情，有的要申请的，就到网上搜索，XXX开发者平台（其实只是想偷懒。。。）

成功

参考资料

开源项目

• AstrBotDevs/AstrBot


• NapNeko/NapCatQQ

文档

官方文档

• NapCatQQ


• AstrBot

非官方文档、教程

暂无

吐槽区：下次还是用回原来的编译器，这个换行排版有点麻烦…

小备注：其实看官方文档就可以配置好啦，只是有一些小地方，整合一下了