AstrBot：让每个聊天软件都拥有AI Agent
简介
什么是 AstrBot ？
AstrBot是一个开源、免费的一站式Agentic个人与群聊助手。它提供了一个可靠、可扩展的对话式智能基础设施，能够集成多种即时通讯平台（如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.ymlservices: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/
