1. 前言
没有前言。
2. 准备
要部署QQ官方机器人,需要到QQ 开放平台注册账号,并创建机器人。需要注意的是,这一步仅仅建立了机器人的前端(外在),机器人没有任何功能。需要让机器人和你互动的话,你还需要建立后端。
建立后端需要我们在服务器上部署机器人框架(内在)。夜梦这里推荐使用AstrBot。astrbot功能丰富,易于部署,使用简单,很适合像夜梦这样的新手。astrbot支持松耦合 / 异步 / 多消息平台部署 / 易用的插件系统 / 完善的大语言模型(LLM)接入等众多功能。
部署astrbot需要使用服务器。夜梦推荐使用雨云服务器(使用推荐码YeMeng可以享受长期九折优惠),配置1核CPU 1024M内存即可。
此外,夜梦建议你使用一个域名用于回调地址的设置。
综上,你需要准备:
- 注册qq开放平台账号,创建机器人;
- 拥有一台服务器;
- 拥有一个域名,并将域名解析到服务器上。
3. 配置前端
在QQ 开放平台注册账号后,创建机器人,你需要完善机器人的基础信息(基础设置)。
接下来配置“沙箱”,即测试环境。
夜梦仅在QQ群中使用机器人,所以下面的操作仅演示测试群聊和私聊。然后在开发管理中获取token(保存好,勿泄露)。然后在IP白名单中设置你的服务器IP。到这里,QQ开放平台上面的操作基本完成,接下来我们到服务器上进行操作。
完成后,我们设置回调地址。在 开发->回调配置
处,配置回调地址。请求地址填写 <你的域名>/astrbot-qo-webhook/callback
。
你的域名应当通过 Caddy
, Nginx
, Apache
等 Web 服务器反向代理来自 AstrBot 暴露的 6196
端口的流量。如果你还没有进行反向代理,可以参考夜梦的这两篇文章进行反向代理:
完成之后,我们添加事件,四个事件类型都全选:单聊事件、群事件、频道事件等,如下图。
全部设置完成后,我们开始部署astrbot。
[1]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:
测试:
6. 后记
从零开始的学习=v=,希望夜梦能够学会。