windows系统下使用astrbot与napcatQQ协议，构建QQ大模型机器人

参考文档：https://astrbot.app

下载安装器

打开 https://github.com/Soulter/AstrBotLauncher/releases/latest

下载 Source code (zip) 并解压到电脑。

运行安装器

双击launcher_astrbot_en.bat运行

复制本地链接在浏览器打开进入AstrBot管理面板

通过 NapCatQQ 协议实现端接入 QQ

NapCatQQ 的文档：NapCatQQ 文档

参考内容：NapCat.Shell - Win手动启动教程

  1. 前往 NapCatQQ 的 release 页面 下载NapCat.Shell.zip解压
  2. 确保QQ版本安装且最新
  3. 双击目录下launcher.bat即可启动 如果是win10 则使用launcher-win10.bat

如果需要快速登录 将 QQ 号传入参数即可，新建fastlaunch.bat文件，写入以下代码

launcher.bat <机器人QQ号>

双击运行fastlaunch.bat即可启动，复制控制台中的地址到浏览器即可进入NapCatQQ的管理面板

连接到 AstrBot

在 AstrBot 配置

  1. 进入 AstrBot 的管理面板
  2. 点击左边栏 消息平台
  3. 然后在右边的界面中，点击 + 新增适配器
  4. 选择 aiocqhttp(OneBotv11)

弹出的配置项填写：

配置项填写：

  • ID(id)：随意填写，用于区分不同的消息平台实例。
  • 启用(enable): 勾选。
  • 反向 WebSocket 主机地址：请填写你的机器的 IP 地址。一般情况下请直接填写 0.0.0.0
  • 反向 WebSocket 端口：填写一个端口，例如 6199。

点击 保存。

配置管理员

填写完毕后，进入 配置 页，点击 其他配置 选项卡，找到 管理员 ID，填写你的 QQ 号（不是机器人的 QQ 号）。

切记点击右下角 保存，AstrBot 重启并会应用配置。

在 NapCatQQ 中添加 WebSocket 客户端

切换回 NapCatQQ 的管理面板，点击 网络配置->新建->WebSockets客户端。

在新弹出的窗口中：

  • 勾选 启用。
  • URL 填写 ws://宿主机IP:端口/ws。如 ws://0.0.0.0:6199/ws。
  • 消息格式：Array
  • 心跳间隔: 5000
  • 重连间隔: 5000

点击 保存。

前往 AstrBot WebUI 控制台，如果出现 aiocqhttp(OneBot v11) 适配器已连接。 相关蓝色的日志，说明连接成功。

此时，你的 AstrBot 和 NapCatQQ 应该已经连接成功。使用 私聊 的方式在 QQ 对机器人发送 /help 以检查是否连接成功。

接入大模型服务

DeepSeek API Key 的获取方式：https://platform.deepseek.com/api_keys

点击创建API Key即可，然后需要进入充值界面充值一定的金额（一块钱也可以）

复制API Key进入AstrBot页面，在新增deepseek服务提供商处填入，点击保存

🎉 大功告成！

此时，你的 AstrBot 已经成功接入大语言模型。使用 私聊 的方式在 QQ 对机器人发送消息以检查是否连接成功。