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
下载:v4.30.0-alpha.1v4.30.0-alpha.1 ↓12026-11-15
+76
日增长
+495
周增长
46,987
stars
3,583
forks
98
watchers
3,688
prs
6,826
issues
263
releases

README

!AstrBot-Logo-Simplified



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






















文档 |
博客 |
路线图 |
问题提交 |
Email



AstrBot 是一个开源的一站式 Agent 聊天机器人平台,可接入主流即时通讯应用,为个人、开发者和团队提供可靠、可扩展的对话式 AI 基础设施。无论你要构建个人 AI 伙伴、智能客服、自动化助手还是企业知识库,AstrBot 都能帮助你在即时通讯平台的工作流中快速构建可用于生产环境的 AI 应用。

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

 主要功能

1. 💯 免费 & 开源。
2. ✨ AI 大模型对话,多模态,Agent,MCP,Skills,知识库,人格设定,自动压缩对话。
3. 🤖 支持接入 Dify、阿里云百炼、Coze 等智能体平台。
4. 🌐 多平台,支持 QQ、企业微信、飞书、钉钉、微信公众号、Telegram、Slack 以及更多。
5. 📦 插件扩展,已有 1000+ 个插件可一键安装。
6. 🛡️ Agent Sandbox 隔离化环境,安全地执行任何代码、调用 Shell、会话级资源复用。
7. 💻 WebUI 支持。
8. 🌈 Web ChatUI 支持,ChatUI 内置代理沙盒、网页搜索等。
9. 🌐 国际化(i18n)支持。

 快速开始

 在雨云上一键部署

对于希望一键部署并让 AstrBot 24 小时在线、且不想自行管理服务器的用户,我们推荐使用雨云的一键云部署服务 ☁️:



 一键部署

 [!NOTE]
 需要安装 uv。
 对于 macOS 用户:由于 macOS 安全检查,首次运行 astrbot 命令可能需要较长时间(约 10-20 秒)。

对于想快速体验 AstrBot、且熟悉命令行并能够自行安装 uv 环境的用户,我们推荐使用 uv 一键部署方式 ⚡️。

bash
uv tool install astrbot --python 3.12
astrbot init  仅首次执行此命令以初始化环境
astrbot run


后续更新 astrbot:

bash
uv tool upgrade astrbot --python 3.12


 Docker 部署

对于熟悉容器、希望获得更稳定且更适合生产环境部署方式的用户,我们推荐使用 Docker / Docker Compose 部署 AstrBot。

请参考官方文档 使用 Docker 部署 AstrBot。

 桌面客户端部署

对于希望在桌面端使用 AstrBot、并以 ChatUI 为主要入口的用户,我们推荐使用 AstrBot App。

前往 AstrBot-desktop 下载并安装;该方式面向桌面使用,不推荐服务器场景。

 启动器部署

同样在桌面端,希望快速部署并实现环境隔离多开的用户,我们推荐使用 AstrBot Launcher。

前往 AstrBot Launcher 下载并安装。

更多部署方式

若你需要面板化或更高自定义部署,可参考 宝塔面板、1Panel、CasaOS 和 源码部署。

 ❤️ 赞助商

欢迎通过 Afdian 或者通过邮件 赞助我们。


  
    
  



 支持的消息平台

将 AstrBot 连接到你常用的聊天平台。

| 平台 | 维护方 |
|---------|---------------|
| QQ | 官方维护 |
| OneBot v11 | 官方维护 |
| Telegram | 官方维护 |
| 企微应用 & 企微智能机器人 | 官方维护 |
| 微信公众号 | 官方维护 |
| 飞书 | 官方维护 |
| 钉钉 | 官方维护 |
| Slack | 官方维护 |
| Discord | 官方维护 |
| LINE | 官方维护 |
| Satori | 官方维护 |
| KOOK | 官方维护 |
| Misskey | 官方维护 |
| Mattermost | 官方维护 |
| WhatsApp(将支持) | 官方维护 |
| Matrix | 社区维护 |
| Rocket.Chat | 社区维护 |
| VoceChat | 社区维护 |

 支持的模型提供商

| 提供商 | 类型 |
|---------|---------------|
| OpenAI 及兼容服务 | LLM |
| Anthropic | LLM |
| Google Gemini | LLM |
| Moonshot AI | LLM |
| 智谱 AI | LLM |
| DeepSeek | LLM |
| Ollama (本地部署) | LLM |
| LM Studio (本地部署) | LLM |
| MiraRouter | LLM (API 网关, 支持所有模型) |
| 胜算云 | LLM |
| AIHubMix | LLM (API 网关, 支持所有模型) |
| 优云智算 | LLM (API 网关, 支持所有模型) |
| 302.AI | LLM (API 网关, 支持所有模型)|
| 小马算力 | LLM (API 网关, 支持所有模型)|
| 硅基流动 | LLM (API 网关, 支持所有模型)  |
| PPIO 派欧云 | LLM (API 网关, 支持所有模型) |
| ModelScope | LLM |
| OneAPI | LLM |
| Dify | LLMOps 平台 |
| 阿里云百炼应用 | LLMOps 平台 |
| Coze | LLMOps 平台 |
| OpenAI Whisper | 语音转文本 |
| SenseVoice | 语音转文本 |
| Xiaomi MiMo Omni | 语音转文本 |
| DeepSeek STT | 语音转文本 |
| OpenAI TTS | 文本转语音 |
| DeepSeek TTS | 文本转语音 |
| Gemini TTS | 文本转语音 |
| GPT-Sovits-Inference | 文本转语音 |
| GPT-Sovits | 文本转语音 |
| FishAudio | 文本转语音 |
| Edge TTS | 文本转语音 |
| 阿里云百炼 TTS | 文本转语音 |
| Azure TTS | 文本转语音 |
| Minimax TTS | 文本转语音 |
| Xiaomi MiMo TTS | 文本转语音 |
| 火山引擎 TTS | 文本转语音 |

 ❤️ 贡献

欢迎任何 Issues/Pull Requests!只需要将你的更改提交到此项目 :)

 如何贡献

你可以通过查看问题或帮助审核 PR(拉取请求)来贡献。任何问题或 PR 都欢迎参与,以促进社区贡献。当然,这些只是建议,你可以以任何方式进行贡献。对于新功能的添加,请先通过 Is

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