项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 46508
使用教程
ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。
环境要求
- 需先安装 uv（Python 包管理工具，README 中给出官方安装文档链接）
- Python 3.12（一键部署命令中通过 --python 3.12 指定）
- macOS 用户首次运行 astrbot 命令可能因系统安全校验耗时约 10-20 秒
- 如需生产级稳定部署，需参考官方文档使用 Docker / Docker Compose
安装与启动步骤
-
1安装 uv 环境
README 要求先自行安装 uv 工具，安装方式见 README 中给出的 uv 官方文档链接。未装 uv 无法使用后续命令。
-
2一键安装 AstrBot
使用 uv 以 Python 3.12 安装 astrbot 工具，安装完成后 astrbot 命令即可在终端使用。
uv tool install astrbot --python 3.12 -
3初始化环境
仅第一次部署时执行，用于初始化 AstrBot 运行环境，重复执行没有必要。
astrbot init -
4启动 AstrBot
运行后 AstrBot 服务启动，保持该终端窗口运行；macOS 首次运行该命令可能等待 10-20 秒。
astrbot run -
5升级 AstrBot（可选）
后续需要更新版本时执行，升级同样指定 Python 3.12，无需重新初始化。
uv tool upgrade astrbot --python 3.12
如何确认成功
执行 astrbot run 后命令无报错并持续运行，即表示已启动；具体访问地址与界面请以官方文档为准。
常见问题
Q：macOS 上第一次运行 astrbot 卡很久是正常的吗？
A：正常。README 说明由于 macOS 安全校验，首次运行 astrbot 命令可能耗时约 10-20 秒。
Q：以后如何更新 AstrBot 版本？
A：执行 uv tool upgrade astrbot --python 3.12 即可升级到新版本。
Q：不想自己管理服务器怎么办？
A：README 推荐使用 RainYun 一键云部署服务，可实现 24 小时在线且无需自行运维服务器。
Q：想用 Docker 部署怎么做？
A：README 未给出手动命令，仅指向官方文档《Deploy AstrBot with Docker》，请按该文档操作。
Q：桌面端也想用 AstrBot 怎么办？
A：可下载 AstrBot-desktop 桌面应用；若需要快速部署与多实例隔离，可用 AstrBot Launcher。
注意事项
- astrbot init 只需在首次部署时执行一次。
- 必须先在系统中安装 uv，否则无法执行 uv tool install 命令。
- Docker、宝塔面板、1Panel、CasaOS、手动源码部署等方式的具体步骤请参考官方文档。
- 桌面端 AstrBot App 面向 ChatUI 使用场景，官方不建议用于服务器场景。
核心亮点
- 多平台接入：原生支持QQ、Telegram、Discord等主流IM平台，降低部署门槛
- 插件生态丰富：提供插件系统与MCP支持，可扩展AI功能与自定义Agent行为
- 高度可定制：支持多种LLM后端（GPT、Gemini、Llama等），适配不同需求
不足之处
- 文档/社区待观察
适用场景
- 个人或团队构建跨平台AI聊天机器人
- 快速搭建基于LLM的Agent服务并集成到IM工具
- 作为OpenClaw的替代方案进行AI自动化任务
替代项目
LangChain、AutoGPT、nonebot2
同类项目推荐
Hermes-Studio
开源
给 Hermes Agent 装上可视化驾驶舱，聊天、编排、审批一屏掌控。
Web UI & dashboard for Hermes Agent — chat, memory, skills, terminal, approvals, mu···
abacusai-bot
开源
把 AI 助手装进聊天软件和桌面，随时帮你干活
100% free, open-source personal agents for your messaging apps, tools, and services
nse-bse-indian-stock-market-data···
开源
让 AI 助手实时查询和分析印度股市 8200+ 股票数据
Indian stock market MCP server for NSE & BSE — 48 tools (55 with aliases) for about···
Titans---Learning-to-Memorize-at···
开源
让AI在测试时学会记忆，多智能体演示平台
Multi-agent demo platform for Titans (arXiv:2501.00663) — neural networks that lear···
llm-wiki-agent
开源
丢进资料，自动长出你的个人维基百科
A personal knowledge base that builds and maintains itself. Drop in sources — Claud···
tribe
开源
低代码搭建多智能体团队，快速实现复杂自动化
Low code tool to rapidly build and coordinate multi-agent teams
MaxKB
开源
把企业知识装进 AI，员工问啥都有标准答案
MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开···
AgentCrew
开源
让多个 AI 代理协作干活，一个终端搞定复杂任务
Chat application with multi-agents system supports multi-models and MCP
Vision-Agents
开源
用任意模型和视频源，低延迟构建语音视觉智能体。
Open Vision Agents by Stream. Build voice and vision agents quickly with any model o···