English ｜ 日本語 ｜ 繁體中文 ｜ Français ｜ Русский

文档 ｜ Blog ｜ 路线图 ｜ 问题提交

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

主要功能

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

快速开始

快速开始

选择最适合您需求的部署方式：

🚀 初学者推荐（简单快捷）

Docker 部署（最推荐）

使用 Docker / Docker Compose 是部署 AstrBot 最简单的方式。

# 1. 下载 docker-compose.yml 文件
wget https://raw.githubusercontent.com/AstrBotDevs/AstrBot/main/docker/docker-compose.yml

# 2. 启动服务
docker-compose up -d

# 3. 访问 WebUI
# 默认地址: http://localhost:8000

宝塔面板部署

AstrBot 与宝塔面板合作，已上架至宝塔面板应用商店。

1. 登录宝塔面板
2. 进入【软件商店】
3. 搜索"AstrBot"
4. 点击【一键部署】

1Panel 部署

AstrBot 已由 1Panel 官方上架至 1Panel 应用商店。

1. 登录 1Panel 控制台
2. 进入【应用商店】
3. 搜索"AstrBot"
4. 点击【安装】

🔧 进阶部署方式

uv 部署（Python 用户）

如果您熟悉 Python 环境，可以使用 uv 部署：

# 安装并启动 AstrBot
uvx astrbot

☁️ 云平台部署

在 雨云 上部署

AstrBot 已由雨云官方上架至云应用平台，可一键部署。 点击这里在雨云上部署

💻 特殊平台部署

Windows 一键安装器

适合 Windows 用户的图形化安装方式。 下载 Windows 一键安装器

CasaOS 部署

适合 CasaOS 用户的部署方式。 在 CasaOS 上部署 AstrBot

📋 部署方式对比

部署方式	优点	缺点	适用场景
Docker	环境隔离、部署简单	需要学习 Docker	生产环境推荐
宝塔面板	图形界面、操作简单	仅限 Linux 服务器	服务器运维
1Panel	现代化界面、功能丰富	较新项目	现代化运维
uv	轻量级、Python 原生	依赖 Python 环境	本地开发

🛠️ 常见问题

Q: Docker 部署后无法访问 WebUI？ A: 检查防火墙设置，确保 8000 端口已开放。

Q: 如何修改默认端口？ A: 在 docker-compose.yml 中修改端口映射配置。

Q: 部署后如何更新版本？ A: Docker 用户重新拉取镜像即可，面板用户可通过面板一键更新。

支持的消息平台

官方维护

• QQ (官方平台 & OneBot)
• Telegram
• 企微应用 & 企微智能机器人
• 微信客服 & 微信公众号
• 飞书
• 钉钉
• Slack
• Discord
• Satori
• Misskey
• Whatsapp (将支持)
• LINE (将支持)

社区维护

• Matrix
• KOOK
• VoceChat

支持的模型服务

大模型服务

• OpenAI 及兼容服务
• Anthropic
• Google Gemini
• Moonshot AI
• 智谱 AI
• DeepSeek
• Ollama (本地部署)
• LM Studio (本地部署)
• 优云智算
• 302.AI
• 小马算力
• 硅基流动
• PPIO 派欧云
• ModelScope
• OneAPI

LLMOps 平台

• Dify
• 阿里云百炼应用
• Coze

语音转文本服务

• OpenAI Whisper
• SenseVoice

文本转语音服务

• OpenAI TTS
• Gemini TTS
• GPT-Sovits-Inference
• GPT-Sovits
• FishAudio
• Edge TTS
• 阿里云百炼 TTS
• Azure TTS
• Minimax TTS
• 火山引擎 TTS

❤️ 贡献

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

如何贡献

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

开发环境

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

git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install

🌍 社区

QQ 群组

• 1 群：322154837
• 3 群：630166526
• 5 群：822130018
• 6 群：753075035
• 7 群：743746109
• 8 群：1030353265
• 开发者群：975206796

Telegram 群组

Discord 群组

❤️ Special Thanks

特别感谢所有 Contributors 和插件开发者对 AstrBot 的贡献 ❤️

此外，本项目的诞生离不开以下开源项目的帮助：

• NapNeko/NapCatQQ - 伟大的猫猫框架

⭐ Star History

Tip

如果本项目对您的生活 / 工作产生了帮助，或者您关注本项目的未来发展，请给项目 Star，这是我们维护这个开源项目的动力 <3

私は、高性能ですから!