1. 前言astrbot 文档：通过 QQ 官方机器人 接入 QQ (Webhook) | AstrBot
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 端口的流量。如果你还没有进行反向代理，可以参考夜梦的这两篇文章进行反向代理：
【docker】反向代理神器 | Nginx Proxy Manager 的安装【docker】Nginx Proxy Manager 的使用完成之后，我们添加事件，四个事件类型都全选：单聊事件、群事件、频道事件等，如下图。
全部设置完成后，我们开始部署 astrbot。
4. 配置后端astrbot 官方给出了很多种部署方式，夜梦这里推荐使用 Docker 进行部署，便于以后的升级管理。
安装 docker：
代码语言：javascript复制wget -qO- get.docker.com | bash代码语言：javascript复制systemctl start docker # 启动systemctl enable docker # 设置开机自动启动安装 astrbot：
代码语言：javascript复制mkdir astrbotcd astrbotsudo 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=，希望夜梦能够学会。示例插件，
成功接入和风天气～感谢 Last-emo-boy/astrbot_plugin_weather
和风天气插件：yemengstar/astrbot_plugin_qweather