AstrBotDevs /AstrBot

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

★ 46,987⑂ 3,583👁 98⑃ 3,688● 6,826▤ 263
PythonAGPL-3.0Created 2022-12-08astrbot.app
Download: v4.30.0-alpha.1v4.30.0-alpha.1 ↓12026-11-15
+76
Daily
+495
Weekly
46,987
stars
3,583
forks
98
watchers
3,688
prs
6,826
issues
263
releases

README

!AstrBot-Logo-Simplified




简体中文 |
繁體中文 |
日本語 |
Français |
Español |
Русский 






















Documentation |
Blog |
Roadmap |
Issue Tracker |
Email Support


AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.

!screenshot_1 5x_postspark_2026-02-27_22-37-45

 Key Features

1. 💯 Free & Open Source.
2. ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
3. 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
4. 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more.
5. 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
6. 🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse.
7. 💻 WebUI Support.
8. 🌈 Web ChatUI Support with built-in agent sandbox and web search.
9. 🌐 Internationalization (i18n) Support.

 Quick Start

 One-Click Cloud Deployment (RainYun)

For users who want one-click 24-hour-online deployment and do not want to manage servers themselves, we recommend RainYun's one-click cloud deployment service ☁️:



 One-Click Deployment

 [!NOTE]
 Requires uv to be installed.
 For macOS users: due to macOS security checks, the first run of the astrbot command may take longer (about 10-20s).

For users who want to quickly experience AstrBot, are familiar with command-line usage, and can install a uv environment on their own, we recommend the uv one-click deployment method ⚡️:

bash
uv tool install astrbot --python 3.12
astrbot init  Only execute this command for the first time to initialize the environment
astrbot run


Update astrbot:

bash
uv tool upgrade astrbot --python 3.12


 Docker Deployment

For users familiar with containers and looking for a more stable, production-ready deployment method, we recommend deploying AstrBot with Docker / Docker Compose.

Please refer to the official documentation: Deploy AstrBot with Docker.

 Desktop Application Deployment

For users who want to use AstrBot on desktop and mainly use ChatUI, we recommend AstrBot App.

Visit AstrBot-desktop to download and install; this method is designed for desktop usage and is not recommended for server scenarios.

 Launcher Deployment

For desktop users who also want fast deployment and isolated multi-instance usage, we recommend AstrBot Launcher.

Visit AstrBot Launcher to download and install.

More deployment methods

If you need panel-based management or deeper customization, see BT-Panel Deployment, 1Panel Deployment, CasaOS Deployment, 

Top issues

Discussions

Latest release

v4.30.0-alpha.1 v4.30.0-alpha.1 2026-11-15
[4.30.0-alpha.1] - 2026-11-15

本版本为 Alpha 测试版,可能存在不稳定或兼容性问题,建议先在测试环境验证。本次涉及对话数据库、Agent 配置和会话设置迁移。升级前请备份数据与配置;回退旧版需同时恢复升级前备份。请不要在重要的生产环境使用该版本。

 主要更新

- 将会话后端迁移到事件溯源方式,减少重复上下文写入和部分写放大,优化存储性能;增量保存消息与工具调用,完善执行中断后的历史处理。 (10077, 11158, 11162)
- 引入新的 Agent 运行时模型。插件可通过 ctx.agent.run_turn() 唤起 Agent turn。详见 调用现有会话的 Agent (10934, 10936, 11052, 11148, 11153)
- 重构子代理为具有独立上下文的后台任务,支持通用与专用 Agent、追加指令和结果回传。入口由侧边栏移至 配置文件 → AI → 能力 → 子代理,按配置文件管理。 (11053)
- 将自定义规则与会话管理统一至 配置文件 → 管理会话配置映射,支持基础配置与字段覆盖、批量编辑和恢复继承;模型指令与页面共用同一份设置。 (11097)
- 新增 Windows AppContainer 本机沙盒,支持工作区隔离、代码执行与联网控制。 (10466)
- 新增 Deep

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON