



在大模型飞速普及的当下,AI 机器人已经成为个人社群、团队办公、企业服务中非常热门的需求。

AstrBot —— 一个开源的一站式 Agent 聊天机器人平台,可接入主流即时通讯应用,为个人、开发者和团队提供可靠、可扩展的对话式 AI 基础设施。

AstrBot 不仅支持在 等数十款主流即时通讯软件上部署,而且还内置类似 OpenWebUI 的轻量化 ChatUI, 为个人、开发者和团队打造可靠、可扩展的对话式智能基础设施。

功能特色 :

- 多平台统一接入 :内置统一消息接口,支持 等十余款主流社交平台接入使用
- 全品类大模型兼容 :适配市面上几乎所有主流大模型,包括 OpenAI、DeepSeek、Gemini、Claude 等国内外模型,支持多轮记忆、人设定制、图片多模态、语音识别与播报,还具备模型故障自动回落能力
- 原生 Agent 智能体 :自带完整 Agent 智能体引擎,支持工具调用、网页搜索、定时任务与多步骤工作流编排
- 内置 RAG 知识库 :自带深度优化的中文 RAG 知识库,无需额外部署向量数据库,上传 PDF、Word、Markdown 文档即可搭建私有问答服务
- 丰富的插件生态 :拥有成熟丰富的社区插件生态,多款插件一键安装,支持插件热重载,同时提供简易开发 SDK, 开发者可快速自定义插件
- 可视化 Web 后台 :配备功能完善的可视化管理面板,支持模型配置、平台接入、知识库管理、插件启停、日志监控一站式操作,同时内置独立网页对话界面
- 多方式灵活部署 :提供多样化部署方案,支持 Windows 一键部署、源码部署、Docker、Kubernetes 等方式,同时上架宝塔、1Panel、雨云等主流运维平台

系统架构 :

快速上手



AstrBot 支持桌面客户端、Docker、Kubernetes 等方式进行部署,可通过 Docker 进行快速部署体验。

在多种部署方式中,桌面客户端更适合个人本地快速使用,不建议用于服务器长期运行或生产环境;如需生产部署,建议优先考虑 Docker 部署或 Kubernetes 部署。

1、拉取镜像

docker pull soulter/astrbot:latest

2、创建挂载目录

mkdir -p /data/software/astrbot

cd /data/software/astrbot

3、启动容器

docker run -itd \
-p 6185:6185 \
-p 6199:6199 \
-v /data/software/astrbot:/AstrBot/data \
-v /etc/localtime:/etc/localtime:ro \
-v /etc/timezone:/etc/timezone:ro \
--name astrbot soulter/astrbot:latest
4、容器运行成功后,浏览器访问
5、如果是首次登录,需要在启动日志中查看默认密码
6、使用如下命令,实时输出日志查看默认用户名和密码
docker logs -f astrbot
Initial username、Initial password对应的值即为默认的用户名和密码。
7、使用默认用户名和密码登录后,需要重新设置账户密码,设置完后即可开始使用
功能体验
- 首页
- 对话
- 机器人
- 模型提供商
- 插件市场
- 知识库
- 人格设定
- 数据统计
- 平台日志
- 系统设置
可以说,AstrBot 并不是一款简单的聊天机器人,而是一套完整、轻量化、开箱即用的 AI 智能体中台。无论是要构建个人 AI 伙伴、智能客服、自动化助手还是企业知识库,AstrBot 都能帮助你在即时通讯平台的工作流中快速构建可用于生产环境的 AI 应用。
部署层面给几个建议:Docker 方式升级最省心,镜像一换容器一重建就完事,但记得把数据目录挂载出来,否则历史会话和配置会跟着容器一起消失;插件装多了之后启动时间会明显变长,用不上的插件及时禁用。接国内消息平台时要留意各平台的频控策略差异,测试阶段用小号,避免主账号触发风控。
另外留一条排错路径:消息收不到时先看平台连接日志而不是插件日志,大多数问题是 Webhook 回调地址不通或 Token 过期,定位后再查插件层,顺序反了会绕远路。

评论0