1. 前言

没有前言。

2. 准备

要部署QQ官方机器人，需要到QQ 开放平台注册账号，并创建机器人。需要注意的是，这一步仅仅建立了机器人的前端（外在），机器人没有任何功能。需要让机器人和你互动的话，你还需要建立后端。

建立后端需要我们在服务器上部署机器人框架（内在）。夜梦这里推荐使用AstrBot。astrbot功能丰富，易于部署，使用简单，很适合像夜梦这样的新手。astrbot支持松耦合 / 异步 / 多消息平台部署 / 易用的插件系统 / 完善的大语言模型（LLM）接入等众多功能。

部署astrbot需要使用服务器。夜梦推荐使用雨云服务器（使用推荐码YeMeng可以享受长期九折优惠），配置1核CPU 1024M内存即可。

3. 配置前端

在QQ 开放平台注册账号后，创建机器人，你需要完善机器人的基础信息（基础设置）。

接下来配置“沙箱”，即测试环境。

夜梦仅在QQ群中使用机器人，所以下面的操作仅演示测试群聊和私聊。然后在开发管理中获取token（保存好，勿泄露）。然后在IP白名单中设置你的服务器IP。到这里，QQ开放平台上面的操作基本完成，接下来我们到服务器上进行操作。

4. 配置后端

astrbot官方给出了很多种部署方式，夜梦这里推荐使用Docker进行部署，便于以后的升级管理。

安装 docker：

wget -qO- get.docker.com | bash

systemctl start docker  # 启动
systemctl enable docker  # 设置开机自动启动

安装astrbot：

mkdir astrbot
cd astrbot
sudo docker run -itd -p 6180-6200:6180-6200 -p 11451:11451 -v $PWD/data:/AstrBot/data -v /etc/localtime:/etc/localtime:ro -v /etc/timezone:/etc/timezone:ro --name astrbot soulter/astrbot:latest

一切就绪后，你可以访问ip:6185进入web管理页面。

5. 测试与使用

进入管理页面以后，在“消息平台”中添加适配器。

选择qq官方机器人（webhook）。

按照QQ开放平台中的机器人参数填入即可。

点击保存，等待一切就位。为了让机器人能够说话，夜梦这里演示最简单的方法——在服务提供商中添加模型服务提供商，例如deepseek、硅基流动等。当然你也可以手搓插件（夜梦不会

到DeepSeek 开放平台获取API：

测试：