给新手关于astrbot的部署和接入个人QQ教程(仅基础配置)
前言#
本教程专为纯新手打造,采用AstrBot官方桌面客户端部署,无需安装Python、单独配置环境,全程图形化操作,适配Windows、Mac主流桌面系统,是目前最简单、最稳定的新手部署方式。部署完成后可直接使用AI对话、插件功能、机器人适配等核心能力。
区别说明:本教程是新版桌面客户端,非启动器和Docker部署,仅进行基础配置,不包含本地部署模型,新手优先选择此方案,具体不会可参考官方文档👋 I'm AstrBot | AstrBot。不会的优先问ai
1.前置准备#
下载桌面客户端和napcat(此处使用图形化方案,需要另外准备个QQ账号,推荐 等级高 有会员 冲过钱的 这些不容易被下线,注意一定不要用bot的qq注册腾讯游戏账号)
1 访问项目的github地址AstrBotDevs/AstrBot-desktop: The desktop edition of AstrBot, designed for fast local installation and convenient access to ChatUI and plugins.#
NapNeko/NapCatQQ-Desktop: NapCatQQ&Snowluma 的 Desktop 程序
2 从二者的releases下载你对应系统版本的资源并运行,接着跟着流程安装#
3.运行Astrbot的桌面客户端#
图例:
2.在桌面客户端内进行基本配置#
1.安装依赖(python node.js uv)并下载一个版本#
如果是中国大陆地区且没有代理,可在 高级 里找到开启一键加速中国大陆的配置项
2.创建实例并运行(如图所示),端口可留空或自由指定(尽量选高位端口)#
3.在webui中进行astrbot的基础配置#
1.在浏览器输入 127.0.0.1:你的端口号 进入webui比如127.0.0.1:15678,可以进入到astrbot的webui界面,第一次使用用户名和密码默认都是astrbot#
2.配置provider(模型提供商)#
Astrbot兼容openai协议格式的api接入,可使用云端和本地的模型,此处以云端ds为例子。
先去官网申请api keyDeepSeek | 深度求索,之后把它接入astrbot中也就是填到api key那一栏,然后就可以从上游获取模型(此处为deepseek-flash,支持多模态也就是图片理解)
3.进行配置文件的配置#
只有基础配置 无TTS ASR 嵌入模型 知识库 相关配置
从侧栏配置文件进入,之后在上面默认配置文件那里的三角点一下,新建一个配置文件 以下为要做的:
模型选择刚才配置的(如果你刚才配置的模型不支持视觉则需要另外配置一个支持视觉的模型作为视觉转述模型)
人格如果你已经写了可以指定,然后把健康模式关了
在ai配置→能力 这里把启动网页搜索打开,提供商选择tavily Tavily ,注册个账号每个月有免费额度,然后把key填进去
如果你需要ai有操作你计算机的能力,需要在ai配置→能力→使用电脑能力里把运行环境填成local
在平台配置 管理员ID里面把你的astrbot用户名,你和bot的qq号加上
其他的看自己的情况和需要自己配置
一定要点右下角的保存
4.创建机器人#
消息平台类型选择onebot,方向ws主机默认0.0.0.0不用改,反向ws 端口此处为6290(端口没啥特殊要求只要和napcat里的端口对上即可)token没有配置不用管,如果要把bot部署到公网的话最好还是填一下。不过需要看这个的应该也没有这个需求吧
配置文件选择刚才保存的,然后创建机器人
4.进行napcat的配置#
1.运行安装的napcat desktop 并在里面进行napcat的安装#
2.创建bot实例并且配置连接#
输入bot的QQ号,并且配置反向ws连接客户端(意为让napcat连接astrbot)
连接配置的示例如下:
用 ws:// 开头和 /ws 结尾 端口一定要和astrbot里的一致(这里是6290)
之后保存
3.启动bot实例进入napcat的webui并登录#
这里如果是在以远程环境下比如使用手机远程桌面连接计算机的情况: 由于腾讯风控这些杂七杂八的,不能直接截图扫二维码登录napcat,可以选择先使用密码登录,之后qq会说要让你扫码,这个时候再选择截图使用qq扫码即可登录
3.5.可以的话把反检查开关全部选上,虽然还得照样被下线#
5.最后验证#
在qq上给bot发消息,bot可进行回复即为成功,同时进行了电脑操作能力配置的话可以问一下他有没有本地shell权限如果说没有那就是配置文件 管理员id里没配好,哪里有问题优先问ai#
成功示例:
6.补充说明#
其实还有很多东西没有在这个教程里面说明例如本地模型部署,TTS和ASR文字转语音语音转文字,知识库的搭建,以及最重要的插件安装这些都是在完成能让bot说话的基础上提升体验的东西,包括分段回复,日程这种也不包含在教程内,这些就看需要自行配置吧
















