注：接入第三方插件可能会有封号的风险，本人只是简化了原作者的很多操作方便小白上手。
项目原文档：AstrBot - Agentic AI 助手
1、环境准备
git（用于克隆代码）
python（用来运行的环境）
uv（管理依赖）
2、部署astrbot
git clone https://github.com/AstrBotDevs/AstrBot.git
cd AstrBot
在终端执行(AstrBot 目录下)执行安装依赖
uv sync
uv run main.py
访问链接是 http://localhost:6185
3、接入消息平台（本人用的是NapCat）
windows端
- 前往 NapCatQQ 的 Releases 页面 下载 NapCat.Shell.zip 并解压
- 确保 QQ 版本安装且最新
- 双击目录下 launcher.bat 即可启动 如果是 Win10 则使用 launcher-win10.bat
linux端
一键安装脚本
curl -o \
napcat.sh \
https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh \
&& bash napcat.sh \
--tui
4、连接操作
astrbot
- 进入 AstrBot 的 WebUI
- 点击左边栏
机器人 - 然后在右边的界面中，点击
+ 创建机器人 - 选择
OneBot v11
填写
ID(id)：随意填写，仅用于区分不同的消息平台实例。
启用(enable): 勾选。
反向 WebSocket 主机地址：请填写你的机器的 IP 地址，一般情况下请直接填写 0.0.0.0
反向 WebSocket 端口：填写一个端口，默认为 6199。
反向 Websocket Token：只有当 NapCat 网络配置中配置了 token 才需填写。
点击 保存。
注：反向 WebSocket 的 URL 为 ws://IP地址:6199/ws
NapCat
在 NapCat WebUI 页面选择 网络配置 → 新建 → WebSocket 客户端，URL 填入ws://127.0.0.1:6199/ws，添加完成后，点击保存即可。
回到astrbot，查看日志，如果显示连接上适配器就连接好了。
剩下的就由你自己配置，这是手机上的效果。
可以接入各家的大模型，具体各家的各不相同，请查看各家的配置文件，这里不详细介绍。
总结：本人只是很简单的简化了原文档的很多步骤，方便小白操作，详细请查看原项目文档，支持项目的原作者，如果要进行二次开发请遵守原作者的开源协议，这是对人家作者最基本的尊重。
Comments | NOTHING