LIghtJUNction
14 KiB
AstrBot 是一個開源的一站式 Agentic 個人和群聊助手，可在 QQ、Telegram、企業微信、飛書、釘钉、Slack 等數十款主流即時通訊軟件上部署，此外還內置類似 OpenWebUI 的輕量化 ChatUI，為個人、開發者和團隊打造可靠、可擴展的對話式智能基礎設施。無論是個人 AI 夥伴、智能客服、自動化助手，還是企業知識庫，AstrBot 都能在你的即時通訊軟件平台的工作流中快速構建 AI 應用。
主要功能
- 💯 免費 & 開源。
- ✨ AI 大模型對話，多模態，Agent，MCP，Skills，知識庫，人格設定，自動壓縮對話。
- 🤖 支持接入 Dify、阿里雲百煉、Coze 等智能體平台。
- 🌐 多平台，支持 QQ、企業微信、飛書、釘釘、微信公眾號、Telegram、Slack 以及更多。
- 📦 插件擴展，已有 1000+ 個插件可一鍵安裝。
- 🛡️ Agent Sandbox 隔離化環境，安全地執行任何代碼、調用 Shell、會話級資源複用。
- 💻 WebUI 支持。
- 🌈 Web ChatUI 支持，ChatUI 內置代理沙盒、網頁搜索等。
- 🌐 國際化（i18n）支持。
| 💙 角色扮演 & 情感陪伴 | ✨ 主動式 Agent | 🚀 通用 Agentic 能力 | 🧩 1000+ 社區插件 |
|---|---|---|---|
快速開始
一鍵部署
對於想快速體驗 AstrBot、且熟悉命令行並能夠自行安裝 uv 環境的用戶，我們推薦使用 uv 一鍵部署方式 ⚡️。
uv tool install astrbot
astrbot init # 僅首次執行此命令以初始化環境
astrbot run # astrbot run --backend-only 僅啟動後端服務
# 安裝開發版本（更多修復，新功能，但不夠穩定，適合開發者）
uv tool install git+https://github.com/AstrBotDevs/AstrBot@dev
需要安裝 uv。
Note
對於 macOS 用戶：由於 macOS 安全檢查，首次運行
astrbot命令可能需要較長時間（約 10-20 秒）。
更新 astrbot：
uv tool upgrade astrbot
Docker 部署
對於熟悉容器、希望獲得更穩定且更適合生產環境部署方式的用戶，我們推薦使用 Docker / Docker Compose 部署 AstrBot。
請參考官方文檔 使用 Docker 部署 AstrBot。
在 雨雲 上部署
對於希望一鍵部署 AstrBot 且不想自行管理服務器的用戶，我們推薦使用雨雲的一鍵雲部署服務 ☁️：
桌面客戶端部署
對於希望在桌面端使用 AstrBot、並以 ChatUI 為主要入口的用戶，我們推薦使用 AstrBot App。
前往 AstrBot-desktop 下載並安裝；該方式面向桌面使用，不推薦服務器場景。
啟動器部署
同樣在桌面端，希望快速部署並實現環境隔離多開的用戶，我們推薦使用 AstrBot Launcher。
前往 AstrBot Launcher 下載並安裝。
在 Replit 上部署
Replit 部署由社區維護，適合在線演示和輕量試用場景。
AUR
AUR 方式面向 Arch Linux 用戶，適合希望通過系統包管理器安裝 AstrBot 的場景。
在終端執行下方命令安裝 astrbot-git 包，安裝完成後即可啟動使用。
yay -S astrbot-git
更多部署方式
若你需要面板化或更高自定義部署，可參考 寶塔面板（BT Panel 應用商店安裝）、1Panel（1Panel 應用商店安裝）、CasaOS（NAS / 家庭服務器可視化部署）和 手動部署（基於源碼與 uv 的完整自定義安裝）。
支持的消息平台
將 AstrBot 連接到你常用的聊天平台。
| 平台 | 維護方 |
|---|---|
| 官方維護 | |
| OneBot v11 | 官方維護 |
| Telegram | 官方維護 |
| 企微應用 & 企微智能機器人 | 官方維護 |
| 微信客服 & 微信公眾號 | 官方維護 |
| 飛書 | 官方維護 |
| 釘釘 | 官方維護 |
| Slack | 官方維護 |
| Discord | 官方維護 |
| LINE | 官方維護 |
| Satori | 官方維護 |
| Misskey | 官方維護 |
| Whatsapp (將支持) | 官方維護 |
| Matrix | 社區維護 |
| KOOK | 社區維護 |
| VoceChat | 社區維護 |
支持的模型提供商
| 提供商 | 類型 |
|---|---|
| 自定義 | 任何 OpenAI API 兼容的服務 |
| OpenAI | LLM |
| Anthropic | LLM |
| Google Gemini | LLM |
| Moonshot AI | LLM |
| 智譜 AI | LLM |
| DeepSeek | LLM |
| Ollama (本地部署) | LLM |
| LM Studio (本地部署) | LLM |
| AIHubMix | LLM (API 網關, 支持所有模型) |
| 優雲智算 | LLM (API 網關, 支持所有模型) |
| 硅基流動 | LLM (API 網關, 支持所有模型) |
| PPIO 派歐雲 | LLM (API 網關, 支持所有模型) |
| 302.AI | LLM (API 網關, 支持所有模型) |
| 小馬算力 | LLM (API 網關, 支持所有模型) |
| ModelScope | LLM |
| OneAPI | LLM |
| Dify | LLMOps 平台 |
| 阿里雲百煉應用 | LLMOps 平台 |
| Coze | LLMOps 平台 |
| 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 討論。 建議將功能性PR合併至dev分支，將在測試修改後合併到主分支並發布新版本。 為了減少衝突，建議如下：
- 工作分支最好基於
dev分支創建，避免直接在main分支上工作。 - 提交 PR 時，選擇
dev分支作為目標分支。 - 定期同步
dev分支到本地，多使用git pull。
開發環境
AstrBot 使用 ruff 進行代碼格式化和檢查。
git clone https://github.com/AstrBotDevs/AstrBot
git switch dev # 切換到開發分支
pip install pre-commit # 或者uv tool install pre-commit
pre-commit install
推薦使用uv本地安裝，進行測試
uv tool install -e . --force
astrbot init
astrbot run
調試前端
astrbot run --backend-only
cd dashboard
bun install # 或者pnpm 等
bun dev
QQ 群組
- 9 群: 1076659624 (新)
- 10 群: 1078079676 (新)
- 1 群：322154837
- 3 群：630166526
- 5 群：822130018
- 6 群：753075035
- 7 群：743746109
- 8 群：1030353265
- 開發者群（偏閒聊吹水）：975206796
- 開發者群（正式）：1039761811
Discord 頻道
❤️ Special Thanks
特別感謝所有 Contributors 和插件開發者對 AstrBot 的貢獻 ❤️
此外，本項目的誕生離不開以下開源項目的幫助：
- NapNeko/NapCatQQ - 偉大的貓貓框架
開源項目友情鏈接：
- NoneBot2 - 優秀的 Python 異步 ChatBot 框架
- Koishi - 優秀的 Node.js ChatBot 框架
- MaiBot - 優秀的擬人化 AI ChatBot
- nekro-agent - 優秀的 Agent ChatBot
- LangBot - 優秀的多平台 AI ChatBot
- ChatLuna - 優秀的多平台 AI ChatBot Koishi 插件
- Operit AI - 優秀的 AI 智能助手 Android APP
⭐ Star History
Tip
如果本項目對您的生活 / 工作產生了幫助，或者您關注本項目的未來發展，請給項目 Star，這是我們維護這個開源項目的動力 <3
陪伴與能力從來不應該是對立面。我們希望創造的是一個既能理解情緒、給予陪伴，也能可靠完成工作的機器人。
私は、高性能ですから!
