简介
什么是 AstrBot ？
AstrBot 是一个开源、免费的一站式 Agent ic 个人与群聊助手。它提供了一个可靠、可扩展的对话式智能基础设施，能够集成多种即时通讯平台（如 QQ 、企业微信、 Telegram 等）、大型语言模型（ LLMs ）、功能插件和各种AI能力。你可以将其视为一个强大的、可自行部署的个人 AI 伙伴、智能客服、自动化助手，和企业知识库。
主要特点
免费与开源 ：项目完全免费并遵循 AGPL-3.0 许可证。 强大的AI能力 ：支持多模态、 Agent 、知识库、人格设定和自动对话压缩等高级 AI 功能。 Agent 能力 ：完善的 Agentic 能力，支持多轮工具调用、 MCP 、 Skills 、内置沙箱代码执行器、网页搜索等 广泛的平台支持 ：支持 QQ 、企业微信、飞书、钉钉、 Telegram 等数十款主流即时通讯软件。 丰富的插件生态 ：拥有近 800 个一键安装的插件，极大地扩展了机器人的功能。 高可扩展性 ：支持接入 dify 、阿里云百炼、 Coze 等多种智能体平台，并支持 OpenAI 、 Gemini 、智谱 AI 、 Ollama 等几乎所有主流的大模型服务。 安全与隔离 ：提供 Agent Sandbox （沙箱环境），可以安全地执行代码和调用 Shell 。 可视化管理面板 ：提供 WebUI 管理面板，支持配置修改、插件管理、日志查看，集成 WebChat 可直接与机器人对话 多样的部署方式 ：支持 Docker 、 Windows 一键安装包、 CasaOS 部署等多种便捷的部署方案。
应用场景
个人AI助手 ：作为你的私人 AI 伙伴，提供对话、情感陪伴和自动化任务处理。 智能客服 ：在各种平台上快速搭建智能客服，自动回答用户问题。 企业知识库问答 ：通过知识库插件 + RAG 技术，让机器人基于私有数据进行精准问答 群聊管理助手 ：在 QQ 群、微信群中部署群管机器人，实现自动回复、内容审核等功能 自动化工作流 ：结合 Dify 工作流或插件，实现定时推送、数据采集、消息转发等自动化任务 AI 角色扮演 ：利用人格设定功能，打造个性化的 AI 角色
AstrBot 是一个功能强大且灵活的 AI 聊天机器人，适用于广泛的应用场景，满足个人用户和企业的需求。
安装
在群晖上以 Docker 方式安装。
在注册表中搜索 astrbot ，选择 soulter/astrbot ，版本选择 latest 。
本文写作时， latest 版本对应为 v4.17.3 ；
docker cli 安装
如果你熟悉命令行，可能用 docker cli 更快捷
# 新建文件夹 astrbot 和 子目录 mkdir -p /volume1/docker/astrbot/data # 进入 astrbot 目录 cd /volume1/docker/astrbot # 运行容器 docker run -d \ --restart unless-stopped \ --name astrbot \ -p 6185:6185 \ -p 6199:6199 \ -v $( pwd )/data:/AstrBot/data \ -v /etc/localtime:/etc/localtime:ro \ -e TZ=Asia/Shanghai \ soulter/astrbot:latest
-p 6185:6185 ：将主机的 6185 端口映射到容器的 6185 端口，用于访问 AstrBot 的 WebUI 。 -p 6199:6199 ：将主机的 6199 端口映射到容器的 6199 端口，用于 QQ 个人号的 WebSocket （可选）。 -e TZ=Asia/Shanghai ：设置容器的时区，确保时间显示准确。 -v $(pwd)/data:/AstrBot/data ：将主机中的 data 目录挂载到容器的 /AstrBot/data ，用于数据的持久化存储。
如果需要使用 Agent Sandbox （沙箱代码执行器），请额外添加 -v /var/run/docker.sock:/var/run/docker.sock 参数。
docker-compose 安装
也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件
version: '3.8' # 当接入 QQ NapCat 时，请使用这个 compose 文件一键部署: https://github.com/NapNeko/NapCat-Docker/blob/main/compose/astrbot.yml services: astrbot: image: soulter/astrbot:latest container_name: astrbot restart: always ports: # mappings description: https://github.com/AstrBotDevs/AstrBot/issues/497 - "6185:6185" # 必选，AstrBot WebUI 端口 - "6199:6199" # 可选, QQ 个人号 WebSocket 端口 # - "6195:6195" # 可选, 企业微信 Webhook 端口 # - "6196:6196" # 可选, QQ 官方接口 Webhook 端口 environment: - TZ=Asia/Shanghai volumes: - ./data:/AstrBot/data # - /etc/timezone:/etc/timezone:ro - /etc/localtime:/etc/localtime:ro 然后通过 SSH 登录到您的群晖，执行下面的命令：
# 新建文件夹 astrbot 和 子目录 mkdir -p /volume1/docker/astrbot/data # 进入 astrbot 目录 cd /volume1/docker/astrbot # 将 docker-compose.yml 放入当前目录 # 一键启动 docker-compose up -d
运行
部署成功后，在浏览器中输入 http://群晖IP:6185 就能看到登录界面
默认账户和密码均为： astrbot
第一次登录成功，需要修改默认的密码
大模型
模型提供商 --> 新增
支持的提供商比较多
只要添加 硅基流动 的 Key 就可以
如果 Key 没问题，点 获取模型列表 会显示可用的模型
目前硅基流动（ SiliconFlow ）注册就送 16 元的代金券
注册地址：
https://cloud.siliconflow.cn/i/NkUiXVhQ
和之前的不同，现在的券虽然多了2块钱，但是有有效期，不过可以用于 Pro/ 开始的模型
后续准备试试七牛，据说可以用国外的大模型
注册地址：
https://s.qiniu.com/2ENRR3
点模型后面的 + 号添加指定的模型，然后再启用一下
可以切换到纯聊天模式
机器人
机器人 --> 创建机器人
支持的机器人种类比较多，不仅仅是国内的，也支持国外的
以 QQ 机器人 为例，获取 QQ 机器人凭证的方法，可参照前文👇
文章传送门： 将QQ接入OpenClaw的详细教程
我们已经完成了基本设置
可以开始在 QQ 中聊天了
参考文档
AstrBotDevs/AstrBot: Agentic IM Chatbot infrastructure that integrates lots of IM platforms, LLMs, plugins and AI features. Your openclaw alternative. ✨ 地址：https://github.com/AstrBotDevs/AstrBot
AstrBot - 多平台大模型机器人基础设施 地址：https://astrbot.app/
AstrBot 地址：https://docs.astrbot.app/
@所有人：写文不易，如果你都看到了这里，请点个 赞 和 在看 ，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。
粤ICP备14082021号
免费POC，
零成本试错
