AstrBot

详情介绍

AstrBot是一个松耦合、异步架构的开源聊天机器人平台及开发框架，由开发者Soulter发起并持续维护。它的核心理念是让用户能够以的配置成本，将强大的人工智能语言模型无缝集成到日常使用的各种聊天软件中。

你可以把AstrBot理解为一个“智能中枢”。它的一头连接着各种大语言模型（如DeepSeek、OpenAI GPT、Google Gemini、智谱AI、Ollama本地模型等），另一头连接着不同的消息平台（如QQ、微信、Telegram、飞书等）。通过这个中枢，你在QQ群里@机器人，它就能调用进的AI模型来回答问题；你在微信上跟它说话，它能理解并回复语音。

AstrBot采用模块化设计，基于事件总线和流水线架构，确保了系统的高稳定性和可扩展性。它不仅是一个开箱即用的机器人，更是一个开发框架，开发者可以通过深度优化的插件系统，用极简的代码扩展出无限。项目提供了可视化的Web管理面板，让配置模型、管理插件、查看日志变得像操作手机App一样简单，大大降低了普通用户的使用门槛。

官网入口地址

AstrBot官网入口网址：https://astrbot.app/

下载地址

AstrBot是开源项目，主要通过GitHub和Docker获取：

• 开源项目地址（GitHub）：https://github.com/Soulter/AstrBot

• Docker镜像：soulter/astrbot:latest（可通过Docker Hub拉取）

• Windows一键安装包：在GitHub Releases页面可下载适用于Windows的便捷安装包

功能介绍

多模型LLM引擎

AstrBot原生支持接入几乎所有主流的大语言模型。无论是商用的OpenAI API（GPT系列）、Google Gemini、DeepSeek、智谱AI的ChatGLM，还是开源的Llama、通义千问，都能轻松配置。更强大的是，它支持通过Ollama、LLMTuner等工具接入本地部署的大模型，满足企业对数据隐私和定制化的需求。在多模态能力方面，AstrBot支持图片理解（视觉识别）和语音转文字（基于Whisper），让交互方式更加丰富自然。

跨消息平台接入

这是AstrBot的核心亮点之一。它能够适配多种主流的即时通讯软件，真正实现“一次搭建，多平台复用”。目前已支持：

• QQ：通过OneBot协议（如NapCat）实现个人QQ号接入

• QQ频道

• 微信：支持Gewechat、企业微信

• 飞书：支持创建企业自建应用机器人

• Telegram

• 后续支持：钉钉、Discord、WhatsApp甚至小爱音响

Agent智能体能力

AstrBot不止于对话，它具备原生的Agent能力，能执行复杂任务：

• 代码执行器：提供沙箱环境安全运行代码，实现数据分析或计算任务

• 网页搜索：允许AI联网获取实时信息

• 自然语言待办：通过对话管理任务

• MCP支持：支持模型上下文协议，扩展AI能力边界

• 对接Dify平台：可便捷接入Dify的智能助手、知识库和工作流，打造企业级AI应用

插件扩展生态

AstrBot拥有一个活跃的插件系统，目前已有近800个一键安装的插件。在可视化管理面板的“插件市场”中，用户可以像安装手机App一样，为机器人添加各种功能，比如点歌、天气查询、图片生成、群管理自动化等。对于开发者，插件开发机制经过深度优化，门槛极低，可以快速将自己的创意集成到机器人中。

可视化管理面板

为了让非技术人员也能轻松管理，AstrBot提供了功能完备的WebUI管理面板：

• 可视化配置：无需手动修改代码文件，通过界面即可添加模型提供商、修改机器人设置

• 插件管理：在线安装、卸载、配置插件

• 日志查看：实时监控机器人运行状态，排查问题

• 集成WebChat：在面板上直接与大模型对话，测试配置是否生效

• 人格设定：支持创建和切换不同角色的人设，让AI扮演猫娘、客服、老师等不同身份

高稳定性与安全特性

• 速率限制与白名单：可控制用户调用频率，仅允许特定用户使用，防止滥用

• 内容审核：支持关键词过滤和接入百度内容审核，确保对话内容合规

• Agent沙箱：执行代码时使用隔离环境，保障主机安全

应用场景

• 个人AI助手：在微信或Telegram上拥有一个24小时在线的私人助理，可以查资料、记待办、陪聊天

• 智能客服：企业可以在官网、公众号或QQ群里接入AstrBot，自动回答用户常见问题，降低人工成本

• 群聊管理助手：在QQ或Discord群组中，机器人可以自动欢迎新人、管理消息、执行群规，甚至可以活跃群聊气氛

• 企业知识库问答：结合知识库插件和RAG技术，让机器人基于企业内部文档进行精准问答，成为员工的“百科全书”

• AI角色扮演：利用人格设定功能，创作者可以打造独特的AI角色，在社交平台上与粉丝互动

• 自动化工作流：对接Dify工作流，实现定时推送新闻、自动采集数据、跨平台消息转发等自动化任务

主要信息补充

• 定价模式：AstrBot是一个免费的开源项目，遵循AGPL-3.0许可证。用户无需支付任何软件授权费用，可以自由部署和使用。使用过程中调用第三方大模型API（如OpenAI、DeepSeek）产生的费用需要用户自行承担，但也可以使用本地免费模型来避免这部分开销。

• 部署方式：项目提供了多种部署方案，满足不同技术水平用户的需求：

  • Docker（推荐）：通过一行命令即可拉起容器，支持x86和ARM架构，适合服务器部署

  • Windows一键包：下载即用，无需配置环境，适合个人用户在本地电脑上体验

  • 源码运行：开发者可以克隆GitHub仓库，手动安装依赖运行

• 应用示例：假设你想在QQ群里接入DeepSeek-R1模型。你可以在一台有Docker的服务器上，使用一键部署脚本同时启动AstrBot和NapCat容器。登录NapCat的Web界面扫码让QQ账号上线，然后在AstrBot后台填入DeepSeek的API密钥。整个过程不到5分钟，你的QQ就会变成一个搭载深度推理能力的AI机器人，不仅能回答复杂问题，还能通过安装插件实现点歌、查天气等功能。

AstrBot常见问题