本文只简单介绍了AstrBot的部署和机器人的初步接入,更多玩法可以自己查看官方文档进行研究。
Astrbot官网文档:使用 Docker 部署 AstrBot | AstrBot
Astrbot简介
AstrBot 是一个开源的一站式 Agent 聊天机器人平台,可接入主流即时通讯软件,为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。无论是个人 AI 伙伴、智能客服、自动化助手,还是企业知识库,AstrBot 都能在你的即时通讯软件平台的工作流中快速构建生产可用的 AI 应用。
主要功能
💯 免费 & 开源。
✨ AI 大模型对话,多模态,Agent,MCP,Skills,知识库,人格设定,自动压缩对话。
🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
🌐 多平台,支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
📦 插件扩展,已有近 800 个插件可一键安装。
🛡️ Agent Sandbox 隔离化环境,安全地执行任何代码、调用 Shell、会话级资源复用。
💻 WebUI 支持。
🌈 Web ChatUI 支持,ChatUI 内置代理沙盒、网页搜索等。
🌐 国际化(i18n)支持。
通过Docker-compose部署
安装docker和docker-compose可以参考这篇文章Docker CE安装与镜像配置 - 晓拂实践录,或者自行搜索相关教程进行安装。
AstrBot 相关端口
- "6185:6185" # 必选,AstrBot WebUI 端口
- "6199:6199" # 可选, QQ 个人号 WebSocket 端口
# - "6195:6195" # 可选, 企业微信 Webhook 端口
# - "6196:6196" # 可选, QQ 官方接口 Webhook 端口如果您想使用 NapCat 将 AstrBot 部署到 QQ(个人号),使用这种方式会同时部署 AstrBot 和 NapCat,更快。
#如果要对接到QQ个人账号,使用这种方式。
mkdir -p /opt/astrbot-napcatqq
cd /opt/astrbot-napcatqq
wget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.yml
#去掉astrbot.yml文件中6199端口的注释,如果将个人QQ号配置成机器人,需要使用6199端口,需要打开。
sudo docker compose -f astrbot.yml up -d
#或者
sudo docker-compose -f astrbot.yml up -d只部署Astrbot(这个方式不能对接个人QQ账号,如果服务器资源低,可以使用这种方式。同时不要沙盒环境)
mkdir -p /opt/astrbot
cd /opt/astrbot
git clone https://github.com/AstrBotDevs/AstrBot
cd AstrBot
#不带沙盒环境,
ocker-compose -f compose.yml up -d
#带沙盒环境
# 修改 compose-with-shipyard.yml 文件中的环境变量配置,例如 Shipyard 的 access token 等
docker pull soulter/shipyard-ship:latest
docker compose -f compose-with-shipyard.yml up -d
以上2种方式,任选其一部署。对接消息渠道
对接QQ个人账号
1、容器启动后,执行如下命令获取Napcat的Token和webui地址
docker logs napcat |grep WebUi2、浏览器打开napcat的webui,输入token进行登录
3、扫码登陆qq
4、确保websocket客户端的配置如下(启动容器后默认已经带有一个websocket客户端,如果没有,可以自己手动创建一下):


5、准备大模型apikey
注册并实名认证硅基流动
注册链接:https://cloud.siliconflow.cn/i/LwF4PZiF

硅基流动创建API密钥,将API密钥保存备用,不要泄露

6、AstrBot创建机器人。
访问AstrBot web页面。默认账号密码都是astrbot 登录后修改密码。点击机器人,创建机器人。填写配置如下

7、添加大模型

8、修改机器人对应的配置文件,接入大模型。
9、测试QQ机器人
使用另外一个qq号给刚刚部署上的qq发送信息进行测试。