AstrBot 是一个面向中文开发者与普通用户的开源AI Agent助手框架，它不是简单的聊天机器人，而是一个可插拔、可扩展、可定制的「AI智能体操作系统」——让你无需从零造轮子，就能快速部署属于自己的多平台AI助理。无论是想为QQ群添加GPT能力，还是为公司内部搭建私有化AI客服，又或是研究Agent技术栈，AstrBot 都提供了开箱即用的完整解决方案。
核心功能
- 全平台消息互通：原生支持 QQ（酷Q/OneBot）、Telegram、Discord、Slack、飞书、钉钉、微信（通过WeCom/企业微信API）等十余种IM平台，一条配置即可接入多个渠道
- 多模型自由切换：无缝对接 OpenAI、Claude、Gemini、Qwen、Llama、DeepSeek、GLM 等主流大模型，支持本地部署模型（如Ollama、vLLM），也兼容 MCP（Model Context Protocol）协议
- 插件化AI能力扩展：内置天气查询、代码解释、知识库检索、网页摘要、文件解析、定时提醒等30+官方插件；支持Python脚本开发自定义插件，5分钟即可上线新功能
- 可视化管理后台：提供简洁易用的Web控制台（默认端口8080），可实时查看会话日志、调整模型参数、启停插件、管理用户权限，小白也能轻松运维
- Docker一键部署：官方提供预构建镜像（
docker pull astrbot/astrbot），配合docker-compose.yml三步完成生产环境部署，支持ARM64（树莓派/Mac M系列）和x86_64架构 - 安全可控的私有化设计：所有对话数据默认本地存储，支持SQLite/MySQL/PostgreSQL；敏感指令（如执行shell命令）需手动开启白名单，符合国内企业合规要求
适合哪些人用
✅ 个人开发者：想给自己的QQ群/电报频道加个“懂编程的AI管理员”，或打造个性化学习助手；
✅ 中小团队运营者：需要低成本搭建24小时在线客服、活动答疑机器人、内部知识问答系统；
✅ 高校师生与AI爱好者：作为Agent开发教学案例，深入理解RAG、Tool Calling、Memory管理等核心范式；
✅ 企业IT部门：在内网部署私有AI服务，连接OA、CRM等内部系统，实现自动化流程响应——不依赖公有云，数据不出域。
快速上手
新手推荐使用Docker方式（5分钟搞定）：
- 安装 Docker 和 Docker Compose（Windows/macOS/Linux 均支持）
- 运行命令：
docker run -d -p 8080:8080 -p 5700:5700 -v $(pwd)/astrbot-data:/app/data --name astrbot astrbot/astrbot - 浏览器打开 http://localhost:8080，按向导完成平台绑定（如QQ Bot Token）、大模型API密钥配置
- 保存后自动生效，你的AI机器人已上线！
进阶用户可参考中文文档（README_zh.md）进行插件开发、自定义Prompt工程或集群部署。
项目信息
AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
36.8k
今日 +83 stars today
Stars
2.6k
Forks
Python
AGPL-3.0
编程语言：Python（兼容3.12+）｜GitHub Star 数：36,812｜开源协议：AGPL-3.0｜GitHub 项目地址
如果你厌倦了反复调试API、拼凑SDK、维护不同平台的适配代码——AstrBot 就是你等待已久的「AI Agent基础设施底座」，成熟、活跃、中文友好，且真正为落地而生。
