什么是 AstrBot ?
AstrBot 致力于成为一个开源、一站式的 Agentic 聊天机器人平台及开发框架。你可以灵活将 AstrBot 配置为理想的 AI 伴侣、高效的 智能客服,或专业的企业知识库。通过 AstrBot,你能够轻松地在各种主流消息平台上部署和开发支持大语言模型(LLM)的智能聊天机器人。
- 完善的 Agentic 能力:支持多轮工具调用、内置沙盒代码执行、网页搜索,实现高阶任务处理。
- LLM 对话引擎: 接入多种大模型,支持多模态、工具调用、原生知识库和人设定制。
- 广泛平台支持: 一键部署至 QQ、企业微信、微信公众号、飞书、Telegram、钉钉、Discord 等主流平台,提供安全与稳定保障。
- 插件与 WebUI: 深度优化插件扩展机制,以及可视化 WebUI 进行配置和管理。
什么是 雨云云应用?
云应用RCA(Rain Cloud Apps)是雨云基于 Kubernetes 开发的容器应用平台,为用户开发、部署和使用容器应用提供了全新的平台,产品经过精心设计,具有高可用、高灵活性、易用的特点。
云应用内置提供App、网站、数据库三大板块,并且提供内置的应用商店,首批上架数百款App,并且适配1Panel等第三方商店。
云应用可以让您在不买服务器的情况下快速部署包括Alist、Cloudreve等数百种热门应用!并且对应用的更新、文件管理、设置等方便快捷。
您可以简单理解为,这是一个秒级部署、按量付费、高可用、不需要服务器,随时可以动态扩容的1Panel / 宝塔面板!
开始部署创建云应用项目
首先,你需要一个雨云账号。雨云的官网是:https://www.rainyun.com,直达的注册链接:https://app.rainyun.com/auth/reg 。
如图所示,点击云应用卡片进入对应的页面。
注册完成后,进入雨云总览页,可以看到雨云当前的所有产品。

进入云应用的页面后,我们需要创建一个项目来安装我们接下来需要安装的应用。

为项目取一个名字,例如这里的 “astrbot”,然后点击创建项目。
创建成功后,将返回云应用项目页面,可以看到已经创建的项目,如图所示。


在项目中安装 AstrBot 和 NapCat
点击项目左侧栏的应用商店,进入商店页面,搜索 AstrBot 和 NapCat,将他们安装进你的项目。
你也可以戳直达安装链接:安装NapCat , 安装 AstrBot


登录 NapCat
安装好云应用之后,点击进入项目的管理页面。


你将看到你安装的 NapCat 和 AstrBot 应用,其中,服务指的是这个应用已经开放的端口(包括对公网和内网),点击箭头指向的按钮,可以复制 NapCat WebUI 的公网访问地址。


点击 NapCat 的应用卡片,点击日志,你可以看到 NapCat 输出的日志,向上翻,找到 WebUI Token 的字样,冒号后的内容即为 WebUI 登录的 Token (也就是密码)。
访问你复制的 NapCat WebUI 的公网访问地址,例如我这里是 110.42.111.49:5676,进入 NapCat 的 WebUI,输入复制的密码(token),即可扫码登录你希望作为机器人使用的QQ。
登录 AstrBot WebUI 并创建机器人
类似 NapCat 的登录流程,复制 AstrBot WebUI 的公网访问地址,并使用浏览器打开,即可访问登录页面。


AstrBot WebUI 的初始用户名和密码均为: astrbot
进入管理页面后,点击进入机器人选项卡,然后点击创建机器人按钮,进入创建页面。
消息平台类别选择 QQ 个人号,然后直接保存,先不启用。



此处你可以放心无视警告创建,之后将回到此处配置 Token。
将 NapCat 连接到 AstrBot
回到雨云的项目管理页面,复制 AstrBot “onebot” 服务的外部连接地址。



然后进入 NapCat WebUI,选择网络配置,然后新建一个 WebSocket 客户端,例如我这里的 AstrBot onebot 服务的外部连接地址是 110.42.45.244:3152,那么创建页面的URL就是 ws://110.42.45.244:3152/ws,然后将Token复制,保存。
切记后面加一个
/ws!这里的 IP 不是
0.0.0.0在 AstrBot 启用创建的机器人
回到 AstrBot 的管理后台,编辑刚刚创建的机器人,填写刚刚在 NapCat 复制的 Token ,勾选启用后保存。



展开该页面下方的平台日志(如图所示),若看到 aiocqhttp(OneBot v11) 适配器已连接 字样,那么表明,你的 AstrBot 和 NapCat 已经连接好了。
对你登录 NapCat 的 QQ号 发送命令 /help 验证一下:

恭喜你,你的机器人已经部署成功。
扩展:为 AstrBot 接入 AI 大模型
AstrBot 本身支持接入 AI 大模型进行对话,只需要配置好模型提供商即可。
点击模型提供商选项卡,然后新建模型提供商,这里我选择 Kimi 作为提供商,你可以选择你当前可用的提供商。


Kimi 的 API Key 管理及创建的链接:Moonshot AI 开放平台 – Kimi 大模型 API 服务
新建一个 API Key,然后复制生成后的 Key。转到 AstrBot 管理页面,将复制的 Key 添加,然后确认保存。


Kimi当前可用模型的获取链接:模型推理价格说明 – Moonshot AI 开放平台 – Kimi 大模型 API 服务
将你希望使用的模型填入模型配置中,然后保存。
发送一条消息,例如 “你能干什么”,若正常回复,那么你的 AstrBot 已成功接入AI 大模型。


扩展:将 AstrBot 的 onebot 服务转换为内网连接
在上方的教程中,NapCat 是从公网连接到 AstrBot 的,这意味着这两个应用建立连接绕了一个没有必要的大圈,并且在少部分情况下,可能出现连接中断的情况,这部分教程将教学更改 NapCat 从内网连接到 AstrBot,从而避免绕圈连接。


点击 AstrBot 的应用卡片,选择 “服务” 选项卡,找到 onebot 接口,复制提供的集群内网地址。



在 NapCat 管理页面的网络配置中,编辑之前创建的连接,将 URL 改成内网地址的链接,例如我这里是 svc-astrbot-nzkvnf,那么URL就是 ws://svc-astrbot-nzkvnf:6199/ws,修改后保存即可。