AstrBot 是一個開源的一站式 Agent 聊天機器人平台,可接入主流即時通訊軟體,為個人、開發者和團隊打造可靠、可擴展的對話式智慧基礎設施。無論是個人 AI 夥伴、智慧客服、自動化助手,還是企業知識庫,AstrBot 都能在您的即時通訊軟體平台的工作流程中快速構建生產可用的 AI 應用程式。
- 💯 免費 & 開源。
- ✨ AI 大模型對話,多模態,Agent,MCP,Skills,知識庫,人格設定,自動壓縮對話。
- 🤖 支援接入 Dify、阿里雲百煉、Coze 等智慧體 (Agent) 平台。
- 🌐 多平台,支援 QQ、企業微信、飛書、釘釘、微信公眾號、Telegram、Slack 以及更多。
- 📦 插件擴展,已有 1000+ 個插件可一鍵安裝。
- 🛡️ Agent Sandbox 隔離化環境,安全地執行任何代碼、調用 Shell、會話級資源複用。
- 💻 WebUI 支援。
- 🌈 Web ChatUI 支援,ChatUI 內置代理沙盒 (Agent Sandbox)、網頁搜尋等。
- 🌐 國際化(i18n)支援。
| 💙 角色扮演 & 情感陪伴 | ✨ 主動式 Agent | 🚀 通用 Agentic 能力 | 🧩 1000+ 社區外掛程式 |
|---|---|---|---|
對於想快速體驗 AstrBot、且熟悉命令列並能自行安裝 uv 環境的使用者,我們推薦使用 uv 一鍵部署方式 ⚡️。
uv tool install astrbot --python 3.12
astrbot init # 僅首次執行此命令以初始化環境
astrbot run需要安裝 uv。 AstrBot 需要 Python 3.12 或更高版本。
--python 3.12會確保uv使用 Python 3.12 建立 tool 環境。
Note
對於 macOS 使用者:由於 macOS 安全性檢查,首次執行 astrbot 指令可能需要較長時間(約 10-20 秒)。
更新 astrbot:
uv tool upgrade astrbot --python 3.12Warning
透過 uv 部署的 AstrBot 不支援在 WebUI 中進行版本升級。如需更新,請透過命令列執行上述命令。
對於熟悉容器、希望獲得更穩定且更適合正式環境部署方式的使用者,我們推薦使用 Docker / Docker Compose 部署 AstrBot。
請參考官方文件 使用 Docker 部署 AstrBot。
對於希望一鍵部署 AstrBot 且不想自行管理伺服器的使用者,我們推薦使用雨雲的一鍵雲端部署服務 ☁️:
對於希望在桌面端使用 AstrBot、並以 ChatUI 為主要入口的使用者,我們推薦使用 AstrBot App。
前往 AstrBot-desktop 下載並安裝;此方式面向桌面使用,不建議伺服器場景。
同樣在桌面端,對於希望快速部署並實現環境隔離多開的使用者,我們推薦使用 AstrBot Launcher。
前往 AstrBot Launcher 下載並安裝。
Replit 部署由社群維護,適合線上示範與輕量試用情境。
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 | 官方維護 |
| KOOK | 官方維護 |
| Misskey | 官方維護 |
| Mattermost | 官方維護 |
| WhatsApp(即將支援) | 官方維護 |
| Matrix | 社群維護 |
| Rocket.Chat | 社群維護 |
| VoceChat | 社群維護 |
| 服務 | 類型 |
|---|---|
| OpenAI 及相容服務 | 大型模型服務 |
| Anthropic | 大型模型服務 |
| Google Gemini | 大型模型服務 |
| Moonshot AI | 大型模型服務 |
| 智譜 AI | 大型模型服務 |
| DeepSeek | 大型模型服務 |
| Ollama(本機部署) | 大型模型服務 |
| LM Studio(本機部署) | 大型模型服務 |
| AIHubMix | 大型模型服務(API 閘道,支援所有模型) |
| 優雲智算 | 大型模型服務 |
| 302.AI | 大型模型服務 |
| 小馬算力 | 大型模型服務 |
| 矽基流動 | 大型模型服務 |
| PPIO 派歐雲 | 大型模型服務 |
| ModelScope | 大型模型服務 |
| OneAPI | 大型模型服務 |
| 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 進行程式碼格式化和檢查。
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install- 12 群:916228568 (新)
- 9 群:1076659624 (人滿)
- 10 群:1078079676 (人滿)
- 11 群:704659519 (人滿)
- 1 群:322154837 (人滿)
- 3 群:630166526 (人滿)
- 4 群:1077826412 (人滿)
- 5 群:822130018 (人滿)
- 6 群:753075035 (人滿)
- 7 群:743746109 (人滿)
- 8 群:1030353265 (人滿)
- 開發者群(闲聊吹水):975206796
- 開發者群(正式):1039761811
特別感謝所有 Contributors 和外掛開發者對 AstrBot 的貢獻 ❤️
此外,本專案的誕生離不開以下開源專案的幫助:
- NapNeko/NapCatQQ - 偉大的貓貓框架
Tip
如果本專案對您的生活 / 工作產生了幫助,或者您關注本專案的未來發展,請給專案 Star,這是我們維護這個開源專案的動力 <3





