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 | 语音转文本 |
| OpenAI 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 都欢迎参与，以促进社区贡献。当然，这些只是建议，你可以以任何方式进行贡献。对于新功能的添加，请先通过 Issue 讨论。

 开发环境

AstrBot 使用 ruff 进行代码格式化和检查。

bash

Top issues

Discussions

Latest release

[4.29.4] - 2026-10-31

 新增

- 消息按钮：新增跨平台按钮组件，支持链接、消息发送和插件回调，并提供交互超时提示。各平台支持的按钮类型以文档为准。 (9809)
- 决策模型：新增独立于聊天模型的 Decision Provider 和 System One 适配器，供插件调用结构化选择、布尔判断和评分。 (10775)
- 网络搜索：接入 SerpApi Google News，支持新闻来源、作者、发布时间和 WebUI 引用展示。 (10773)
- 会话与用户选择：统一会话来源选择弹窗，支持昵称搜索、平台标识、分页及 ID 复制；记录发送者信息并补全飞书、QQ 官方群名称。管理员配置入口由“添加更多 → 编辑列表项”改为“选择用户”；原会话下拉框和列表编辑入口统一为“选择会话来源”，“已知会话”改为“已记录的会话来源”。 (10747)
- 机器人管理：删除机器人时可选择清理配置、定时任务、会话、消息记录、追踪和用量数据；默认保留对话与历史数据。 (10761)
- 定时任务：支持查看群内共享任务列表，并允许管理员删除群任务。 (10785)
- 网络设置：新增 PyPI 镜像选择器与测速功能。 (10657)

 优化与修复

- 稳定性：修复日志输出受阻时 WebUI 和 WebChat 可能无响应的问题，并在诊断包中