前言大学毕业以后同学都去上班了没空理我我实在闲的无聊就想着找几个机器人陪我聊天久闻astrbot的大名仙之人兮列如麻趁着短暂的暑假就想部署试试。他们简直靠谱得可怕我也尝试过把Astrbot部署到本地电脑上效果还是很不错的。不过我的舍友不允许我天天开电脑放在宿舍挂机而且校园网也经常挂掉对于astrbot的稳定运行并不是很友好。所以本次再部署是奔着部署在云服务器上来的也顺便学点运维知识。目前我已经成功部署在了自己的一台服务器上本着坚持互联网分享精神写下我的这次部署过程分享给大家文章描述不当或者有错误的地方欢迎大家的批评指正~另外附上Astrbot项目的地址感谢各位开源大佬制作那么有意思的项目Contributors to AstrBotDevs/AstrBot · GitHubgithub.com/AstrBotDevs/AstrBot一、准备工作想从零部署Astrbot聊天机器人大致要满足下面3个主要条件一台云服务器一个能用的AI API一个能用的QQ小号磨刀不误砍柴工这章我们先从零解决这些条件为后续部署铺平道路。1.1 购置云服务器我们的astrbot托管运行在云服务器上需要各位事先在任意云服务器厂商平台租用一台云服务器像是雨云、阿里云、腾讯云、京东云等等都可以。考虑是从零开始部署这里我以雨云这个云服务提供商为例简要讲解如何购置一台云服务器。阿里云腾讯云这些都是可以的只是笔者只剩雨云的优惠券了orz首先进入雨云的官网并完成注册进入用户面板。在用户面板点击找到“云产品”并点击跳转然后找到云服务器并点击“立即购买”然后在购买选项界面可以看到有很多区域和网络线路方案这里可以根据实际情况选择。不同的区域和网络线路价格会有所不同这里我们优先选择国内的云服务器。这里我选择了广东深圳网络线路选择深圳电信因为在一众选项里这样收费比较便宜随后继续往下滑会让你选择KVM配置简单理解CPU核心越多内存越大这个云服务器性能越强劲带宽越大网速越快但是租金也会越高。如果单单只是部署一个astrobot尝尝新鲜2核2GB内存绰绰有余所以我们选择最便宜的这档就可以。单单部署astrbot2核2G完全够用系统盘和公网IP保持默认即可。随后是系统和软件安装这里我们选择安装Ubuntu系统24.04 LTS版本如果之前注册完没有进行实名认证系统会提醒你先完成实名认证按照步骤完成再返回界面重新选择即可。随后我们就拥有了一台云服务器实例系统会自动跳转到控制台可以看到已经出现了一个服务器卡片等待几分钟服务器将初始化完成。服务器初始化完毕后点击管理进入服务器信息看板找到“远程连接”并记录下自己服务器的公网IP地址远程用户名和登录密码。注意不要向陌生人透露自己的密码不要向不信任的人透露自己的服务器登录密码这样我们就获得了一台Linux系统的云服务器。1.2 获得AI API为了赋予astrbot聊天机器人大语言模型LLM能力需要借助AI API请求调用LLM。获取AI API的途径很多可以去各家模型厂商DeepSeekKimi千问GPT等注册账号并创建API key充值一定token额度即可调用对应模型的API。当然也可以选择使用中转站的API但是中转站鱼龙混杂水分比较大我还是不太推荐没相关经验的好伙伴去尝试的。我之前写过一篇文章介绍如何获得与调用AI API感兴趣的读者可以阅读。0成本上手草履虫也能看懂的免费调用 DeepSeek API入门教程14 赞同 · 2 评论 文章下面我们简要介绍获得DeepSeek官方API KEY的方法。进入deepseek官网点击“API开放平台”然后跳转到登录界面按照步骤完成登录验证。DeepSeek | 深度求索www.deepseek.com/请求API需要花费token而token需要付费所以登录并完成实名认证后在界面“用量信息”充值余额如果仅仅只是为了体验尝试充个2元左右的额度即可用多少充多少。笔者之前充值过10元这里就不再展示充值流程。完成充值后点击API keys然后点击创建API keyAPI key的名称随意填写这里我填写为astrbot_test随后点击创建然后会弹出提示让你记住这个API key。因为这个API key只会显示一次忘记了只能销毁重新创建这里我们复制并保存好API key后续会用到。请注意API key类似账号密码请不要随便公开展示请注意不要公开自己的API KEY随后界面就会显示刚才我们创建好的API key至此我们的AI API也就准备好了。1.3 创建QQ小号QQ小号的创建就不再赘述了主要是讲解一下QQ小号的作用和一些提醒。创建QQ聊天机器人可以通过腾讯开放平台创建但是这种方法的限制很多而且体验并不是很好所以我们需要有一个能正常添加好友、发送信息的QQ账号来充当聊天机器人的载体。需要提醒的是因为QQ对AI和机器人的使用比较严格可能弄着弄着就把账号给弄封号了所以这里格外强调使用一个不怎么常用、没什么好友、群聊的QQ账号。至此我们就已经具备了部署聊天机器人的所有条件往下的章节将具体介绍部署过程。二、服务器环境部署2.1 SSH程控制云服务器在1.1节的最后我们创建了一个Ubuntu系统服务器并获得了服务器的公网IP和密码为了对云服务器进行操作我们需要利用这些信息实现对云服务器的远程控制比较常见的方案是SSH远程连接。SSH远程连接很简单在电脑的终端上敲击对应的指令就可以实现SSH连接控制云服务器。不过我们一般还是会用一些专门的软件进行SSH连接这里笔者使用的是finalshell访问以下链接可以跳转到finalshell的下载界面。FinalShell SSH工具,服务器管理,远程桌面加速软件,支持Windows,macOS,Linux,版本4.6.3,更新日期2025.5.21 - FinalShell官网www.hostbuf.com/t/988.html如果您和笔者一样使用Win11选择Windows x64版本下载安装即可根据自己电脑的系统点击对应的下载连接下载安装FinalShell完毕后打开软件点击蓝色的文件夹图标然后在弹出的窗口的左上角点击“带号的白色文件夹”进一步选择“SSH连接(linux)”然后在新跳出的配置界面中名称随便填写笔者习惯以“服务器厂商IP”命名然后主机填上自己云服务器的公网IP端口保持为22不动在下面的认证栏选择密码认证用户名填写root注意如果是腾讯云一般填的是“ubuntu”密码则填写云服面板里给出的远程密码然后其他配置保持不动点击“确定”然后双击刚创建好的服务器连接即可进入到终端界面第一次使用会提示“是否接受该密钥”选择“接受并保存”即可。终端界面显示连接主机成功表明SSH连接已经建立2.1 云服务器安装Docker我们的astrbot运行在Docker容器之中如果你是和我一样刚刚租用一个全新的云服务器则需要先提前配置好Docker环境如果你的服务器已经安装有Docker这一小节可以跳过。因为国内的网络环境问题安装 Docker 的可能会遇到各种各样奇怪的问题。我的个人的经验是使用什么厂商的云服务器可以先去对应厂商的文档里找到相应的 Docker 安装教程。这里给出雨云、阿里云和腾讯云服务器的 Docker 安装文档相关读者根据文档指引安装 Docker 即可。Docker安装 | 雨云百科在Linux上安装Docker和Docker Compose - 云服务器ECSECS-阿里云帮助中心轻量应用服务器 安装 Docker 并配置镜像加速源_腾讯云根据文章步骤将以下指令按照步骤依次复制粘贴到finalshell建立好的服务器终端中执行。指令执行需要一定时间请耐心等待。1.依次执行以下命令添加 Docker 软件源sudo apt-get update sudo apt-get install ca-certificates curl -y sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod ar /etc/apt/keyrings/docker.asc echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.asc] https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/ \ $(. /etc/os-release echo $VERSION_CODENAME) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null sudo apt-get update2.安装Dokcersudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin如果出现如下界面输入Y,然后回车即可3.安装完成后输入以下命令启动Docker服务sudo systemctl start docker4.输入以下命令检查Docker是否安装成功sudo docker info输出以下类似信息即表示安装成功为了能正常拉取后续的astrbot镜像还需要配置docker的镜像源加速1.创建 daemon.json 配置并打开文件请在终端依次输入这两条指令sudo mkdir -p /etc/docker sudo vim /etc/docker/daemon.json2.点按键盘上“i”键进入编辑模式此时终端底部会提示“INSERT”复制粘贴以下内容{ registry-mirrors: [ https://docker.m.daocloud.io ] }然后按下键盘“esc”键退出编辑模式键盘敲击:wq并回车实现保存并退出4.执行以下命令重启 Docker 即可sudo systemctl restart docker每一次编辑修改daemon.json 后请务必执行以上命令2.2 安装 astrbotastrbot的安装参照的是官方文档使用 Docker 部署 AstrBot | AstrBotdocs.astrbot.app/deploy/astrbot/docker.html在官方文档找到“和NapCat一起部署”这个安装方式能顺便安装接入QQ机器人所需的NapCat服务比较省心依次运行以下指令mkdir astrbot cd astrbot wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml sudo docker compose -f astrbot.yml up -d随后服务器将拉取astrbot和napcat的docker镜像并完成安装两个文件比较大受限于网速可能需要等待许久才能完成可以在雨云控制面板观察下载速度是否正常判断有没有在正常下载。正在安装安装完成然后通过以下命令查看Astrobot的日志sudo docker logs -f astrbot有如上的界面即证明安装成功重点关注红框部分内容AstrBot v4.26.7 WebUI is ready ➜ Local: http://localhost:6185 ➜ Network: http://127.0.0.1:6185 ➜ Network: http://172.18.0.3:6185 ➜ Initial username: astrbot ➜ Initial password: AHny82FDu4RKAWGAhX3dmdlY ➜ Change it after logging in这里面提供的是astrbot的配置面板访问地址和端口以及默认的用户名和密码这个密码是随机生成的请注意不要将其分享给陌生人至此Astrbot安装完成。三、Astrbot的部署安装好astrbot后本章将简要介绍如何对astrbot进行基础配置并启用QQ聊天机器人3.1 Astrbot配置面板登录在2.2节的最后我们拿到了如下关键信息➜ Local: http://localhost:6185 ➜ Network: http://127.0.0.1:6185 ➜ Network: http://172.18.0.3:6185第一行指明astrbot的访问端口我这里是6185则要前往雨云服务器的控制面板找到“防火墙规则”并点击“新建防火墙规则”然后配置如下动作改为“允许”业务端口输入6185协议选择TCP云雨开放6185端口如果您使其他云服务器也需要到对应的控制台找到防火墙规则进行配置。下面是我之前的一台腾讯云服务器开放端口的过程。腾讯云开放6185端口然后将http://localhost:6185的localhost替换成自己服务器的公网ip例如我这里应替换成http://211.161.232.124:6185并打开浏览器复制并跳转到地址进入astrbot面板如下所示。然后在用户名和密码栏分别填写当时得到的默认用户名和密码即可完成登录。登录后面板会要求你重新设置新密码当然也可以重新更改用户名配置好新的用户名和密码即可进入面板往后都会通过这里重新配置好的用户名和密码登录面板3.2 配置聊天机器人登录到Astrbot控制面板后会进入欢迎界面我们按步骤配置即可1.配置AI模型在AI模型配置界面我们点击“新增”然后选择“OpenAI Compatible”随后我们需要配置模型的提供商ID、API key和API Base URL提供商ID可以随便填这里笔者填写deepseek如果你曾和我在1.2配置过DeepSeek的API keyAPI key填写自己当时得到的API KEY然后API Base URL填写https://api.deepseek.com请注意不同的AI API提供商需要填写的Base URL是不同的。API提供商不同Base URL也不同具体的URL请参考对应提供商的API文档然后点击一次“保存配置”并下滑点击“获取模型列表”稍等片刻可以显示可用模型这里选择添加deepseek-v4-pro并保存即可完成AI模型的配置。然后点击配置框外空白处回到欢迎界面。2.配置平台机器人我们首先回到finalshell界面确保自己处于astrbot文件夹内可以在终端输入指令pwd确认终端输入指令ls确认存在napcat文件夹然后在终端输入如下指令打开napcat配置文件夹内的webui.json 配置文件。vim napcat/config/webui.json正常情况不要暴露自己的token给别人我们不对文件进行任何修改只需要获取文件内重要信息port: 6099, token: 81c6de868607,这里的port 6099是napcat服务开放的端口token 81c6de868607是进入napcat界面的验证令牌大家记住自己的端口和token请不要把自己的token公开给别人随后同样需要去云雨控制台开放服务器的6099端口雨云控制面板开放服务器6099端口并通过浏览器输入211.161.232.124:6099替换成自己主机的IP端口号访问napcat配置界面并输入自己的token进行登录这里会跳转到qq登录界面我们选择密码登录输入准备好的小号的QQ账号和密码并在手机上完成登录验证登录进napcat控制面板后我们选择”网路配置“可以发现已经自动启动了一个服务点击”编辑“这里这需要添加一个tokentoken内容任意一般是一个比较复杂的密码这里我填写abc114514记住填好token然后保存。现在回到Astrbot的控制面板欢迎界面选择配置平台机器人消息平台类别我们选择OneBot v11机器人名称任意填写Token填入当时在napcat中配置的Token然后保存。这样我们的基本机器人就配置好了可以根据需要在第三步选择允许Agent控制电脑。然后来到控制面板的”机器人“界面确保机器人已经打开可以前往”更多功能“找到”平台日志“检查机器人是否已经启动机器人正常启动后日志会打印适配器已连接这时就可以在QQ上向对应的小号QQ发送消息测试机器人聊天功能至此astrbot的基本部署已经成功实现岛为什么会飞四、Astrbot基础配置介绍这里简单介绍astrbot机器人的人格创建、配置文件修改以及插件使用。4.1 机器人人格在面板内可以创建机器人的人格模板具体入口如下这里我们主要是配置好该人格模板的ID和具体提示词内容即可创建符合提示词要求的某一人格类型的AI聊天机器人这里的提示词我让chatgpt随便生成了我妻由乃的人格设定。保存后即可完成人格设定。4.2.配置文件设置面板提供配置文件的修改用于设定机器人调用的AI模型以及一些行为设定。除了默认配置外我们可以新建配置这里推荐一个人格对应一个配置。在具体的配置页面有AI配置平台配置插件配置和扩展功能四个配置项。在AI配置中我们主要是配置聊天机器人所使用的模型人格和知识库等功能比如我们在前面建立了一个我妻由乃人格可以在这个配置里选择这个人格并保存。随后返回机器人界面编辑我们的机器人更改它的配置文件。更改配置文件后机器人需要一定时间进行重启。然后我们就可以测试配置后机器人的效果呃呃呃更多配置文件的设置这里就不再展开感兴趣的读者可以参看官方文档自行尝试WebUI | AstrBotdocs.astrbot.app/use/webui.html4.3 插件功能Astrbot面板内置一个插件市场里面有广大网友制作的各种插件极大地丰富了聊天机器人的功能。这里我随便以插件Anime1番剧剧集更新列表作为演示安装后根据使用指南来调用插件效果如下还是很有意思的~这样我们就基于雨云的云服务器完成了astrbot的部署。大家可以尝试调用不同的大预言模型自行编写个性化的人格提示词探索各式各样的插件制作独属于自己的聊天机器人~另外这个分享 从零开始在云服务器上部署astrbot机器人
前言大学毕业以后同学都去上班了没空理我我实在闲的无聊就想着找几个机器人陪我聊天久闻astrbot的大名仙之人兮列如麻趁着短暂的暑假就想部署试试。他们简直靠谱得可怕我也尝试过把Astrbot部署到本地电脑上效果还是很不错的。不过我的舍友不允许我天天开电脑放在宿舍挂机而且校园网也经常挂掉对于astrbot的稳定运行并不是很友好。所以本次再部署是奔着部署在云服务器上来的也顺便学点运维知识。目前我已经成功部署在了自己的一台服务器上本着坚持互联网分享精神写下我的这次部署过程分享给大家文章描述不当或者有错误的地方欢迎大家的批评指正~另外附上Astrbot项目的地址感谢各位开源大佬制作那么有意思的项目Contributors to AstrBotDevs/AstrBot · GitHubgithub.com/AstrBotDevs/AstrBot一、准备工作想从零部署Astrbot聊天机器人大致要满足下面3个主要条件一台云服务器一个能用的AI API一个能用的QQ小号磨刀不误砍柴工这章我们先从零解决这些条件为后续部署铺平道路。1.1 购置云服务器我们的astrbot托管运行在云服务器上需要各位事先在任意云服务器厂商平台租用一台云服务器像是雨云、阿里云、腾讯云、京东云等等都可以。考虑是从零开始部署这里我以雨云这个云服务提供商为例简要讲解如何购置一台云服务器。阿里云腾讯云这些都是可以的只是笔者只剩雨云的优惠券了orz首先进入雨云的官网并完成注册进入用户面板。在用户面板点击找到“云产品”并点击跳转然后找到云服务器并点击“立即购买”然后在购买选项界面可以看到有很多区域和网络线路方案这里可以根据实际情况选择。不同的区域和网络线路价格会有所不同这里我们优先选择国内的云服务器。这里我选择了广东深圳网络线路选择深圳电信因为在一众选项里这样收费比较便宜随后继续往下滑会让你选择KVM配置简单理解CPU核心越多内存越大这个云服务器性能越强劲带宽越大网速越快但是租金也会越高。如果单单只是部署一个astrobot尝尝新鲜2核2GB内存绰绰有余所以我们选择最便宜的这档就可以。单单部署astrbot2核2G完全够用系统盘和公网IP保持默认即可。随后是系统和软件安装这里我们选择安装Ubuntu系统24.04 LTS版本如果之前注册完没有进行实名认证系统会提醒你先完成实名认证按照步骤完成再返回界面重新选择即可。随后我们就拥有了一台云服务器实例系统会自动跳转到控制台可以看到已经出现了一个服务器卡片等待几分钟服务器将初始化完成。服务器初始化完毕后点击管理进入服务器信息看板找到“远程连接”并记录下自己服务器的公网IP地址远程用户名和登录密码。注意不要向陌生人透露自己的密码不要向不信任的人透露自己的服务器登录密码这样我们就获得了一台Linux系统的云服务器。1.2 获得AI API为了赋予astrbot聊天机器人大语言模型LLM能力需要借助AI API请求调用LLM。获取AI API的途径很多可以去各家模型厂商DeepSeekKimi千问GPT等注册账号并创建API key充值一定token额度即可调用对应模型的API。当然也可以选择使用中转站的API但是中转站鱼龙混杂水分比较大我还是不太推荐没相关经验的好伙伴去尝试的。我之前写过一篇文章介绍如何获得与调用AI API感兴趣的读者可以阅读。0成本上手草履虫也能看懂的免费调用 DeepSeek API入门教程14 赞同 · 2 评论 文章下面我们简要介绍获得DeepSeek官方API KEY的方法。进入deepseek官网点击“API开放平台”然后跳转到登录界面按照步骤完成登录验证。DeepSeek | 深度求索www.deepseek.com/请求API需要花费token而token需要付费所以登录并完成实名认证后在界面“用量信息”充值余额如果仅仅只是为了体验尝试充个2元左右的额度即可用多少充多少。笔者之前充值过10元这里就不再展示充值流程。完成充值后点击API keys然后点击创建API keyAPI key的名称随意填写这里我填写为astrbot_test随后点击创建然后会弹出提示让你记住这个API key。因为这个API key只会显示一次忘记了只能销毁重新创建这里我们复制并保存好API key后续会用到。请注意API key类似账号密码请不要随便公开展示请注意不要公开自己的API KEY随后界面就会显示刚才我们创建好的API key至此我们的AI API也就准备好了。1.3 创建QQ小号QQ小号的创建就不再赘述了主要是讲解一下QQ小号的作用和一些提醒。创建QQ聊天机器人可以通过腾讯开放平台创建但是这种方法的限制很多而且体验并不是很好所以我们需要有一个能正常添加好友、发送信息的QQ账号来充当聊天机器人的载体。需要提醒的是因为QQ对AI和机器人的使用比较严格可能弄着弄着就把账号给弄封号了所以这里格外强调使用一个不怎么常用、没什么好友、群聊的QQ账号。至此我们就已经具备了部署聊天机器人的所有条件往下的章节将具体介绍部署过程。二、服务器环境部署2.1 SSH程控制云服务器在1.1节的最后我们创建了一个Ubuntu系统服务器并获得了服务器的公网IP和密码为了对云服务器进行操作我们需要利用这些信息实现对云服务器的远程控制比较常见的方案是SSH远程连接。SSH远程连接很简单在电脑的终端上敲击对应的指令就可以实现SSH连接控制云服务器。不过我们一般还是会用一些专门的软件进行SSH连接这里笔者使用的是finalshell访问以下链接可以跳转到finalshell的下载界面。FinalShell SSH工具,服务器管理,远程桌面加速软件,支持Windows,macOS,Linux,版本4.6.3,更新日期2025.5.21 - FinalShell官网www.hostbuf.com/t/988.html如果您和笔者一样使用Win11选择Windows x64版本下载安装即可根据自己电脑的系统点击对应的下载连接下载安装FinalShell完毕后打开软件点击蓝色的文件夹图标然后在弹出的窗口的左上角点击“带号的白色文件夹”进一步选择“SSH连接(linux)”然后在新跳出的配置界面中名称随便填写笔者习惯以“服务器厂商IP”命名然后主机填上自己云服务器的公网IP端口保持为22不动在下面的认证栏选择密码认证用户名填写root注意如果是腾讯云一般填的是“ubuntu”密码则填写云服面板里给出的远程密码然后其他配置保持不动点击“确定”然后双击刚创建好的服务器连接即可进入到终端界面第一次使用会提示“是否接受该密钥”选择“接受并保存”即可。终端界面显示连接主机成功表明SSH连接已经建立2.1 云服务器安装Docker我们的astrbot运行在Docker容器之中如果你是和我一样刚刚租用一个全新的云服务器则需要先提前配置好Docker环境如果你的服务器已经安装有Docker这一小节可以跳过。因为国内的网络环境问题安装 Docker 的可能会遇到各种各样奇怪的问题。我的个人的经验是使用什么厂商的云服务器可以先去对应厂商的文档里找到相应的 Docker 安装教程。这里给出雨云、阿里云和腾讯云服务器的 Docker 安装文档相关读者根据文档指引安装 Docker 即可。Docker安装 | 雨云百科在Linux上安装Docker和Docker Compose - 云服务器ECSECS-阿里云帮助中心轻量应用服务器 安装 Docker 并配置镜像加速源_腾讯云根据文章步骤将以下指令按照步骤依次复制粘贴到finalshell建立好的服务器终端中执行。指令执行需要一定时间请耐心等待。1.依次执行以下命令添加 Docker 软件源sudo apt-get update sudo apt-get install ca-certificates curl -y sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod ar /etc/apt/keyrings/docker.asc echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.asc] https://mirrors.cloud.tencent.com/docker-ce/linux/ubuntu/ \ $(. /etc/os-release echo $VERSION_CODENAME) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null sudo apt-get update2.安装Dokcersudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin如果出现如下界面输入Y,然后回车即可3.安装完成后输入以下命令启动Docker服务sudo systemctl start docker4.输入以下命令检查Docker是否安装成功sudo docker info输出以下类似信息即表示安装成功为了能正常拉取后续的astrbot镜像还需要配置docker的镜像源加速1.创建 daemon.json 配置并打开文件请在终端依次输入这两条指令sudo mkdir -p /etc/docker sudo vim /etc/docker/daemon.json2.点按键盘上“i”键进入编辑模式此时终端底部会提示“INSERT”复制粘贴以下内容{ registry-mirrors: [ https://docker.m.daocloud.io ] }然后按下键盘“esc”键退出编辑模式键盘敲击:wq并回车实现保存并退出4.执行以下命令重启 Docker 即可sudo systemctl restart docker每一次编辑修改daemon.json 后请务必执行以上命令2.2 安装 astrbotastrbot的安装参照的是官方文档使用 Docker 部署 AstrBot | AstrBotdocs.astrbot.app/deploy/astrbot/docker.html在官方文档找到“和NapCat一起部署”这个安装方式能顺便安装接入QQ机器人所需的NapCat服务比较省心依次运行以下指令mkdir astrbot cd astrbot wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml sudo docker compose -f astrbot.yml up -d随后服务器将拉取astrbot和napcat的docker镜像并完成安装两个文件比较大受限于网速可能需要等待许久才能完成可以在雨云控制面板观察下载速度是否正常判断有没有在正常下载。正在安装安装完成然后通过以下命令查看Astrobot的日志sudo docker logs -f astrbot有如上的界面即证明安装成功重点关注红框部分内容AstrBot v4.26.7 WebUI is ready ➜ Local: http://localhost:6185 ➜ Network: http://127.0.0.1:6185 ➜ Network: http://172.18.0.3:6185 ➜ Initial username: astrbot ➜ Initial password: AHny82FDu4RKAWGAhX3dmdlY ➜ Change it after logging in这里面提供的是astrbot的配置面板访问地址和端口以及默认的用户名和密码这个密码是随机生成的请注意不要将其分享给陌生人至此Astrbot安装完成。三、Astrbot的部署安装好astrbot后本章将简要介绍如何对astrbot进行基础配置并启用QQ聊天机器人3.1 Astrbot配置面板登录在2.2节的最后我们拿到了如下关键信息➜ Local: http://localhost:6185 ➜ Network: http://127.0.0.1:6185 ➜ Network: http://172.18.0.3:6185第一行指明astrbot的访问端口我这里是6185则要前往雨云服务器的控制面板找到“防火墙规则”并点击“新建防火墙规则”然后配置如下动作改为“允许”业务端口输入6185协议选择TCP云雨开放6185端口如果您使其他云服务器也需要到对应的控制台找到防火墙规则进行配置。下面是我之前的一台腾讯云服务器开放端口的过程。腾讯云开放6185端口然后将http://localhost:6185的localhost替换成自己服务器的公网ip例如我这里应替换成http://211.161.232.124:6185并打开浏览器复制并跳转到地址进入astrbot面板如下所示。然后在用户名和密码栏分别填写当时得到的默认用户名和密码即可完成登录。登录后面板会要求你重新设置新密码当然也可以重新更改用户名配置好新的用户名和密码即可进入面板往后都会通过这里重新配置好的用户名和密码登录面板3.2 配置聊天机器人登录到Astrbot控制面板后会进入欢迎界面我们按步骤配置即可1.配置AI模型在AI模型配置界面我们点击“新增”然后选择“OpenAI Compatible”随后我们需要配置模型的提供商ID、API key和API Base URL提供商ID可以随便填这里笔者填写deepseek如果你曾和我在1.2配置过DeepSeek的API keyAPI key填写自己当时得到的API KEY然后API Base URL填写https://api.deepseek.com请注意不同的AI API提供商需要填写的Base URL是不同的。API提供商不同Base URL也不同具体的URL请参考对应提供商的API文档然后点击一次“保存配置”并下滑点击“获取模型列表”稍等片刻可以显示可用模型这里选择添加deepseek-v4-pro并保存即可完成AI模型的配置。然后点击配置框外空白处回到欢迎界面。2.配置平台机器人我们首先回到finalshell界面确保自己处于astrbot文件夹内可以在终端输入指令pwd确认终端输入指令ls确认存在napcat文件夹然后在终端输入如下指令打开napcat配置文件夹内的webui.json 配置文件。vim napcat/config/webui.json正常情况不要暴露自己的token给别人我们不对文件进行任何修改只需要获取文件内重要信息port: 6099, token: 81c6de868607,这里的port 6099是napcat服务开放的端口token 81c6de868607是进入napcat界面的验证令牌大家记住自己的端口和token请不要把自己的token公开给别人随后同样需要去云雨控制台开放服务器的6099端口雨云控制面板开放服务器6099端口并通过浏览器输入211.161.232.124:6099替换成自己主机的IP端口号访问napcat配置界面并输入自己的token进行登录这里会跳转到qq登录界面我们选择密码登录输入准备好的小号的QQ账号和密码并在手机上完成登录验证登录进napcat控制面板后我们选择”网路配置“可以发现已经自动启动了一个服务点击”编辑“这里这需要添加一个tokentoken内容任意一般是一个比较复杂的密码这里我填写abc114514记住填好token然后保存。现在回到Astrbot的控制面板欢迎界面选择配置平台机器人消息平台类别我们选择OneBot v11机器人名称任意填写Token填入当时在napcat中配置的Token然后保存。这样我们的基本机器人就配置好了可以根据需要在第三步选择允许Agent控制电脑。然后来到控制面板的”机器人“界面确保机器人已经打开可以前往”更多功能“找到”平台日志“检查机器人是否已经启动机器人正常启动后日志会打印适配器已连接这时就可以在QQ上向对应的小号QQ发送消息测试机器人聊天功能至此astrbot的基本部署已经成功实现岛为什么会飞四、Astrbot基础配置介绍这里简单介绍astrbot机器人的人格创建、配置文件修改以及插件使用。4.1 机器人人格在面板内可以创建机器人的人格模板具体入口如下这里我们主要是配置好该人格模板的ID和具体提示词内容即可创建符合提示词要求的某一人格类型的AI聊天机器人这里的提示词我让chatgpt随便生成了我妻由乃的人格设定。保存后即可完成人格设定。4.2.配置文件设置面板提供配置文件的修改用于设定机器人调用的AI模型以及一些行为设定。除了默认配置外我们可以新建配置这里推荐一个人格对应一个配置。在具体的配置页面有AI配置平台配置插件配置和扩展功能四个配置项。在AI配置中我们主要是配置聊天机器人所使用的模型人格和知识库等功能比如我们在前面建立了一个我妻由乃人格可以在这个配置里选择这个人格并保存。随后返回机器人界面编辑我们的机器人更改它的配置文件。更改配置文件后机器人需要一定时间进行重启。然后我们就可以测试配置后机器人的效果呃呃呃更多配置文件的设置这里就不再展开感兴趣的读者可以参看官方文档自行尝试WebUI | AstrBotdocs.astrbot.app/use/webui.html4.3 插件功能Astrbot面板内置一个插件市场里面有广大网友制作的各种插件极大地丰富了聊天机器人的功能。这里我随便以插件Anime1番剧剧集更新列表作为演示安装后根据使用指南来调用插件效果如下还是很有意思的~这样我们就基于雨云的云服务器完成了astrbot的部署。大家可以尝试调用不同的大预言模型自行编写个性化的人格提示词探索各式各样的插件制作独属于自己的聊天机器人~另外这个分享